...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
Copyright © 2011-2013 Tropic Software East Inc
Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
Table of Contents
Welcome to the Boost Type Traits Introspection library, abbreviated TTI.
TTI is a library which provides the ability to introspect by name the elements of a type at compile time.
TTI works through macros generating metafunctions. Metafunctions are class templates of a particular syntax, having a nested 'type' member. So wherever in C++ class templates can occur, TTI macros can be used. The metafunctions generated by TTI are no different from any other metafunction as defined by the Boost MPL library.
The metafunctions generated by TTI are used to introspect elements of a type at compile time, always passing at minimum to each metafunction the enclosing type being introspected.
The name of the library has been chosen because the library offers compile time functionality on a type, similar to the Boost Type Traits library, and because the functionality the library offers is the ability to introspect a type about the existence of a specific element within that type.
I use the word "introspect" in a very broad sense here. Normally computer language introspection means initially asking for information to be returned by name, which can then further be used to introspect for more specific information. In the TTI library one must always know and supply the name, and use the functionality provided for the correct type of inner element to find out if that particular named entity exists.
You may prefer the term "query" instead of "introspection" to denote what this library does, but I use terminology based on the word "introspect" throughout this documentation.
The functionality of the library may be summed up as:
The library is dependent on Boost PP, Boost MPL, Boost Type Traits, and Boost Function Types.
The library is also dependent on the variadic macro support of the Boost PP library if the variadic macros in the library are used.
The library is a header only library.
Since the dependencies of the library are all header only libraries, there is no need to build a library in order to use the TTI library.
There is a single header file, boost/tti/tti.hpp
,
which includes all the header files in the library.
There are also separate specific header files for each of the elements to be introspected by the library. This allows for finer-grained inclusion of the nested elements to be introspected. These header files are:
Table 1.1. TTI Header Files
Introspected Element |
Specific Header File |
---|---|
Type |
|
Class/Struct |
|
Enumeration |
|
Union |
|
Class Template |
|
Member data |
|
Member function |
|
Member function template |
|
Static member data |
|
Static member function |
|
Static member function template |
|
Data |
|
Function |
|
Function template |
|
Member Type Creation |
Last revised: April 22, 2020 at 13:38:06 GMT |