modernize-use-designated-initializers¶
Finds initializer lists for aggregate types which could be written as designated initializers instead.
With plain initializer lists, it is very easy to introduce bugs when adding new fields in the middle of a struct or class type. The same confusion might arise when changing the order of fields.
C++20 supports the designated initializer syntax for aggregate types. By applying it, we can always be sure that aggregates are constructed correctly, because every variable being initialized is referenced by its name.
Example:
struct S { int i, j; };
is an aggregate type that should be initialized as
S s{.i = 1, .j = 2};
instead of
S s{1, 2};
which could easily become an issue when i
and j
are swapped in the
declaration of S
.
Even when compiling in a language version older than C++20, depending on your
compiler, designated initializers are potentially supported. Therefore, the
check is by default restricted to C99/C++20 and above. Check out the options
-Wc99-designator
to get support for mixed designators in initializer list in
C and -Wc++20-designator
for support of designated initializers in older C++
language modes.
Options¶
- IgnoreMacros¶
The value false specifies that components of initializer lists expanded from macros are not checked. The default value is true.
- IgnoreSingleElementAggregates¶
The value false specifies that even initializers for aggregate types with only a single element should be checked. The default value is true.
- RestrictToPODTypes¶
The value true specifies that only Plain Old Data (POD) types shall be checked. This makes the check applicable to even older C++ standards. The default value is false.
- StrictCStandardCompliance¶
When set to false, the check will not restrict itself to C99 and above. The default value is true.
- StrictCppStandardCompliance¶
When set to false, the check will not restrict itself to C++20 and above. The default value is true.