The BOOST_PP_SEQ_FOLD_LEFT macro folds (or accumulates) the elements of a seq left-to-right.

Usage

BOOST_PP_SEQ_FOLD_LEFT(op, state, seq)

Arguments

op
A ternary operation of the form op(s, state, elem).  This macro is called for each element in seq--each time returning a new state.  This operation is expanded by BOOST_PP_SEQ_FOLD_LEFT with the next available fold step, the current state, and the current element.
state
The initial state of the fold.
seq
The seq to be folded.

Remarks

For the seq, (0)(1)(2), this macro expands to:
op(s, op(s, op(s, state, 0), 1), 2)
For maximum efficiency, BOOST_PP_SEQ_FOLD_LEFT can be reentered with BOOST_PP_SEQ_FOLD_LEFT_s.

See Also

Requirements

Header:  <boost/preprocessor/seq/fold_left.hpp>

Sample Code

#include <boost/preprocessor/cat.hpp>
#include <boost/preprocessor/seq/fold_left.hpp>

#define SEQ (b)(o)(o)(s)(t)

#define OP(s, state, x) BOOST_PP_CAT(state, x)

BOOST_PP_SEQ_FOLD_LEFT(OP, BOOST_PP_SEQ_HEAD(SEQ), BOOST_PP_SEQ_TAIL(SEQ)) // expands to boost

© Copyright Housemarque Oy 2002
© Copyright Paul Mensonides 2002

Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at www.boost.org/LICENSE_1_0.txt)