Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext

Struct template fold_tree

boost::proto::fold_tree — A PrimitiveTransform that recursively applies the proto::fold<> transform to sub-trees that all share a common tag type.

Synopsis

// In header: <boost/proto/transform/fold_tree.hpp>

template<typename Sequence, typename State0, typename Fun> 
struct fold_tree :  proto::transform<  {
  // member classes/structs/unions
  template<typename Expr, typename State, typename Data> 
  struct impl :  
    proto::fold<
  {
  };
};

Description

proto::fold_tree<> is useful for flattening trees into lists; for example, you might use proto::fold_tree<> to flatten an expression tree like a | b | c into a Fusion list like cons(c, cons(b, cons(a))).

proto::fold_tree<> is easily understood in terms of a recurse_if_<> helper, defined as follows:

 proto::if_<
    // If the current node has type type "Tag" ...
    proto::tag_of<proto::_>, proto::fold<proto::_, proto::_state, 

With recurse_if_<> as defined above, proto::fold_tree<Sequence, State0, Fun>()(expr, state, data) is equivalent to:

proto::fold<
  

It has the effect of folding a tree front-to-back, recursing into child nodes that share a tag type with the parent node.


PrevUpHomeNext