Cpp Coding Standards/GEN

From Apache OpenOffice Wiki
< Cpp Coding Standards
Revision as of 22:22, 29 November 2006 by Np (Talk | contribs)

Jump to: navigation, search

Topic-Id: GEN

General advice for coding.


Summary

Const Correctness (Const)

Make every member function const that does not change the logical state of its class. Use “mutable” to distinguish logical from physical state.

Prefer constants over variables wherever possible.

Details

Resource Allocation is Initialization (RAII)

Use the “Resource allocation is initialization” (RAII) idiom to manage resources.

Use smart pointers for objects on the heap.

Details

Avoid Duplicate Code (Dupli)

Avoid and remove dupliate code. Duplicate code may be okay, if otherwise dependencies among so far unrelated modules would be created. Among constructors of the same class some code duplication is okay.

Details

Initialize Everything Immediately (Init)

Initialize all variables at declaration.

Every struct needs a constructor.

Preferably mention every data member, including the default constructed ones, in the constructor's initialization section.

Details

Optimize Later (Opti)

Do not optimize before you really know there is a performance problem. Use inline sparingly. However do optimize in algorithm complexity.

Details

Clear Origin of Local Data (LocalData)

Use a consistent way to distinguish member data, local variables and function parameters.

Details

Local Conventions (LocalConv)

When changing code in a module, follow local naming conventions.

Details

Matching Array Delete (ArrayDel)

When using new[], employ a matching delete[] statement.

Details


Related Rules


Personal tools