readability-named-parameter#

Find functions with unnamed arguments.

The check implements the following rule originating in the Google C++ Style Guide:

https://google.github.io/styleguide/cppguide.html#Function_Declarations_and_Definitions

All parameters should have the same name in both the function declaration and definition. If a parameter is not utilized, its name can be commented out in a function definition.

int doingSomething(int a, int b, int c);

int doingSomething(int a, int b, int /*c*/) {
    // Ok: the third param is not used
    return a + b;
}

Corresponding cpplint.py check name: readability/function.

The check ignores parameters whose types are standard tag types (e.g. std::in_place_t, std::allocator_arg_t, std::nothrow_t, iterator tags, lock tags, etc.). The set of ignored types can be customized with the IgnoredTypes option.

Options#

InsertPlainNamesInForwardDecls#: When true, the check will insert parameter names without comments for forward declarations only. Otherwise, the check will insert parameter names as comments (e.g., /*param*/). Default is false.

IgnoredTypes#

A semicolon-separated list of fully-qualified type names whose parameters do not need to be named (for example, tag dispatch types, iterator tags, etc.). The following standard tag types are ignored by default:

std::adopt_lock_t
std::allocator_arg_t
std::bidirectional_iterator_tag
std::contiguous_iterator_tag
std::default_sentinel_t
std::defer_lock_t
std::destroying_delete_t
std::forward_iterator_tag
std::from_range_t
std::in_place_index_t
std::in_place_t
std::in_place_type_t
std::input_iterator_tag
std::nothrow_t
std::nostopstate_t
std::nullopt_t
std::output_iterator_tag
std::piecewise_construct_t
std::random_access_iterator_tag
std::sorted_equivalent_t
std::sorted_unique_t
std::try_to_lock_t
std::unexpect_t
std::unreachable_sentinel_t