diff --git a/CppCoreGuidelines.md b/CppCoreGuidelines.md index fb94419..4050adf 100644 --- a/CppCoreGuidelines.md +++ b/CppCoreGuidelines.md @@ -1953,9 +1953,10 @@ such as passing a `const int&`, returning an `array` by value, and retur * Identify an array with a length specified separately * Identify a location in an array -Confusion about what meaning a `T*` is the source of many serious errors, so using separate names for pointers of these separate uses makes code clearer. -For debugging, `owner` and `not_null` can be instrumented to check. +Using separate names for each of these uses improves code quality because confusion about the meaning of any particular `T*` is the source of many serious errors. For example, `not_null` makes it obvious to a reader (human or machine) that a test for `nullptr` is not necessary before dereference. +Additionally, when debugging, `owner` and `not_null` can be instrumented to check for correctness. + **Example**: Consider