Naming Convention

The neoGFX naming convention is based on the idea that to aid readability of C++ code it is better to encode scope rather than type in an identifier name prefix. The idea of encoding scope in identifier names was introduced by the smartphone operating system Symbian OS.

The following table lists the various C++ syntactical constructs with their associated convention:

neoGFX Naming Convention

Construct	Convention	Example	Note
macro	UPPER_SNAKE_CASE	FOO_BAR	snake_case is used for in-class event definition macros
function name	snake_case	foo_bar
struct/class name	snake_case	foo_bar
interface class name	snake_case; i_ prefix	i_foo_bar	an interface class does not have any member variables, containing only pure virtual functions and any associated helper functions
enum class name	snake_case	foo_bar
enum name	snake_case; _e suffix	foo_bar_e	C-style enums
enumerator	UpperCamelCase	FooBar
function parameter	CamelCase; a prefix	aFooBar	"a" for argument
local variable	lowerCamelCase	fooBar
member variable (class)	CamelCase; i prefix	iFooBar	"i" for class instance variable
member variable (struct)	lowerCamelCase	fooBar	use struct for classes that don't have a class invariant
variable with static storage duration	CamelCase; s prefix	sFooBar
variable with thread local storage duration	CamelCase; t prefix	tFooBar
event object	UpperCamelCase	FooBar
event (virtual) getter function	snake_case	foo_bar

Example class:

class foo
{
public:
   foo(int aValue) : iValue{ aValue }
   {
   }
public:
   int value() const
   {
       return iValue;
   }
   void something()
   {
       thread_local qux tQux;
       /* ... code ... */
   }
private:
   int iValue;
};