boost.pfr

C++14 Magic get library.


Keywords
boost, clang, cplusplus, cplusplus-14, cpp, cpp14, cpp17, gcc, magic, reflection, reflection-library, reflections, std, tuple, tuples, visual-studio
License
BSL-1.0
Install
Install-Package boost.pfr -Version 1.0.0

Documentation

Precise and Flat Reflection (ex Magic Get, ex PODs Flat Reflection)

This C++14 library is meant for accessing structure elements by index and providing other std::tuple like methods for user defined types.

Latest documentation

Pre Boost version

Test results

Branches Build Tests coverage More info
Develop: Build Status Coverage Status
Master: Build Status Coverage Status

Motivating example

#include <iostream>
#include "boost/pfr.hpp"

struct my_struct { // no ostream operator defined!
    int i;
    char c;
    double d;
};

int main() {
    using namespace boost::pfr::ops; // out-of-the-box ostream operator for all PODs!

    my_struct s{100, 'H', 3.141593};
    std::cout << "my_struct has " << boost::pfr::tuple_size<my_struct>::value
        << " fields: " << s << "\n";
}

Outputs:

my_struct has 3 fields: {100, H, 3.14159}

Requirements and Limitations

  • C++14 compatible compiler (GCC-5.0+, Clang, ...)
  • Static variables are ignored

C++14 limitations (C++17 fixes those):

  • T must be constexpr aggregate initializable and must not contain references nor bitfields

License

Distributed under the Boost Software License, Version 1.0.