Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for a snapshot of the master branch, built from commit 5a839fb07a.
PrevUpHomeNext

Short Examples for the Impatient

Code snippet

Reference:

// Get field by index/type and assign new value to that field

struct sample {
    char c;
    float f;
};

sample var{};
boost::pfr::get<1>(var) = 42.01f;
boost::pfr::get<char>(var) = 'A';

std::cout << var.c << var.f; // Outputs: A 42.01

boost::pfr::get

// Get name of field by index

struct sample {
    int f_int;
    long f_long;
};

std::cout << boost::pfr::get_name<0, sample>()
          << boost::pfr::get_name<1, sample>(); // Outputs: f_int f_long

boost::pfr::get_name

// Assert equality.
// Note that the equality operator for structure is not defined.

struct test {
    std::string f1;
    std::string_view f2;
};

assert(
    boost::pfr::eq(test{"aaa", "zomg"}, test{"aaa", "zomg"})
);

Header boost/pfr/ops.hpp:

* boost::pfr::eq

* boost::pfr::ne

* boost::pfr::gt

* ...

// Increment each field of the variable on 1 and
// output the content of the variable.

struct test {
    int f1;
    long f2;
};

test var{42, 43};

boost::pfr::for_each_field(var, [](auto& field) {
    field += 1;
});

// Outputs: {43, 44}
std::cout << boost::pfr::io(var);

boost::pfr::for_each_field

boost::pfr::io

// Print the name and value
// of each element of the structure

struct test {
    int n;
    std::string str;
};

test var{42, "Hello, World!"};

// Outputs:
//  n: 42
//  str: Hello, World!
boost::pfr::for_each_field_with_name(var,
  [](std::string_view name, const auto& value) {
    std::cout << name << ": " << value << std::endl;
});

boost::pfr::for_each_field_with_name

// Define all the comparison and IO operators for my_structure type along
// with hash_value function.

#include <boost/pfr/functions_for.hpp>

namespace my_namespace {
    struct my_structure {
        int a,b,c,d,e,f,g;
        // ...
    };
    BOOST_PFR_FUNCTIONS_FOR(my_structure)
}

BOOST_PFR_FUNCTIONS_FOR

// Define only the equality and inequality operators for my_eq_ne_structure.

#include <boost/pfr/functions_for.hpp>

namespace my_namespace {
    struct my_eq_ne_structure {
        float a,b,c,d,e,f,g;
        // ...
    };

    inline bool operator==(const my_eq_ne_structure& x, const my_eq_ne_structure& y) {
        return boost::pfr::eq_fields(x, y);
    }

    inline bool operator!=(const my_eq_ne_structure& x, const my_eq_ne_structure& y) {
        return boost::pfr::ne_fields(x, y);
    }
}

Header boost/pfr/ops_fields.hpp :

* boost::pfr::eq_fields

* boost::pfr::ne_fields

* boost::pfr::gt_fields

* ...

Header boost/pfr/io_fields.hpp

* boost::pfr::io_fields

// Iterate over fields of a variable and output index and
// type of a variable.

struct tag0{};
struct tag1{};
struct sample {
    tag0 a;
    tag1 b;
};

// Outputs:
//  0: tag0
//  1: tag1
boost::pfr::for_each_field(sample{}, [](const auto& field, std::size_t idx) {
    std::cout << '\n' << idx << ": "
        << boost::typeindex::type_id_runtime(field);
});

boost::pfr::for_each_field

// Getting fields count of some structure

struct some { int a,b,c,d,e; };

std::cout << "Fields count in structure: "
    << boost::pfr::tuple_size<some>::value  // Outputs: 5
    << '\n';

boost::pfr::tuple_size

// Getting a std::tuple of values from structures fields

struct foo { int a, b; };
struct other {
    char c;
    foo nested;
};

other var{'A', {3, 4}};
std::tuple<char, foo> t = boost::pfr::structure_to_tuple(var);
assert(std::get<0>(t) == 'A');
assert(
    boost::pfr::eq(std::get<1>(t), foo{3, 4})
);

boost::pfr::structure_to_tuple

// Getting a std::tuple of references to structure fields

struct foo { int a, b; };
struct other {
    char c;
    foo f;
};

other var{'A', {14, 15}};
std::tuple<char&, foo&> t = boost::pfr::structure_tie(var);
std::get<1>(t) = foo{1, 2};

std::cout << boost::pfr::io(var.f); // Outputs: {1, 2}

boost::pfr::structure_tie


PrevUpHomeNext