Use a consistent naming style

Rationale: Consistency in naming and naming style increases readability.

Note

There are many styles and when you use multiple libraries, you can't follow all their different conventions. Choose a "house style", but leave "imported" libraries with their original style.

Example

ISO Standard, use lower case only and digits, separate words with underscores:

• int
• vector
• my_map

Avoid identifier names that contain double underscores __ or that start with an underscore followed by a capital letter (e.g., _Throws). Such identifiers are reserved for the C++ implementation.

Example

Stroustrup: ISO Standard, but with upper case used for your own types and concepts:

• int
• vector
• My_map

Example

CamelCase: capitalize each word in a multi-word identifier:

• int
• vector
• MyMap
• myMap

Some conventions capitalize the first letter, some don't.

Note

Try to be consistent in your use of acronyms and lengths of identifiers:

int mtbf {12};
int mean_time_between_failures {12}; // make up your mind

Enforcement

Would be possible except for the use of libraries with varying conventions.