9 Declarations [dcl]

9.13 Attributes [dcl.attr]

9.13.12 Annotations [dcl.attr.annotation]

An annotation may be applied to a base-specifier or to a declaration D of a type, type alias, variable, function, namespace, enumerator, or non-static data member, unless

(1.1)
the host scope of X differs from its target scope or
(1.2)
X is a non-defining friend declaration,

where X is

(1.3)
$D^{'}$ if D is a function parameter declaration in a function declarator ([dcl.fct]) of a function declaration $D^{'}$ and
(1.4)
D otherwise.

Let E be the expression std::meta::reflect_constant(constant-expression).

E shall be a constant expression; the result of E is the underlying constant of the annotation.

Each annotation or instantiation thereof produces a unique annotation.

[Example 1:

[[=1]] void f(); [[=2, =3, =2]] void g(); void g [[=4, =2]] (); f has one annotation and g has five annotations.

These can be queried with metafunctions such as std::meta::annotations_of ([meta.reflection.annotation]).

— end example]

[Example 2: template<int> int x [[=1]]; static_assert(annotations_of(^^x<0>) != annotations_of(^^x<1>)); // OK — end example]

Substituting into an annotation is not in the immediate context.

[Example 3: template<class T> [[=T::type()]] void f(T t); void f(int); void g() { f(0); // OK f('0'); // error, substituting into the annotation results in an invalid expression } — end example]