CPP Writing Guidelines

Our general rules:

Headers

• Put as many #includes as possible in the .cpp file and as little as possible in the .hpp file. The includes in the .cpp are only included when that one file is compiled, but the includes for the .hpp have to be included by every file that uses it.
  Via https://stackoverflow.com/questions/3002110/include-in-h-or-c-cpp.
• Header include order:
  1. Header file corresponding to the .cpp file (if applicable).
  2. Header files from the same component.
  3. Header files from other components.
  4. System headers.
     Via https://stackoverflow.com/questions/2762568/c-c-include-header-file-order.

Naming Conventions

• All C++ variables are named with lower case, and underscores between words (e.g., variable_name)
• For private member variables, add an extra underscore at the end of the variable (e.g., private_variable_name_)
• We generally like to access member variables using functions (e.g., GetVariableA(){return A_}). However, you may want to be able to access the member variables for your specific application. For example, point clouds may contain many variables that you often need to access, so in this case you can use public member variables (similar to PCL). For public member variables, do not use an underscore at the end of the variable
• Functions should be named using uppercase letters for each word (e.g., PerformAction())

More Information

If we don't have our own rule, try to stick to the google C++ guide which can be found here:

• https://google.github.io/styleguide/cppguide.html