| Document Number: | P0194R2, ISO/IEC JTC1 SC22 WG21 |
|---|---|
| Date: | 2016-10-15 |
| Project: | Programming Language C++ |
| Audience: | Reflection(SG7) / EWG |
| Authors: | Matúš Chochlík (chochlik@gmail.com) |
| Axel Naumann (axel@cern.ch) | |
| David Sankel (camior@gmail.com) |
This paper is the sixth revision of the proposal to add support for compile-time reflection to standard C++. We propose that the compiler shall generate metaobjects — representations of certain program declarations, which can be reasoned-about at compile time. These metaobjects can then be used, through a set of operations to obtain various pieces of metadata, like declaration names, lists of scope members, information about specifiers, and so on. The metaobjects are implemented as anonymous types conforming to defined concepts, and the operations are implemented as class templates.
This paper is accompanied by another paper — P0385, which discusses the use cases, rationale, design decisions, future evolution of the proposed reflection facility and contains multiple examples of use and replies to frequently asked questions.
This proposal relies on the Concepts TS, including a resolution to its Issue 29. It also assumes that WG21 will incoporate proper compile-time strings; until then, this proposal provides a placeholder implementation (see [refl.ops.str]) to facilitate reasoning about the interfaces.
Insert a new element in Table 1, C++ library headers of
[general.namespaces], named <experimental/reflexpr>.
Insert a new section:
? Compile-time reflection [refl]
?.1 General description [refl.general]
Compile-time constant metadata describing various aspects of a compiled program are provided indirectly by the means of types generated by the compiler — Metaobjects. A Metaobject is an anonymous type reflecting (representing) a particular declaration or another base-level entity in a C++ program. It can be reasoned-about at compile-time and provides access to metadata describing various properties of the reflected entity through a set of templates. The Metaobject types themselves are opaque, without any visible internal structure. Values of such a Metaobject type can be default-constructed, copy-constructed and copy-assigned.
Metaobjects are generated on demand by the compiler as the result of the invocation of the
reflexproperator.The actual metadata is obtained by instantiating templates constituting the interface of the Metaobjects. Each template serves a particular purpose and provides a single piece of metadata. These templates are collectively referred to as Metaobject operations.
Metaobjects reflecting different kinds of declarations conform to different Metaobject concepts and have different interfaces — sets of templates applicable to the Metaobjects. These concepts can also be used for Metaobject classification.
Metaobject concepts form a generalization-specialization hierarchy, with
meta::Objectbeing the common generalization for all Metaobjects.?.2 Metaobject trait[refl.trait]
A new UnaryTypeTrait —
is_metaobjectis added to section [meta.unary.cat] to distinguish between Metaobject types generated by the compiler and all other types.namespace std { namespace experimental { template <typename T> struct is_metaobject; template <typename T> constexpr bool is_metaobject_v = is_metaobject<T>::value; } // namespace experimental } // namespace std[Example:is_metaobject_v<int>; // false is_metaobject_v<reflexpr(int)>; // true is_metaobject_v<reflexpr(std)>; // true using Mstring = reflexpr(string); is_metaobject_v<Mstring>; // true— end example]?.3 Header
<experimental/reflexpr>synopsis[refl.synopsis]namespace std { namespace experimental namespace meta { // metaobject concepts template <typename T> concept bool Object; template <Object T> concept bool ObjectSequence; template <Object T> concept bool Reversible; template <Object T> concept bool Named; template <Object T> concept bool Alias; template <Object T> concept bool Typed; template <Object T> concept bool Scope; template <Object T> concept bool ScopeMember; template <Object T> concept bool RecordMember; template <Object T> concept bool EnumMember; template <Object T> concept bool Namespace; template <Object T> concept bool GlobalScope; template <Object T> concept bool Type; template <Object T> concept bool TagType; template <Object T> concept bool Record; template <Object T> concept bool Class; template <Object T> concept bool Enum; template <Object T> concept bool Constant; template <Object T> concept bool Variable; template <Object T> concept bool Specifier; template <Object T> concept bool Inheritance; // metaobject operations template <Object T1, Object T2> struct reflects_same; template <Object T> struct get_source_location; template <ObjectSequence T> struct get_size; template <ObjectSequence T1, size_t Index> struct get_element; template <ObjectSequence T1, template <class...> class Tpl> struct unpack_sequence; template <Named T> struct is_anonymous; template <Named T> struct get_base_name; template <Named T> struct get_display_name; template <Alias T> struct get_aliased; template <Typed T> struct get_type; template <ScopeMember T> struct get_scope; template <RecordMember T> struct is_public; template <RecordMember T> struct is_protected; template <RecordMember T> struct is_private; template <RecordMember T> struct get_access_specifier; template <Type T> struct get_reflected_type; template <TagType T> struct get_elaborated_type_specifier; template <TagType T> struct is_enum; template <TagType T> struct is_class; template <TagType T> struct is_struct; template <TagType T> struct is_union; template <Record T> struct get_data_members; template <Record T> struct get_public_data_members; template <Record T> struct get_member_types; template <Record T> struct get_public_member_types; template <Class T> struct get_base_classes; template <Class T> struct get_public_base_classes; template <Enum T> struct is_scoped_enum; template <Enum T> struct get_enumerators; template <Constant T> struct get_constant; template <Variable T> struct is_static; template <Variable T> struct get_pointer; template <Inheritance T> struct get_base_class; template <Inheritance T> struct is_virtual; template <Inheritance T> struct is_public; template <Inheritance T> struct is_protected; template <Inheritance T> struct is_private; template <Inheritance T> struct get_access_specifier; // template <Object T1, Object T2> constexpr auto reflects_same_v = reflects_same<T1, T2>::value; template <ObjectSequence T> constexpr auto get_size_v = get_size<T>::value; template <ObjectSequence T1, size_t Index> using get_element_m = typename get_element<T1, Index>::type; template <ObjectSequence T1, template <class...> class Tpl> constexpr auto unpack_sequence_v = unpack_sequence<T1, Tpl>::value; template <Named T> constexpr auto is_anonymous_v = is_anonymous<T>::value; template <Named T> constexpr auto get_base_name_v = get_base_name<T>::value; template <Named T> constexpr auto get_display_name_v = get_display_name<T>::value; template <Alias T> using get_aliased_m = typename get_aliased<T>::type; template <Typed T> using get_type_m = typename get_type<T>::type; template <ScopeMember T> using get_scope_m = typename get_scope<T>::type; template <RecordMember T> constexpr auto is_public_v = is_public<T>::value; template <RecordMember T> constexpr auto is_protected_v = is_protected<T>::value; template <RecordMember T> constexpr auto is_private_v = is_private<T>::value; template <RecordMember T> using get_access_specifier_m = typename get_access_specifier<T>::type; template <Type T> using get_reflected_type_t = typename get_reflected_type<T>::type; template <TagType T> using get_elaborated_type_specifier_m = typename get_elaborated_type_specifier<T>::type; template <TagType T> constexpr auto is_enum_v = is_enum<T>::value; template <TagType T> constexpr auto is_class_v = is_class<T>::value; template <TagType T> constexpr auto is_struct_v = is_struct<T>::value; template <TagType T> constexpr auto is_union_v = is_union<T>::value; template <Record T> using get_data_members_m = typename get_data_members<T>::type; template <Record T> using get_public_data_members_m = typename get_public_data_members<T>::type; template <Record T> using get_member_types_m = typename get_member_types<T>::type; template <Record T> using get_public_member_types_m = typename get_public_member_types<T>::type; template <Class T> using get_base_classes_m = typename get_base_classes<T>::type; template <Class T> using get_public_base_classes_m = typename get_public_base_classes<T>::type; template <Enum T> constexpr auto is_scoped_enum_v = is_scoped_enum<T>::value; template <Enum T> using get_enumerators_m = typename get_enumerators<T>::type; template <Constant T> constexpr auto get_constant_v = get_constant<T>::value; template <Variable T> constexpr auto is_static_v = is_static<T>::value; template <Variable T> const auto get_pointer_v = get_pointer<T>::value; template <Inheritance T> using get_base_class_m = typename get_base_class<T>::type; template <Inheritance T> constexpr auto is_virtual_v = is_virtual<T>::value; template <Inheritance T> constexpr auto is_public_v = is_public<T>::value; template <Inheritance T> constexpr auto is_protected_v = is_protected<T>::value; template <Inheritance T> constexpr auto is_private_v = is_private<T>::value; template <Inheritance T> using get_access_specifier_m = typename get_access_specifier<T>::type; } // namespace meta } // namespace experimental } // namespace std?.4 Metaobject concepts[refl.concepts]
Concept Requirements Description template <typename T> concept bool Object;is_metaobject_v<T>
meta::Objectis a concept modelled by stateless anonymous types generated by the compiler which allow access to metadata reflecting specific program declarations.template <typename T> concept bool ObjectSequence;Object<T>
meta::ObjectSequenceis an ordered sequence of metaobjects.template <typename T> concept bool Reversible;Object<T>
meta::Reversibleis a metaobject that can be reverted to the original declaration.template <typename T> concept bool Named;Object<T>
meta::Namedreflects a named declaration.template <typename T> concept bool Alias;Named<T>
meta::Aliasreflects a type or namespace alias.template <typename T> concept bool Typed;Object<T>
meta::Typedreflects a base-level declaration with a type (for example a variable).template <typename T> concept bool Scope;Object<T>
meta::Scopereflects a scope.template <typename T> concept bool ScopeMember;Object<T>
meta::ScopeMemberreflects a declaration nested in a scope (like the global scope, namespace, class, enum, etc.).template <typename T> concept bool RecordMember;ScopeMember<T>
meta::RecordMemberreflects a class, struct or union member.template <typename T> concept bool EnumMember;ScopeMember<T>
meta::EnumMemberreflects a enum member.template <typename T> concept bool Namespace;Named<T>Scope<T>ScopeMember<T>
meta::Namespacereflects a namespace.template <typename T> concept bool GlobalScope;Namespace<T>
meta::GlobalScopereflects the global scope.template <typename T> concept bool Type;Reversible<T>Named<T>
meta::Typereflects a type.template <typename T> concept bool TagType;Type<T>Scope<T>ScopeMember<T>
meta::TagTypereflects a class or an enum.template <typename T> concept bool Record;TagType<T>
meta::Recordreflects a class, a scope or a union.template <typename T> concept bool Class;Record<T>
meta::Classreflects a class or a struct.template <typename T> concept bool Enum;TagType<T>
meta::Enumreflects an enumeration.template <typename T> concept bool Constant;Reversible<T>Typed<T>
meta::Constantreflects a compile-time constant value.template <typename T> concept bool Variable;Reversible<T>Named<T>Typed<T>ScopeMember<T>
meta::Variablereflects a variable.template <typename T> concept bool Specifier;Named<T>
meta::Specifierreflects a specifier (const, virtual, static, noexcept, public, protected, private, etc.).template <typename T> concept bool Inheritance;Object<T>
meta::Inheritancereflects class inheritance.[Note: Metaobjects reflecting anonymous types, anonymous namespaces and the global scope also satisfy the
meta::Namedconcept. The fact that they reflect an anonymous declaration is indicated by themeta::is_anonymousoperation. In such case themeta::get_base_nameand themeta::get_display_nameoperations return an empty (null terminated) string. — end note][Example:static_assert(meta::Named<reflexpr(string)>, ""); auto l = [](void) { }; static_assert(meta::Named<reflexpr()>, ""); static_assert(meta::Named<reflexpr(decltype(l))>, ""); static_assert(!meta::is_anonymous_v<reflexpr(int)>, ""); auto l = [](void) { }; static_assert(meta::is_anonymous_v<reflexpr(::)>, ""); static_assert(meta::is_anonymous_v<reflexpr(decltype(l))>, ""); static_assert(meta::get_base_name_v<reflexpr(int)>[0] != '\0', ""); auto l = [](void) { }; static_assert(meta::get_base_name_v<reflexpr(::)>[0] == '\0', ""); static_assert(meta::get_base_name_v<reflexpr(decltype(l))>[0] == '\0', "");— end example]Metaobjects reflecting fundamental types (except for
std::nullptr_t), pointers (including pointers-to-members), references, arrays and function types do not conform to the meta::ScopeMember concept, all other types do.[Example:struct S { }; namespace foo { class C { }; } static_assert(!meta::ScopeMember(reflexpr(int)), ""); static_assert(!meta::ScopeMember(reflexpr(int*)), ""); static_assert(!meta::ScopeMember(reflexpr(S[10])), ""); static_assert(!meta::ScopeMember(reflexpr(foo::C&)), ""); static_assert(!meta::ScopeMember(reflexpr(int(*)(char, bool))), ""); static_assert( meta::ScopeMember(reflexpr(S)), ""); static_assert( meta::ScopeMember(reflexpr(foo::C)), ""); static_assert( meta::ScopeMember(reflexpr(std::size_t)), "");— end example]?.5 Metaobject operations[refl.ops]
A MetaobjectOperation extracts information from Metaobjects. It is a class template taking one or more arguments, at least one of which models the Metaobject concept. The result of a MetaobjectOperation can be either a compile-time constant value, aconstpointer, or a type.?.5.1 Boolean constant result[refl.ops.bool]
All MetaobjectOperation templates returning a boolean value derive publicly and unambiguously from
true_typeorfalse_type.[Example:struct MetaobjectOperation : integral_constant<bool, implementation-defined> { };— end example]?.5.2 Integral or
enumconstant result[refl.ops.int]All MetaobjectOperation templates returning an integer or
enumvalue derive publicly and unambiguously from a specialization ofintegral_constant. The first argument's integer orenumtype is part of the specification of the operation.[Example:struct MetaobjectOperation : integral_constant<integral-or-enum-type, implementation-defined> { };— end example]?.5.3 Pointer result[refl.ops.ptr]
The MetaobjectOperation templates returning a pointer or a class data member pointer derive publicly and unambiguously from a specialization of
integral_constantwith value as if taken by the&operator. The first argument's pointer or class data member pointer type is part of the specification of the operation.[Example:struct MetaobjectOperation : integral_constant<pointer-or-data-member-pointer-type, implementation-defined> { };— end example]?.5.4 String constant result[refl.ops.str]
All MetaobjectOperation templates returning a character string instantiate into a type equivalent to the following:
struct MetaobjectOperation { typedef const char value_type[N+1]; static constexpr value_type value = implementation-defined; };where
Nis the length of the returned string and the last element in thevaluecharacter array is the'\0'character. The member namesvalue_typeandvalueare publicly and unambiguously available in such MetaobjectOperation.?.5.5 Type result[refl.ops.type]
The MetaobjectOperation templates yielding a non-Metaobject type instantiates into a type equivalent to the following:
struct MetaobjectOperation { using type = unspecified; };The MetaobjectOperation templates yielding another Metaobject type instantiate into a type equivalent to the following:
struct MetaobjectOperation { using type = Object; };The member name
typeis publicly and unambiguously available in such MetaobjectOperation.?.5.6 Source location result[refl.ops.srcloc]
The MetaobjectOperation templates yielding
source_locationcompile-time values will be equivalent to the following:struct MetaobjectOperation : source_location /* initialized in an implementation-defined way */ { };?.5.7 Operation description[refl.ops.desc]
Template Description Result template <Object T1, Object T2> struct reflects_same;indicates whether two metaobjects reflect the same base-level declaration ('entity'). a boolean constant template <Object T> struct get_source_location;returns the source location info of the declaration of a base-level program declaration reflected by a meta::Object.a std::source_locationconstanttemplate <ObjectSequence T> struct get_size;returns the number of elements in the sequence. a size_tintegral constanttemplate <ObjectSequence T1, size_t Index> struct get_element;returns the i-th meta::Objectin ameta::ObjectSequence.meta::Objecttemplate <ObjectSequence T1, template <class...> class Tpl> struct unpack_sequence;unpacks the meta::ObjectSequenceinto a template.a type template <Named T> struct is_anonymous;indicates whether the a named declaration reflected by a meta::Namedis anonymous.a boolean constant template <Named T> struct get_base_name;returns the basic name of the a named declaration reflected by a meta::Named.a string constant template <Named T> struct get_display_name;returns the display name of the a named declaration reflected by a meta::Named.a string constant template <Alias T> struct get_aliased;returns the meta::Namedreflecting the original declaration of a type or namespace alias reflected by ameta::Alias.meta::Namedtemplate <Typed T> struct get_type;returns the meta::Typereflecting the type of a base-level declaration with a type (for example a variable) reflected by ameta::Typed.meta::Typetemplate <ScopeMember T> struct get_scope;returns the meta::Scopereflecting the scope of a declaration nested in a scope (like the global scope, namespace, class, enum, etc.) reflected by ameta::ScopeMember.meta::Scopetemplate <RecordMember T> struct is_public;indicates whether the a class, struct or union member reflected by a meta::RecordMemberwas declared with public access.a boolean constant template <RecordMember T> struct is_protected;indicates whether the a class, struct or union member reflected by a meta::RecordMemberwas declared with protected access.a boolean constant template <RecordMember T> struct is_private;indicates whetherthe a class, struct or union member reflected by a meta::RecordMemberwas declared with private access.a boolean constant template <RecordMember T> struct get_access_specifier;returns the meta::Specifierreflecting the access specifier of a class, struct or union member reflected by ameta::RecordMember.meta::Specifiertemplate <Type T> struct get_reflected_type;returns the the base-level type reflected by a meta::Type.the original type reflected by the argument template <TagType T> struct get_elaborated_type_specifier;returns a meta::Specifierreflecting the elaborated type specifier (class,struct,union,...) of a class or an enum reflected by ameta::TagType.meta::Specifiertemplate <TagType T> struct is_enum;indicates whether the a class or an enum reflected by a meta::TagTypeis an enum.a boolean constant template <TagType T> struct is_class;indicates whether the a class or an enum reflected by a meta::TagTypeis a class.a boolean constant template <TagType T> struct is_struct;indicates whether the a class or an enum reflected by a meta::TagTypeis a struct.a boolean constant template <TagType T> struct is_union;indicates whether the a class or an enum reflected by a meta::TagTypeis a union.a boolean constant template <Record T> struct get_data_members;returns a meta::ObjectSequenceofmeta::Variable(s) reflecting all (including private and protected) data members of a class, a scope or a union reflected by ameta::Record.meta::ObjectSequenceofmeta::Variable(s)template <Record T> struct get_public_data_members;returns a meta::ObjectSequenceofmeta::Variable(s) reflecting the public data members of a class, a scope or a union reflected by ameta::Record.meta::ObjectSequenceofmeta::Variable(s)template <Record T> struct get_member_types;returns a meta::ObjectSequenceofmeta::Type(s) reflecting all (including private and protected) member types of a class, a scope or a union reflected by ameta::Record.meta::ObjectSequenceofmeta::Type(s)template <Record T> struct get_public_member_types;returns a meta::ObjectSequenceofmeta::Type(s) reflecting the public member types of a class, a scope or a union reflected by ameta::Record.meta::ObjectSequenceofmeta::Type(s)template <Class T> struct get_base_classes;returns a meta::ObjectSequenceofmeta::Inheritance(s) reflecting the inheritance of all base clases (including the private and protected ones) of a a class or a struct reflected by ameta::Class.meta::ObjectSequenceofmeta::Inheritance(s)template <Class T> struct get_public_base_classes;returns a meta::ObjectSequenceofmeta::Inheritance(s) reflecting the inheritance of public base clases of a a class or a struct reflected by ameta::Class.meta::ObjectSequenceofmeta::Inheritance(s)template <Enum T> struct is_scoped_enum;returns true if the an enumeration reflected by a meta::Enumis scoped.a boolean constant template <Enum T> struct get_enumerators;returns a meta::ObjectSequenceofmeta::Constant(s) reflecting all enumerators of an enumeration reflected by ameta::Enum.meta::ObjectSequenceofmeta::Constant(s)template <Constant T> struct get_constant;returns the value of a compile-time constant value reflected by a meta::Constant.a constant value of an unspecified, integer or enum type template <Variable T> struct is_static;returns whether the a variable reflected by a meta::Variablewas declared with the static specifier.a boolean constant template <Variable T> struct get_pointer;returns a pointer to the a variable reflected by a meta::Variable. If the variable is a class member then the pointer is a class data member pointer, otherwise it is a plain pointer.a regular or class data member pointer template <Inheritance T> struct get_base_class;returns the meta::Inheritancereflecting the base class inheritance in a inheritance.meta::Classtemplate <Inheritance T> struct is_virtual;returns whether the class inheritance reflected by a meta::Inheritancewas declared as virtual.a boolean constant template <Inheritance T> struct is_public;indicates whether the class inheritance reflected by a meta::Inheritancewas declared as public.a boolean constant template <Inheritance T> struct is_protected;indicates whether the class inheritance reflected by a meta::Inheritancewas declared as protected.a boolean constant template <Inheritance T> struct is_private;indicates whether the class inheritance reflected by a meta::Inheritancewas declared as private.a boolean constant template <Inheritance T> struct get_access_specifier;returns the meta::Specifierreflecting the access specifier of class inheritance reflected by ameta::Inheritance.meta::Specifier?.5.7.1 Operation
get_base_name[refl.ops.base_name]For
meta::Types reflecting fundamental types, theget_base_nameoperation returns the longest type specifier name, i.e. includinglong,signedorunsignedmodifiers, if they describe the identical type.[Example:meta::get_base_name_v<reflexpr(unsigned)> // "unsigned int" meta::get_base_name_v<reflexpr(short)> // "signed short int" meta::get_base_name_v<reflexpr(long long)> // "signed long long int" meta::get_base_name_v<reflexpr(long double)> // "long double" meta::get_base_name_v<reflexpr(signed char)> // "signed char" meta::get_base_name_v<reflexpr(unsigned char)> // "unsigned char" meta::get_base_name_v<reflexpr(char)> // "char"— end example]The
get_base_nameinvoked on ameta::Aliasreturns the alias name, not the name of the aliased declaration.[Example:using foo = int; using bar = foo; namespace baz = std; typedef foo(*pfoo)(double, float); meta::get_base_name_v<reflexpr(foo)> // "foo" meta::get_base_name_v<reflexpr(bar)> // "bar" meta::get_base_name_v<reflexpr(baz)> // "baz" meta::get_base_name_v<reflexpr(pfoo)> // "pfoo"— end example]The
get_base_nameoperation returns the type, namespace, etc. name without any qualifiers, asterisks, ampersands, angle or square brackets, etc.[Example:using meta::get_base_name_v; get_base_name_v<reflexpr(std::vector<int>)> // "vector" get_base_name_v<reflexpr(volatile std::size_t* [10])> // "unsigned long int" get_base_name_v<reflexpr(std::set<int>* (*)(std::vector<double>&))> // "" get_base_name_v<reflexpr(std::chrono)> // "chrono" get_base_name_v<reflexpr(std::launch)> // "launch" get_base_name_v<reflexpr(static)> // "static" get_base_name_v<reflexpr(class)> // "class"— end example]?.5.7.2 Operation
get_display_name[refl.ops.disp_name]The
meta::get_display_nameoperation returns an implementation-defined string containing the name of the base-level entity reflected by ameta::Namedwhich is as close as possible to how the name is spelled in the source code. For types in particular the display name should be fully qualified and if possible it should preserve type or template alias names.[Example:meta::get_display_name_v<reflexpr(int)> // "int" meta::get_display_name_v<reflexpr(const std::string&)> // "const std::string&" meta::get_display_name_v<reflexpr(std::size_t * [10])> // "std::size * [10]" meta::get_display_name_v<reflexpr(decltype("foo"))> // "char const [4]"— end example]?.5.7.3 Operation
get_aliased[refl.ops.aliased]The
meta::get_aliasedoperation invoked on ameta::Aliasalways returns a (nonmeta::Alias)meta::Typeormeta::Namespacereflecting the entity which has a unique identity at the base-level, which is directly or indirectly referenced by the original alias.[Example:using A = int; using B = const A; using C = B*; template <typename T> struct S { using X = T&; }; static_assert( meta::Type<reflexpr(A)>, ""); static_assert( meta::Alias<reflexpr(A)>, ""); static_assert( meta::Type<meta::get_aliased_m<reflexpr(A)>>, ""); static_assert(!meta::Alias<meta::get_aliased_m<reflexpr(A)>>, ""); static_assert( meta::Type<reflexpr(B)>, ""); static_assert( meta::Alias<reflexpr(B)>, ""); static_assert( meta::Type<meta::get_aliased_m<reflexpr(B)>>, ""); static_assert(!meta::Alias<meta::get_aliased_m<reflexpr(B)>>, ""); static_assert( meta::Type<reflexpr(C)>, ""); static_assert( meta::Alias<reflexpr(C)>, ""); static_assert( meta::Type<meta::get_aliased_m<reflexpr(C)>>, ""); static_assert(!meta::Alias<meta::get_aliased_m<reflexpr(C)>>, ""); static_assert(meta::reflects_same_v< meta::get_aliased_m<reflexpr(A)>, reflexpr(int) >, ""); static_assert(meta::reflects_same_v< meta::get_aliased_m<reflexpr(B)>, reflexpr(const int) >, ""); static_assert(meta::reflects_same_v< meta::get_aliased_m<reflexpr(C)>, reflexpr(const int *) >, ""); static_assert(meta::reflects_same_v< meta::get_aliased_m<reflexpr(S<A>::X)>, reflexpr(int &) >, ""); static_assert(meta::reflects_same_v< meta::get_aliased_m<reflexpr(S<B>::X)>, reflexpr(const int &) >, ""); static_assert(meta::reflects_same_v< meta::get_aliased_m<reflexpr(S<C>::X)>, reflexpr(const int * &) >, "");— end example]Template type parameters are also considered to be a special kind of type aliases:
[Example:template <typename A, typename B> void foo(A a, B b) { using meta::get_base_name_v; using meta::get_aliased_m; using mA = reflexpr(A); using mB = reflexpr(B); cout << "1:" << get_base_name_v<mA> << endl; cout << "2:" << get_base_name_v<get_aliased_m<mA>> << endl; cout << "3:" << get_base_name_v<mB> << endl; cout << "4:" << get_base_name_v<get_aliased_m<mB>> << endl; } using rank_t = int; rank_t a = 123; float b = 45.67; foo(a, b); using mR = reflexpr(rank_t); cout << "5:" << get_base_name_v<mR> << endl; cout << "6:" << get_base_name_v<get_aliased_m<mR>> << endl;produces the following output:1:A 2:int 3:B 4:float 5:rank_t; 6:int;— end example]?.5.7.4 Sequence operations[refl.ops.seq]
Metaobjects in a
meta::ObjectSequenceare ordered according to the order of each Metaobject's first declaration in the translation unit.[Example:struct foo { typedef int t1; typedef float t2; t1 a, b, c; t2 d; }; using meta_foo = reflexpr(foo); using meta::get_base_name_v; using meta::get_element_m; using meta::get_data_members_m; using meta::get_member_types_m; get_base_name_v<get_element_m<get_member_types_m<meta_foo>, 0>> // "t1" get_base_name_v<get_element_m<get_member_types_m<meta_foo>, 1>> // "t2" get_base_name_v<get_element_m<get_data_members_m<meta_foo>, 0>> // "a" get_base_name_v<get_element_m<get_data_members_m<meta_foo>, 1>> // "b" get_base_name_v<get_element_m<get_data_members_m<meta_foo>, 2>> // "c" get_base_name_v<get_element_m<get_data_members_m<meta_foo>, 3>> // "d"— end example][Note: The name of
get_elementmay be shortened togetor unified with an equivalent operation on type-lists if they become part of the standard in the future. — end note]The
meta::ObjectSequencereturned bymeta::get_data_members,meta::get_public_data_members,meta::get_member_typesandmeta::get_public_member_typesdo not include Metaobjects reflecting inherited class members.[Example:struct foo { typedef int attr_t; attr_t a, b, c, d; }; struct bar : foo { float e, f; }; using meta_foo = reflexpr(foo); using meta_bar = reflexpr(bar); using meta::get_size_v; using meta::get_data_members_m; using meta::get_member_types_m; get_size_v<get_data_members_m<meta_foo>> // 4 get_size_v<get_data_members_m<meta_bar>> // 2 get_size_v<get_member_types_m<meta_foo>> // 1 get_size_v<get_member_types_m<meta_bar>> // 0— end example]The
meta::ObjectSequencereturned bymeta::get_data_membersandmeta::get_member_typescontain Metaobjects reflecting all class members including those which are not publicly accessible otherwise. Themeta::ObjectSequencereturned bymeta::get_public_data_membersandmeta::get_public_member_typescontain only the Metaobjects reflecting publicly accessible class members.[Example:Thestruct foo { private: typedef int _attr_t; _attr_t _a, _b, _c; public: typedef float value_type; typedef size_t size_type; value_type d; }; using meta_foo = reflexpr(foo); using meta::get_size_v; using meta::get_base_name_v; using meta::get_element_m; using meta::get_data_members_m; using meta::get_public_data_members_m; using meta::get_member_types_m; using meta::get_public_member_types_m; get_size_v<get_data_members_m<meta_foo>> // 4 get_size_v<get_public_data_members_m<meta_foo>> // 1 get_size_v<get_member_types_m<meta_foo>> // 3 get_size_v<get_public_member_types_m<meta_foo>> // 2 get_base_name_v<get_element_m<get_data_members_m<meta_foo>, 0>> // "_a" get_base_name_v<get_element_m<get_public_data_members_m<meta_foo>, 0>> // "d"— end example]unpack_sequenceoperation is applied to models ofmeta::ObjectSequence. It is equivalent to:namespace std { namespace experimental { namespace meta { template <ObjectSequence Seq, template <typename ...> class Tpl> struct unpack_sequence { typedef Tpl< get_element_m<Seq, 0>, get_element_m<Seq, 1>, ..., get_element_m<Seq, get_size_v<Seq>-1>, > type; }; template <ObjectSequence Seq, template <typename ...> class Tpl> using unpack_sequence_t = typename unpack_sequence<Seq, Tpl>::type; } // namespace meta } // namespace experimental } // namespace std[Example:struct foo { int a; bool b; char c; double d; }; template <meta::DataMember ... MDM> using helper = tuple<meta::get_reflected_type_t<MDM>...>; using X = meta::unpack_sequence_t< meta::get_data_members_m<reflexpr(foo)>, helper >; is_same_v<X, tuple<int, bool, char, double>> // true— end example]?.5.7.5 Specifier operations[refl.ops.spec]
[Note: There is a dual interface for retrieving specifier-related metadata. One is using the
meta::Specifierconcept and its operations which is more generic, and another using the boolean operations likemeta::is_static,meta::is_public, etc. which may be more convenient in simpler use-cases. — end note][Example:struct S { private: int i; public: float f; }; using meta_S = reflexpr(S); using meta_S_i = meta::get_element_m<meta::get_data_members_m<meta_S>, 0>; using meta_S_f = meta::get_element_m<meta::get_data_members_m<meta_S>, 1>; using meta::reflects_same_v; using meta::get_access_specifier_m; reflects_same_v<reflexpr(private),get_access_specifier_m<meta_S_i>> // true reflects_same_v<reflexpr(public), get_access_specifier_m<meta_S_i>> // false reflects_same_v<reflexpr(public), get_access_specifier_m<meta_S_f>> // true meta::is_private_v<meta_S_i> // true meta::is_public_v<meta_S_i> // false meta::is_public_v<meta_S_f> // true— end example]?.6 The reflection operator[refl.reflexpr]
The result of the invocation of the
reflexpris a type satisfyingmeta::Objectand othermetaconcepts, depending on the operand. The returned type is implementation-defined. Meta-operations on it describe the operand.The
reflexproperator takes an id-expression (5.1), or access-specifier (10) as operand, or nothing. The id-expression must be uniquely resolved through regular lookup, as if used outside of thereflexproperator. Otherwise, the expression is ill-formed.
- If no operand is passed to
reflexpror if the operand is "::", then the result will be satisfyingmeta::GlobalScope.- Otherwise, if the operand is a union-name, the result will be satisfying
meta::Record.- Otherwise, if the operand is a class-name, the result will be satisfying
meta::Class.- Otherwise, if the operand is a enum-name, the result will be satisfying
meta::Enum.- Otherwise, if the operand is a type-name, the result will be satisfying
meta::Type.- Otherwise, if the operand is a typedef-name, the result will be satisfying
meta::Typeandmeta::Alias.- Otherwise, if the operand is a namespace-name, the result will be satisfying
meta::Namespace.- Otherwise, if the operand is the name of a namespace-alias-declaration, the result will be satisfying
meta::Namespaceandmeta::Alias.- Otherwise, if the operand is a class-data-member-name, the result will be satisfying
meta::Variable.- Otherwise, if the operand is a variable-name, the result will be satisfying
meta::Variable.- Otherwise, if the operand is a enumerator-name, the result will be satisfying
meta::Constant.- Otherwise, if the operand is any of
static,virtual,enum,class,struct,union,public,protected,private, the result will be satisfyingmeta::Specifier.If the scope of the declaration of the id-expression is a class, a struct or a union then the result of
reflexpris also satisfyingmeta::RecordMember.If the scope of the declaration of the id-expression is an enum then the result of
reflexpris also satisfyingmeta::EnumMember.The invocation of
reflexpron all other kinds of id-expressions is ill-formed. The proposal will be extended in the future revisions to allow additional operands.[Example:reflexpr() // reflects the global namespace reflexpr(::) // reflects the global namespace reflexpr(std) // reflects the namespace reflexpr(int) // reflects the fundamental type reflexpr(std::size_t) // reflects the type alias reflexpr(std::launch) // reflects the enum type reflexpr(std::vector<int>) // reflects the class reflexpr(std::pair<int, int>::first_type) // reflects the member typedef reflexpr(std::pair<int, int>::first) // reflects the data member reflexpr(std::launch::async) // reflects the enumerator reflexpr(1) // ill-formed reflexpr(std::sin) // ill-formed reflexpr(std::vector) // ill-formed reflexpr(is_same_v<void,void>) // ill-formed— end example][Note:The expressions
reflexpr()andreflexpr(::)both reflect the global scope. It is possible that in the future only one of them will be chosen for this purpose. — end note]?.6.1 Redeclarations[refl.reflexpr.redecl]
The meta data queried by
reflexprdepends on the point of invocation of the operator; only declarations appearing in the translation unit before the invocation of thereflexproperator will be visible. Subsequent invocations are independent of prior invocations, as if all compiler generated types were unique to eachreflexprinvocation.[Example:using meta::get_size_v; using meta::get_data_members_m; struct foo; using meta_foo_fwd1 = reflexpr(foo); constexpr size_t n1 = get_size_v<get_data_members_m<meta_foo_fwd1>>; // 0 struct foo; using meta_foo_fwd2 = reflexpr(foo); constexpr size_t n2 = get_size_v<get_data_members_m<meta_foo_fwd2>>; // 0 using meta::reflects_same_v; constexpr bool b1 = is_same_v<meta_foo_fwd1, meta_foo_fwd2>; // unspecified constexpr bool b2 = reflects_same_v<meta_foo_fwd1, meta_foo_fwd2>; // true struct foo { int a,b,c,d; }; using meta_foo = reflexpr(foo); constexpr size_t n3 = get_size_v<get_data_members_m<meta_foo>>; // 4 constexpr bool b3 = is_same_v<meta_foo_fwd1, meta_foo>; // false constexpr bool b4 = reflects_same_v<meta_foo_fwd1, meta_foo>; // true— end example][Note: In order to distinguish the reflections of incomplete forward declarations of types a new concept like
meta::IncompleteTypeormeta::ForwardDeclaratedor a new operation likemeta::is_forward_declaredwill be added in a future revision. — end note]
Describes the method of static reflection by the means of compiler-generated anonymous types. Introduces the first version of the metaobject concepts and some possiblities of their implementation. Also includes discussion about the motivation and the design rationale for the proposal.
Refines the metaobject concepts and introduces a concrete implementation of their interface by the means of templates similar to the standard type traits. Describes some additions to the standard library (mostly meta-programming utilities), which simplify the use of the metaobjects. Answers some questions from the discussion about N3996 and expands the design rationale.
Incorporates the feedback from the discussion about N4111 at the Urbana meeting, most notably reduces the set of metaobject concepts and refines their definitions, removes some of the additions to the standard library added in the previous revisions. Adds context-dependent reflection.
Further refines the concepts from N4111; prefixes
the names of the metaobject operations with get_, adds new operations,
replaces the metaobject category tags with new metaobject traits.
Introduces a nested namespace std::meta which contains most
of the reflection-related additions to the standard library.
Rephrases definition of meta objects using Concepts Lite. Specifies the
reflection operator name — reflexpr.
Introduces an experimental implementation of the reflection operator in clang.
Drops the context-dependent reflection from N4111 (will be re-introduced later).
Dropped all metaobject traits except is_metaobject. All metaobject
classification is now done by using the concepts. We assume that the following
syntax of the Concepts specification is implemented:
template <T>
constexpr bool Concept = unspecified;
and also assuming that the Concepts TS Issue 29 is resolved and that
Concept<T> is a generally usable boolean expression,
so that the following is valid code:
static_assert(Concept<T>, " ... ");
using U = std::conditional_t<Concept<T>, T1, T2>;
if(Concept<T>) { /* ... */ }
The meta::Scoped concept has been renamed to meta::ScopeMember.
The meta::Constant and meta::Specifier concepts,
and several new operations have been added.
The aliases for the operation templates returning metaobjects had previously
the _t suffix; this has been changed to the _m suffix. For example:
get_type_t -> get_type_m
get_scope_t -> get_scope_m
get_aliased_t -> get_aliased_m
get_data_members_t -> get_data_members_m
The following concepts from P0194R1 were dropped in order to simplify
the proposal:
meta::Linkable, meta::Enumerator,
meta::DataMember, meta::MemberType,
meta::EnumClass, meta::TypeAlias and
meta::NamespaceAlias.
The following concepts were added to the proposal:
meta::TagType, meta::Record,
meta::EnumMember.
Unlike in the previous proposal, metaobjects reflecting anonymous entities -
the global scope, anonymous namespaces and classes, etc. do conform to the
meta::Named concept and implement the name-returning operations.
Unlike in the previous proposal, metaobjects reflecting the global scope
do conform to the meta::ScopeMember concept and the
meta::get_scope operation. For arguments reflecting
the global scope returns a metaobject reflecting the global scope
(i.e. the global scope is its own scope).
Metaobjects reflecting built-in types and types like pointers, references,
arrays, etc. now don't have a scope (i.e. they do not conform to the
meta::ScopeMember concept).
We have added a different mechanism for distinguishing between
non-scoped and scoped enums - the meta::is_scoped_enum
operation. Unlike in the previous proposal meta::Enum reflecting
a non-scoped enum is a meta::Scope.
We now allow the default construction and copy construction of values of metaobject types.
Direct reflection of class data members, member types and type aliases, enumerators and global scope/namespace-level variables has been added. For example:
enum class E { a, b, c, d};
using ME_a = reflexpr(E::a); // valid
struct S { using T = int; T a; };
using MS_T = reflexpr(S::T); // valid
using MS_a = reflexpr(S::a); // valid
The typedef (type-alias) reflection has been simplified based on the feedback from Oulu. Previously we required reflection to be aware about all aliases in a "chain" even in the context of templates. For example:
using A = int;
using B = A;
using C = B;
template <typename T>
struct S
{
using X = T;
};
using Mint = reflexpr(int);
using MA = reflexpr(A);
using MB = reflexpr(B);
using MC = reflexpr(C);
using MSintX = reflexpr(S<int>::X);
using MSAX = reflexpr(S<A>::X);
using MSBX = reflexpr(S<B>::X);
using MSCX = reflexpr(S<C>::X);
In the previous proposals we required the following (i.e. that reflection
should be aware of the whole "chain" of aliases -
S<C>::X -> C -> B -> A -> int):
static_assert(meta::reflects_same_v<meta::get_aliased_m<MSCX>, MC>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<MSBX>, MB>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<MSAX>, MA>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<meta::get_aliased_m<MSCX>>, MB>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<meta::get_aliased_m<meta::get_aliased_m<MSCX>>>, MA>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<MC>, MB>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<MB>, MA>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<MA>, Mint>, "");
Now we require only that the type alias knows the "canonical" type
which it refers to - the type which has a unique identity at the base level (i.e.
S<C>::X -> int, C -> int, B -> int,
A -> int):
static_assert(meta::Alias<MSCX>, "");
static_assert(meta::Alias<MSBX>, "");
static_assert(meta::Alias<MSAX>, "");
static_assert(meta::Alias<MC>, "");
static_assert(meta::Alias<MB>, "");
static_assert(meta::Alias<MA>, "");
static_assert(!meta::Alias<Mint>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<MSCX>, Mint>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<MSBX>, Mint>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<MSAX>, Mint>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<MC>, Mint>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<MB>, Mint>, "");
static_assert(meta::reflects_same_v<meta::get_aliased_m<MA>, Mint>, "");
The mechanism for enumerating public-only vs. all (including non-public ones)
class members has been changed. Now the "basic" operations like
meta::get_data_members, meta::get_member_types, etc.
return all members, and the meta::get_public_data_members,
meta::get_public_member_types, return only the public class members.
Thanks to Ricardo Fabiano de Andrade, Roland Bock and Klaim - Joël Lamotte who provided valuable feedback, criticism and suggestions.
| [P0194R1] | Chochlík M., Naumann A. — P0194R1 - Static reflection (revision 5) |
|---|---|
| [P0194R0] | Chochlík M., Naumann A. — P0194R0 - Static reflection (revision 4) |
| [N4451] | Chochlík M. — N4451 - Static reflection (revision 3) |
| [N4111] | Chochlík M. — N4111 - Static reflection (revision 2) |
| [N3996] | Chochlík M. — N3996 - Static reflection |
| [P0385R0] | Chochlík M., Naumann A. — P0385R0 - Static reflection - Rationale, design and evolution |
| [P0385R1] | Chochlík M., Naumann A. — P0385R1 - Static reflection - Rationale, design and evolution |