[dcl.constinit] (original) (raw)

9 Declarations [dcl]

9.2 Specifiers [dcl.spec]

9.2.7 The constinit specifier [dcl.constinit]

The constinit specifier shall be applied only to a declaration of a variable with static or thread storage duration or to a structured binding declaration ([dcl.struct.bind]).

[Note 1:

A structured binding declaration introduces a uniquely named variable, to which the constinit specifier applies.

— _end note_]

If the specifier is applied to any declaration of a variable, it shall be applied to the initializing declaration.

No diagnostic is required if no constinit declaration is reachable at the point of the initializing declaration.

If a variable declared with the constinit specifier has dynamic initialization ([basic.start.dynamic]), the program is ill-formed, even if the implementation would perform that initialization as a static initialization ([basic.start.static]).

[Note 2:

The constinit specifier ensures that the variable is initialized during static initialization.

— _end note_]

[Example 1: const char * g() { return "dynamic initialization"; } constexpr const char * f(bool p) { return p ? "constant initializer" : g(); } constinit const char * c = f(true); constinit const char * d = f(false); — _end example_]