Index: clang-tools-extra/trunk/docs/clang-tidy/checks/readability-identifier-naming.rst =================================================================== --- clang-tools-extra/trunk/docs/clang-tidy/checks/readability-identifier-naming.rst +++ clang-tools-extra/trunk/docs/clang-tidy/checks/readability-identifier-naming.rst @@ -5,14 +5,1919 @@ Checks for identifiers naming style mismatch. -This check will try to enforce coding guidelines on the identifiers naming. -It supports `lower_case`, `UPPER_CASE`, `camelBack` and `CamelCase` casing and -tries to convert from one to another if a mismatch is detected. +This check will try to enforce coding guidelines on the identifiers naming. It +supports one of the following casing types and tries to convert from one to +another if a mismatch is detected -It also supports a fixed prefix and suffix that will be prepended or -appended to the identifiers, regardless of the casing. +Casing types inclde: + + - ``lower_case``, + - ``UPPER_CASE``, + - ``camelBack``, + - ``CamelCase``, + - ``camel_Snake_Back``, + - ``Camel_Snake_Case``, + - ``aNy_CasE``. + +It also supports a fixed prefix and suffix that will be prepended or appended +to the identifiers, regardless of the casing. Many configuration options are available, in order to be able to create -different rules for different kind of identifier. In general, the -rules are falling back to a more generic rule if the specific case is not -configured. +different rules for different kinds of identifiers. In general, the rules are +falling back to a more generic rule if the specific case is not configured. + +Options +------- + +The following options are describe below: + + - :option:`AbstractClassCase`, :option:`AbstractClassPrefix`, :option:`AbstractClassSuffix` + - :option:`ClassCase`, :option:`ClassPrefix`, :option:`ClassSuffix` + - :option:`ClassConstantCase`, :option:`ClassConstantPrefix`, :option:`ClassConstantSuffix` + - :option:`ClassMemberCase`, :option:`ClassMemberPrefix`, :option:`ClassMemberSuffix` + - :option:`ClassMethodCase`, :option:`ClassMethodPrefix`, :option:`ClassMethodSuffix` + - :option:`ConstantCase`, :option:`ConstantPrefix`, :option:`ConstantSuffix` + - :option:`ConstantMemberCase`, :option:`ConstantMemberPrefix`, :option:`ConstantMemberSuffix` + - :option:`ConstantParameterCase`, :option:`ConstantParameterPrefix`, :option:`ConstantParameterSuffix` + - :option:`ConstantPointerParameterCase`, :option:`ConstantPointerParameterPrefix`, :option:`ConstantPointerParameterSuffix` + - :option:`ConstexprFunctionCase`, :option:`ConstexprFunctionPrefix`, :option:`ConstexprFunctionSuffix` + - :option:`ConstexprMethodCase`, :option:`ConstexprMethodPrefix`, :option:`ConstexprMethodSuffix` + - :option:`ConstexprVariableCase`, :option:`ConstexprVariablePrefix`, :option:`ConstexprVariableSuffix` + - :option:`EnumCase`, :option:`EnumPrefix`, :option:`EnumSuffix` + - :option:`EnumConstantCase`, :option:`EnumConstantPrefix`, :option:`EnumConstantSuffix` + - :option:`FunctionCase`, :option:`FunctionPrefix`, :option:`FunctionSuffix` + - :option:`GlobalConstantCase`, :option:`GlobalConstantPrefix`, :option:`GlobalConstantSuffix` + - :option:`GlobalConstantPointerCase`, :option:`GlobalConstantPointerPrefix`, :option:`GlobalConstantPointerSuffix` + - :option:`GlobalFunctionCase`, :option:`GlobalFunctionPrefix`, :option:`GlobalFunctionSuffix` + - :option:`GlobalPointerCase`, :option:`GlobalPointerPrefix`, :option:`GlobalPointerSuffix` + - :option:`GlobalVariableCase`, :option:`GlobalVariablePrefix`, :option:`GlobalVariableSuffix` + - :option:`InlineNamespaceCase`, :option:`InlineNamespacePrefix`, :option:`InlineNamespaceSuffix` + - :option:`LocalConstantCase`, :option:`LocalConstantPrefix`, :option:`LocalConstantSuffix` + - :option:`LocalConstantPointerCase`, :option:`LocalConstantPointerPrefix`, :option:`LocalConstantPointerSuffix` + - :option:`LocalPointerCase`, :option:`LocalPointerPrefix`, :option:`LocalPointerSuffix` + - :option:`LocalVariableCase`, :option:`LocalVariablePrefix`, :option:`LocalVariableSuffix` + - :option:`MemberCase`, :option:`MemberPrefix`, :option:`MemberSuffix` + - :option:`MethodCase`, :option:`MethodPrefix`, :option:`MethodSuffix` + - :option:`NamespaceCase`, :option:`NamespacePrefix`, :option:`NamespaceSuffix` + - :option:`ParameterCase`, :option:`ParameterPrefix`, :option:`ParameterSuffix` + - :option:`ParameterPackCase`, :option:`ParameterPackPrefix`, :option:`ParameterPackSuffix` + - :option:`PointerParameterCase`, :option:`PointerParameterPrefix`, :option:`PointerParameterSuffix` + - :option:`PrivateMemberCase`, :option:`PrivateMemberPrefix`, :option:`PrivateMemberSuffix` + - :option:`PrivateMethodCase`, :option:`PrivateMethodPrefix`, :option:`PrivateMethodSuffix` + - :option:`ProtectedMemberCase`, :option:`ProtectedMemberPrefix`, :option:`ProtectedMemberSuffix` + - :option:`ProtectedMethodCase`, :option:`ProtectedMethodPrefix`, :option:`ProtectedMethodSuffix` + - :option:`PublicMemberCase`, :option:`PublicMemberPrefix`, :option:`PublicMemberSuffix` + - :option:`PublicMethodCase`, :option:`PublicMethodPrefix`, :option:`PublicMethodSuffix` + - :option:`StaticConstantCase`, :option:`StaticConstantPrefix`, :option:`StaticConstantSuffix` + - :option:`StaticVariableCase`, :option:`StaticVariablePrefix`, :option:`StaticVariableSuffix` + - :option:`StructCase`, :option:`StructPrefix`, :option:`StructSuffix` + - :option:`TemplateParameterCase`, :option:`TemplateParameterPrefix`, :option:`TemplateParameterSuffix` + - :option:`TemplateTemplateParameterCase`, :option:`TemplateTemplateParameterPrefix`, :option:`TemplateTemplateParameterSuffix` + - :option:`TypeAliasCase`, :option:`TypeAliasPrefix`, :option:`TypeAliasSuffix` + - :option:`TypedefCase`, :option:`TypedefPrefix`, :option:`TypedefSuffix` + - :option:`TypeTemplateParameterCase`, :option:`TypeTemplateParameterPrefix`, :option:`TypeTemplateParameterSuffix` + - :option:`UnionCase`, :option:`UnionPrefix`, :option:`UnionSuffix` + - :option:`ValueTemplateParameterCase`, :option:`ValueTemplateParameterPrefix`, :option:`ValueTemplateParameterSuffix` + - :option:`VariableCase`, :option:`VariablePrefix`, :option:`VariableSuffix` + - :option:`VirtualMethodCase`, :option:`VirtualMethodPrefix`, :option:`VirtualMethodSuffix` + +.. option:: AbstractClassCase + + When defined, the check will ensure abstract class names conform to the + selected casing. + +.. option:: AbstractClassPrefix + + When defined, the check will ensure abstract class names will add the + prefixed with the given value (regardless of casing). + +.. option:: AbstractClassSuffix + + When defined, the check will ensure abstract class names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - AbstractClassCase of ``lower_case`` + - AbstractClassPrefix of ``pre_`` + - AbstractClassSuffix of ``_post`` + +Identifies and/or transforms abstract class names as follows: + +Before: + +.. code-block:: c++ + + class ABSTRACT_CLASS { + public: + ABSTRACT_CLASS(); + }; + +After: + +.. code-block:: c++ + + class pre_abstract_class_post { + public: + pre_abstract_class_post(); + }; + +.. option:: ClassCase + + When defined, the check will ensure class names conform to the + selected casing. + +.. option:: ClassPrefix + + When defined, the check will ensure class names will add the + prefixed with the given value (regardless of casing). + +.. option:: ClassSuffix + + When defined, the check will ensure class names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ClassCase of ``lower_case`` + - ClassPrefix of ``pre_`` + - ClassSuffix of ``_post`` + +Identifies and/or transforms class names as follows: + +Before: + +.. code-block:: c++ + + class FOO { + public: + FOO(); + ~FOO(); + }; + +After: + +.. code-block:: c++ + + class pre_foo_post { + public: + pre_foo_post(); + ~pre_foo_post(); + }; + +.. option:: ClassConstantCase + + When defined, the check will ensure class constant names conform to the + selected casing. + +.. option:: ClassConstantPrefix + + When defined, the check will ensure class constant names will add the + prefixed with the given value (regardless of casing). + +.. option:: ClassConstantSuffix + + When defined, the check will ensure class constant names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ClassConstantCase of ``lower_case`` + - ClassConstantPrefix of ``pre_`` + - ClassConstantSuffix of ``_post`` + +Identifies and/or transforms class constant names as follows: + +Before: + +.. code-block:: c++ + + class FOO { + public: + static const int CLASS_CONSTANT; + }; + +After: + +.. code-block:: c++ + + class FOO { + public: + static const int pre_class_constant_post; + }; + +.. option:: ClassMemberCase + + When defined, the check will ensure class member names conform to the + selected casing. + +.. option:: ClassMemberPrefix + + When defined, the check will ensure class member names will add the + prefixed with the given value (regardless of casing). + +.. option:: ClassMemberSuffix + + When defined, the check will ensure class member names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ClassMemberCase of ``lower_case`` + - ClassMemberPrefix of ``pre_`` + - ClassMemberSuffix of ``_post`` + +Identifies and/or transforms class member names as follows: + +Before: + +.. code-block:: c++ + + class FOO { + public: + static int CLASS_CONSTANT; + }; + +After: + +.. code-block:: c++ + + class FOO { + public: + static int pre_class_constant_post; + }; + +.. option:: ClassMethodCase + + When defined, the check will ensure class method names conform to the + selected casing. + +.. option:: ClassMethodPrefix + + When defined, the check will ensure class method names will add the + prefixed with the given value (regardless of casing). + +.. option:: ClassMethodSuffix + + When defined, the check will ensure class method names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ClassMethodCase of ``lower_case`` + - ClassMethodPrefix of ``pre_`` + - ClassMethodSuffix of ``_post`` + +Identifies and/or transforms class method names as follows: + +Before: + +.. code-block:: c++ + + class FOO { + public: + int CLASS_MEMBER(); + }; + +After: + +.. code-block:: c++ + + class FOO { + public: + int pre_class_member_post(); + }; + +.. option:: ConstantCase + + When defined, the check will ensure constant names conform to the + selected casing. + +.. option:: ConstantPrefix + + When defined, the check will ensure constant names will add the + prefixed with the given value (regardless of casing). + +.. option:: ConstantSuffix + + When defined, the check will ensure constant names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ConstantCase of ``lower_case`` + - ConstantPrefix of ``pre_`` + - ConstantSuffix of ``_post`` + +Identifies and/or transforms constant names as follows: + +Before: + +.. code-block:: c++ + + void function() { unsigned const MyConst_array[] = {1, 2, 3}; } + +After: + +.. code-block:: c++ + + void function() { unsigned const pre_myconst_array_post[] = {1, 2, 3}; } + +.. option:: ConstantMemberCase + + When defined, the check will ensure constant member names conform to the + selected casing. + +.. option:: ConstantMemberPrefix + + When defined, the check will ensure constant member names will add the + prefixed with the given value (regardless of casing). + +.. option:: ConstantMemberSuffix + + When defined, the check will ensure constant member names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ConstantMemberCase of ``lower_case`` + - ConstantMemberPrefix of ``pre_`` + - ConstantMemberSuffix of ``_post`` + +Identifies and/or transforms constant member names as follows: + +Before: + +.. code-block:: c++ + + class Foo { + char const MY_ConstMember_string[4] = "123"; + } + +After: + +.. code-block:: c++ + + class Foo { + char const pre_my_constmember_string_post[4] = "123"; + } + +.. option:: ConstantParameterCase + + When defined, the check will ensure constant parameter names conform to the + selected casing. + +.. option:: ConstantParameterPrefix + + When defined, the check will ensure constant parameter names will add the + prefixed with the given value (regardless of casing). + +.. option:: ConstantParameterSuffix + + When defined, the check will ensure constant parameter names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ConstantParameterCase of ``lower_case`` + - ConstantParameterPrefix of ``pre_`` + - ConstantParameterSuffix of ``_post`` + +Identifies and/or transforms constant parameter names as follows: + +Before: + +.. code-block:: c++ + + void GLOBAL_FUNCTION(int PARAMETER_1, int const CONST_parameter); + +After: + +.. code-block:: c++ + + void GLOBAL_FUNCTION(int PARAMETER_1, int const pre_const_parameter_post); + +.. option:: ConstantPointerParameterCase + + When defined, the check will ensure constant pointer parameter names conform to the + selected casing. + +.. option:: ConstantPointerParameterPrefix + + When defined, the check will ensure constant pointer parameter names will add the + prefixed with the given value (regardless of casing). + +.. option:: ConstantPointerParameterSuffix + + When defined, the check will ensure constant pointer parameter names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ConstantPointerParameterCase of ``lower_case`` + - ConstantPointerParameterPrefix of ``pre_`` + - ConstantPointerParameterSuffix of ``_post`` + +Identifies and/or transforms constant pointer parameter names as follows: + +Before: + +.. code-block:: c++ + + void GLOBAL_FUNCTION(int const *CONST_parameter); + +After: + +.. code-block:: c++ + + void GLOBAL_FUNCTION(int const *pre_const_parameter_post); + +.. option:: ConstexprFunctionCase + + When defined, the check will ensure constexpr function names conform to the + selected casing. + +.. option:: ConstexprFunctionPrefix + + When defined, the check will ensure constexpr function names will add the + prefixed with the given value (regardless of casing). + +.. option:: ConstexprFunctionSuffix + + When defined, the check will ensure constexpr function names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ConstexprFunctionCase of ``lower_case`` + - ConstexprFunctionPrefix of ``pre_`` + - ConstexprFunctionSuffix of ``_post`` + +Identifies and/or transforms constexpr function names as follows: + +Before: + +.. code-block:: c++ + + constexpr int CE_function() { return 3; } + +After: + +.. code-block:: c++ + + constexpr int pre_ce_function_post() { return 3; } + +.. option:: ConstexprMethodCase + + When defined, the check will ensure constexpr method names conform to the + selected casing. + +.. option:: ConstexprMethodPrefix + + When defined, the check will ensure constexpr method names will add the + prefixed with the given value (regardless of casing). + +.. option:: ConstexprMethodSuffix + + When defined, the check will ensure constexpr method names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ConstexprMethodCase of ``lower_case`` + - ConstexprMethodPrefix of ``pre_`` + - ConstexprMethodSuffix of ``_post`` + +Identifies and/or transforms constexpr method names as follows: + +Before: + +.. code-block:: c++ + + class Foo { + public: + constexpr int CST_expr_Method() { return 2; } + } + +After: + +.. code-block:: c++ + + class Foo { + public: + constexpr int pre_cst_expr_method_post() { return 2; } + } + +.. option:: ConstexprVariableCase + + When defined, the check will ensure constexpr variable names conform to the + selected casing. + +.. option:: ConstexprVariablePrefix + + When defined, the check will ensure constexpr variable names will add the + prefixed with the given value (regardless of casing). + +.. option:: ConstexprVariableSuffix + + When defined, the check will ensure constexpr variable names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ConstexprVariableCase of ``lower_case`` + - ConstexprVariablePrefix of ``pre_`` + - ConstexprVariableSuffix of ``_post`` + +Identifies and/or transforms constexpr variable names as follows: + +Before: + +.. code-block:: c++ + + constexpr int ConstExpr_variable = MyConstant; + +After: + +.. code-block:: c++ + + constexpr int pre_constexpr_variable_post = MyConstant; + +.. option:: EnumCase + + When defined, the check will ensure enumeration names conform to the + selected casing. + +.. option:: EnumPrefix + + When defined, the check will ensure enumeration names will add the + prefixed with the given value (regardless of casing). + +.. option:: EnumSuffix + + When defined, the check will ensure enumeration names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - EnumCase of ``lower_case`` + - EnumPrefix of ``pre_`` + - EnumSuffix of ``_post`` + +Identifies and/or transforms enumeration names as follows: + +Before: + +.. code-block:: c++ + + enum FOO { One, Two, Three }; + +After: + +.. code-block:: c++ + + enum pre_foo_post { One, Two, Three }; + +.. option:: EnumConstantCase + + When defined, the check will ensure enumeration constant names conform to the + selected casing. + +.. option:: EnumConstantPrefix + + When defined, the check will ensure enumeration constant names will add the + prefixed with the given value (regardless of casing). + +.. option:: EnumConstantSuffix + + When defined, the check will ensure enumeration constant names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - EnumConstantCase of ``lower_case`` + - EnumConstantPrefix of ``pre_`` + - EnumConstantSuffix of ``_post`` + +Identifies and/or transforms enumeration constant names as follows: + +Before: + +.. code-block:: c++ + + enum FOO { One, Two, Three }; + +After: + +.. code-block:: c++ + + enum FOO { pre_One_post, pre_Two_post, pre_Three_post }; + +.. option:: FunctionCase + + When defined, the check will ensure function names conform to the + selected casing. + +.. option:: FunctionPrefix + + When defined, the check will ensure function names will add the + prefixed with the given value (regardless of casing). + +.. option:: FunctionSuffix + + When defined, the check will ensure function names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - FunctionCase of ``lower_case`` + - FunctionPrefix of ``pre_`` + - FunctionSuffix of ``_post`` + +Identifies and/or transforms function names as follows: + +Before: + +.. code-block:: c++ + + char MY_Function_string(); + +After: + +.. code-block:: c++ + + char pre_my_function_string_post(); + +.. option:: GlobalConstantCase + + When defined, the check will ensure global constant names conform to the + selected casing. + +.. option:: GlobalConstantPrefix + + When defined, the check will ensure global constant names will add the + prefixed with the given value (regardless of casing). + +.. option:: GlobalConstantSuffix + + When defined, the check will ensure global constant names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - GlobalConstantCase of ``lower_case`` + - GlobalConstantPrefix of ``pre_`` + - GlobalConstantSuffix of ``_post`` + +Identifies and/or transforms global constant names as follows: + +Before: + +.. code-block:: c++ + + unsigned const MyConstGlobal_array[] = {1, 2, 3}; + +After: + +.. code-block:: c++ + + unsigned const pre_myconstglobal_array_post[] = {1, 2, 3}; + +.. option:: GlobalConstantPointerCase + + When defined, the check will ensure global constant pointer names conform to the + selected casing. + +.. option:: GlobalConstantPointerPrefix + + When defined, the check will ensure global constant pointer names will add the + prefixed with the given value (regardless of casing). + +.. option:: GlobalConstantPointerSuffix + + When defined, the check will ensure global constant pointer names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - GlobalConstantPointerCase of ``lower_case`` + - GlobalConstantPointerPrefix of ``pre_`` + - GlobalConstantPointerSuffix of ``_post`` + +Identifies and/or transforms global constant pointer names as follows: + +Before: + +.. code-block:: c++ + + int *const MyConstantGlobalPointer = nullptr; + +After: + +.. code-block:: c++ + + int *const pre_myconstantglobalpointer_post = nullptr; + +.. option:: GlobalFunctionCase + + When defined, the check will ensure global function names conform to the + selected casing. + +.. option:: GlobalFunctionPrefix + + When defined, the check will ensure global function names will add the + prefixed with the given value (regardless of casing). + +.. option:: GlobalFunctionSuffix + + When defined, the check will ensure global function names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - GlobalFunctionCase of ``lower_case`` + - GlobalFunctionPrefix of ``pre_`` + - GlobalFunctionSuffix of ``_post`` + +Identifies and/or transforms global function names as follows: + +Before: + +.. code-block:: c++ + + void GLOBAL_FUNCTION(int PARAMETER_1, int const CONST_parameter); + +After: + +.. code-block:: c++ + + void pre_global_function_post(int PARAMETER_1, int const CONST_parameter); + +.. option:: GlobalPointerCase + + When defined, the check will ensure global pointer names conform to the + selected casing. + +.. option:: GlobalPointerPrefix + + When defined, the check will ensure global pointer names will add the + prefixed with the given value (regardless of casing). + +.. option:: GlobalPointerSuffix + + When defined, the check will ensure global pointer names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - GlobalPointerCase of ``lower_case`` + - GlobalPointerPrefix of ``pre_`` + - GlobalPointerSuffix of ``_post`` + +Identifies and/or transforms global pointer names as follows: + +Before: + +.. code-block:: c++ + + int *GLOBAL3; + +After: + +.. code-block:: c++ + + int *pre_global3_post; + +.. option:: GlobalVariableCase + + When defined, the check will ensure global variable names conform to the + selected casing. + +.. option:: GlobalVariablePrefix + + When defined, the check will ensure global variable names will add the + prefixed with the given value (regardless of casing). + +.. option:: GlobalVariableSuffix + + When defined, the check will ensure global variable names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - GlobalVariableCase of ``lower_case`` + - GlobalVariablePrefix of ``pre_`` + - GlobalVariableSuffix of ``_post`` + +Identifies and/or transforms global variable names as follows: + +Before: + +.. code-block:: c++ + + int GLOBAL3; + +After: + +.. code-block:: c++ + + int pre_global3_post; + +.. option:: InlineNamespaceCase + + When defined, the check will ensure inline namespaces names conform to the + selected casing. + +.. option:: InlineNamespacePrefix + + When defined, the check will ensure inline namespaces names will add the + prefixed with the given value (regardless of casing). + +.. option:: InlineNamespaceSuffix + + When defined, the check will ensure inline namespaces names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - InlineNamespaceCase of ``lower_case`` + - InlineNamespacePrefix of ``pre_`` + - InlineNamespaceSuffix of ``_post`` + +Identifies and/or transforms inline namespaces names as follows: + +Before: + +.. code-block:: c++ + + namespace FOO_NS { + inline namespace InlineNamespace { + ... + } + } // namespace FOO_NS + +After: + +.. code-block:: c++ + + namespace FOO_NS { + inline namespace pre_inlinenamespace_post { + ... + } + } // namespace FOO_NS + +.. option:: LocalConstantCase + + When defined, the check will ensure local constant names conform to the + selected casing. + +.. option:: LocalConstantPrefix + + When defined, the check will ensure local constant names will add the + prefixed with the given value (regardless of casing). + +.. option:: LocalConstantSuffix + + When defined, the check will ensure local constant names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - LocalConstantCase of ``lower_case`` + - LocalConstantPrefix of ``pre_`` + - LocalConstantSuffix of ``_post`` + +Identifies and/or transforms local constant names as follows: + +Before: + +.. code-block:: c++ + + void foo() { int const local_Constant = 3; } + +After: + +.. code-block:: c++ + + void foo() { int const pre_local_constant_post = 3; } + +.. option:: LocalConstantPointerCase + + When defined, the check will ensure local constant pointer names conform to the + selected casing. + +.. option:: LocalConstantPointerPrefix + + When defined, the check will ensure local constant pointer names will add the + prefixed with the given value (regardless of casing). + +.. option:: LocalConstantPointerSuffix + + When defined, the check will ensure local constant pointer names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - LocalConstantPointerCase of ``lower_case`` + - LocalConstantPointerPrefix of ``pre_`` + - LocalConstantPointerSuffix of ``_post`` + +Identifies and/or transforms local constant pointer names as follows: + +Before: + +.. code-block:: c++ + + void foo() { int const *local_Constant = 3; } + +After: + +.. code-block:: c++ + + void foo() { int const *pre_local_constant_post = 3; } + +.. option:: LocalPointerCase + + When defined, the check will ensure local pointer names conform to the + selected casing. + +.. option:: LocalPointerPrefix + + When defined, the check will ensure local pointer names will add the + prefixed with the given value (regardless of casing). + +.. option:: LocalPointerSuffix + + When defined, the check will ensure local pointer names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - LocalPointerCase of ``lower_case`` + - LocalPointerPrefix of ``pre_`` + - LocalPointerSuffix of ``_post`` + +Identifies and/or transforms local pointer names as follows: + +Before: + +.. code-block:: c++ + + void foo() { int *local_Constant; } + +After: + +.. code-block:: c++ + + void foo() { int *pre_local_constant_post; } + +.. option:: LocalVariableCase + + When defined, the check will ensure local variable names conform to the + selected casing. + +.. option:: LocalVariablePrefix + + When defined, the check will ensure local variable names will add the + prefixed with the given value (regardless of casing). + +.. option:: LocalVariableSuffix + + When defined, the check will ensure local variable names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - LocalVariableCase of ``lower_case`` + - LocalVariablePrefix of ``pre_`` + - LocalVariableSuffix of ``_post`` + +Identifies and/or transforms local variable names as follows: + +Before: + +.. code-block:: c++ + + void foo() { int local_Constant; } + +After: + +.. code-block:: c++ + + void foo() { int pre_local_constant_post; } + +.. option:: MemberCase + + When defined, the check will ensure member names conform to the + selected casing. + +.. option:: MemberPrefix + + When defined, the check will ensure member names will add the + prefixed with the given value (regardless of casing). + +.. option:: MemberSuffix + + When defined, the check will ensure member names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - MemberCase of ``lower_case`` + - MemberPrefix of ``pre_`` + - MemberSuffix of ``_post`` + +Identifies and/or transforms member names as follows: + +Before: + +.. code-block:: c++ + + class Foo { + char MY_ConstMember_string[4]; + } + +After: + +.. code-block:: c++ + + class Foo { + char pre_my_constmember_string_post[4]; + } + +.. option:: MethodCase + + When defined, the check will ensure method names conform to the + selected casing. + +.. option:: MethodPrefix + + When defined, the check will ensure method names will add the + prefixed with the given value (regardless of casing). + +.. option:: MethodSuffix + + When defined, the check will ensure method names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - MethodCase of ``lower_case`` + - MethodPrefix of ``pre_`` + - MethodSuffix of ``_post`` + +Identifies and/or transforms method names as follows: + +Before: + +.. code-block:: c++ + + class Foo { + char MY_Method_string(); + } + +After: + +.. code-block:: c++ + + class Foo { + char pre_my_method_string_post(); + } + +.. option:: NamespaceCase + + When defined, the check will ensure namespace names conform to the + selected casing. + +.. option:: NamespacePrefix + + When defined, the check will ensure namespace names will add the + prefixed with the given value (regardless of casing). + +.. option:: NamespaceSuffix + + When defined, the check will ensure namespace names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - NamespaceCase of ``lower_case`` + - NamespacePrefix of ``pre_`` + - NamespaceSuffix of ``_post`` + +Identifies and/or transforms namespace names as follows: + +Before: + +.. code-block:: c++ + + namespace FOO_NS { + ... + } + +After: + +.. code-block:: c++ + + namespace pre_foo_ns_post { + ... + } + +.. option:: ParameterCase + + When defined, the check will ensure parameter names conform to the + selected casing. + +.. option:: ParameterPrefix + + When defined, the check will ensure parameter names will add the + prefixed with the given value (regardless of casing). + +.. option:: ParameterSuffix + + When defined, the check will ensure parameter names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ParameterCase of ``lower_case`` + - ParameterPrefix of ``pre_`` + - ParameterSuffix of ``_post`` + +Identifies and/or transforms parameter names as follows: + +Before: + +.. code-block:: c++ + + void GLOBAL_FUNCTION(int PARAMETER_1, int const CONST_parameter); + +After: + +.. code-block:: c++ + + void GLOBAL_FUNCTION(int pre_parameter_post, int const CONST_parameter); + +.. option:: ParameterPackCase + + When defined, the check will ensure parameter pack names conform to the + selected casing. + +.. option:: ParameterPackPrefix + + When defined, the check will ensure parameter pack names will add the + prefixed with the given value (regardless of casing). + +.. option:: ParameterPackSuffix + + When defined, the check will ensure parameter pack names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ParameterPackCase of ``lower_case`` + - ParameterPackPrefix of ``pre_`` + - ParameterPackSuffix of ``_post`` + +Identifies and/or transforms parameter pack names as follows: + +Before: + +.. code-block:: c++ + + template { + void FUNCTION(int... TYPE_parameters); + } + +After: + +.. code-block:: c++ + + template { + void FUNCTION(int... pre_type_parameters_post); + } + +.. option:: PointerParameterCase + + When defined, the check will ensure pointer parameter names conform to the + selected casing. + +.. option:: PointerParameterPrefix + + When defined, the check will ensure pointer parameter names will add the + prefixed with the given value (regardless of casing). + +.. option:: PointerParameterSuffix + + When defined, the check will ensure pointer parameter names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - PointerParameterCase of ``lower_case`` + - PointerParameterPrefix of ``pre_`` + - PointerParameterSuffix of ``_post`` + +Identifies and/or transforms pointer parameter names as follows: + +Before: + +.. code-block:: c++ + + void FUNCTION(int *PARAMETER); + +After: + +.. code-block:: c++ + + void FUNCTION(int *pre_parameter_post); + +.. option:: PrivateMemberCase + + When defined, the check will ensure private member names conform to the + selected casing. + +.. option:: PrivateMemberPrefix + + When defined, the check will ensure private member names will add the + prefixed with the given value (regardless of casing). + +.. option:: PrivateMemberSuffix + + When defined, the check will ensure private member names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - PrivateMemberCase of ``lower_case`` + - PrivateMemberPrefix of ``pre_`` + - PrivateMemberSuffix of ``_post`` + +Identifies and/or transforms private member names as follows: + +Before: + +.. code-block:: c++ + + class Foo { + private: + int Member_Variable; + } + +After: + +.. code-block:: c++ + + class Foo { + private: + int pre_member_variable_post; + } + +.. option:: PrivateMethodCase + + When defined, the check will ensure private method names conform to the + selected casing. + +.. option:: PrivateMethodPrefix + + When defined, the check will ensure private method names will add the + prefixed with the given value (regardless of casing). + +.. option:: PrivateMethodSuffix + + When defined, the check will ensure private method names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - PrivateMethodCase of ``lower_case`` + - PrivateMethodPrefix of ``pre_`` + - PrivateMethodSuffix of ``_post`` + +Identifies and/or transforms private method names as follows: + +Before: + +.. code-block:: c++ + + class Foo { + private: + int Member_Method(); + } + +After: + +.. code-block:: c++ + + class Foo { + private: + int pre_member_method_post(); + } + +.. option:: ProtectedMemberCase + + When defined, the check will ensure protected member names conform to the + selected casing. + +.. option:: ProtectedMemberPrefix + + When defined, the check will ensure protected member names will add the + prefixed with the given value (regardless of casing). + +.. option:: ProtectedMemberSuffix + + When defined, the check will ensure protected member names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ProtectedMemberCase of ``lower_case`` + - ProtectedMemberPrefix of ``pre_`` + - ProtectedMemberSuffix of ``_post`` + +Identifies and/or transforms protected member names as follows: + +Before: + +.. code-block:: c++ + + class Foo { + protected: + int Member_Variable; + } + +After: + +.. code-block:: c++ + + class Foo { + protected: + int pre_member_variable_post; + } + +.. option:: ProtectedMethodCase + + When defined, the check will ensure protect method names conform to the + selected casing. + +.. option:: ProtectedMethodPrefix + + When defined, the check will ensure protect method names will add the + prefixed with the given value (regardless of casing). + +.. option:: ProtectedMethodSuffix + + When defined, the check will ensure protect method names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - ProtectedMethodCase of ``lower_case`` + - ProtectedMethodPrefix of ``pre_`` + - ProtectedMethodSuffix of ``_post`` + +Identifies and/or transforms protect method names as follows: + +Before: + +.. code-block:: c++ + + class Foo { + protected: + int Member_Method(); + } + +After: + +.. code-block:: c++ + + class Foo { + protected: + int pre_member_method_post(); + } + +.. option:: PublicMemberCase + + When defined, the check will ensure public member names conform to the + selected casing. + +.. option:: PublicMemberPrefix + + When defined, the check will ensure public member names will add the + prefixed with the given value (regardless of casing). + +.. option:: PublicMemberSuffix + + When defined, the check will ensure public member names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - PublicMemberCase of ``lower_case`` + - PublicMemberPrefix of ``pre_`` + - PublicMemberSuffix of ``_post`` + +Identifies and/or transforms public member names as follows: + +Before: + +.. code-block:: c++ + + class Foo { + public: + int Member_Variable; + } + +After: + +.. code-block:: c++ + + class Foo { + public: + int pre_member_variable_post; + } + +.. option:: PublicMethodCase + + When defined, the check will ensure public method names conform to the + selected casing. + +.. option:: PublicMethodPrefix + + When defined, the check will ensure public method names will add the + prefixed with the given value (regardless of casing). + +.. option:: PublicMethodSuffix + + When defined, the check will ensure public method names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - PublicMethodCase of ``lower_case`` + - PublicMethodPrefix of ``pre_`` + - PublicMethodSuffix of ``_post`` + +Identifies and/or transforms public method names as follows: + +Before: + +.. code-block:: c++ + + class Foo { + public: + int Member_Method(); + } + +After: + +.. code-block:: c++ + + class Foo { + public: + int pre_member_method_post(); + } + +.. option:: StaticConstantCase + + When defined, the check will ensure static constant names conform to the + selected casing. + +.. option:: StaticConstantPrefix + + When defined, the check will ensure static constant names will add the + prefixed with the given value (regardless of casing). + +.. option:: StaticConstantSuffix + + When defined, the check will ensure static constant names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - StaticConstantCase of ``lower_case`` + - StaticConstantPrefix of ``pre_`` + - StaticConstantSuffix of ``_post`` + +Identifies and/or transforms static constant names as follows: + +Before: + +.. code-block:: c++ + + static unsigned const MyConstStatic_array[] = {1, 2, 3}; + +After: + +.. code-block:: c++ + + static unsigned const pre_myconststatic_array_post[] = {1, 2, 3}; + +.. option:: StaticVariableCase + + When defined, the check will ensure static variable names conform to the + selected casing. + +.. option:: StaticVariablePrefix + + When defined, the check will ensure static variable names will add the + prefixed with the given value (regardless of casing). + +.. option:: StaticVariableSuffix + + When defined, the check will ensure static variable names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - StaticVariableCase of ``lower_case`` + - StaticVariablePrefix of ``pre_`` + - StaticVariableSuffix of ``_post`` + +Identifies and/or transforms static variable names as follows: + +Before: + +.. code-block:: c++ + + static unsigned MyStatic_array[] = {1, 2, 3}; + +After: + +.. code-block:: c++ + + static unsigned pre_mystatic_array_post[] = {1, 2, 3}; + +.. option:: StructCase + + When defined, the check will ensure struct names conform to the + selected casing. + +.. option:: StructPrefix + + When defined, the check will ensure struct names will add the + prefixed with the given value (regardless of casing). + +.. option:: StructSuffix + + When defined, the check will ensure struct names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - StructCase of ``lower_case`` + - StructPrefix of ``pre_`` + - StructSuffix of ``_post`` + +Identifies and/or transforms struct names as follows: + +Before: + +.. code-block:: c++ + + struct FOO { + FOO(); + ~FOO(); + }; + +After: + +.. code-block:: c++ + + struct pre_foo_post { + pre_foo_post(); + ~pre_foo_post(); + }; + +.. option:: TemplateParameterCase + + When defined, the check will ensure template parameter names conform to the + selected casing. + +.. option:: TemplateParameterPrefix + + When defined, the check will ensure template parameter names will add the + prefixed with the given value (regardless of casing). + +.. option:: TemplateParameterSuffix + + When defined, the check will ensure template parameter names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - TemplateParameterCase of ``lower_case`` + - TemplateParameterPrefix of ``pre_`` + - TemplateParameterSuffix of ``_post`` + +Identifies and/or transforms template parameter names as follows: + +Before: + +.. code-block:: c++ + + template class Foo {}; + +After: + +.. code-block:: c++ + + template class Foo {}; + +.. option:: TemplateTemplateParameterCase + + When defined, the check will ensure template template parameter names conform to the + selected casing. + +.. option:: TemplateTemplateParameterPrefix + + When defined, the check will ensure template template parameter names will add the + prefixed with the given value (regardless of casing). + +.. option:: TemplateTemplateParameterSuffix + + When defined, the check will ensure template template parameter names will add the + suffix with the given value (regardless of casing). + +For example using values of: + + - TemplateTemplateParameterCase of ``lower_case`` + - TemplateTemplateParameterPrefix of ``pre_`` + - TemplateTemplateParameterSuffix of ``_post`` + +Identifies and/or transforms template template parameter names as follows: + +Before: + +.. code-block:: c++ + + template