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 develop branch, built from commit d7c8a7cf0d.
PrevUpHomeNext

Macro BOOST_TTI_TRAIT_HAS_ENUM

BOOST_TTI_TRAIT_HAS_ENUM — A macro which expands to a metafunction which tests whether an inner enum with a particular name exists.

Synopsis

// In header: <boost/tti/has_enum.hpp>

BOOST_TTI_TRAIT_HAS_ENUM(trait, name)

Description

BOOST_TTI_TRAIT_HAS_ENUM is a macro which expands to a metafunction. The metafunction tests whether an inner enum with a particular name exists and, optionally, whether an MPL lambda expression invoked with the inner enum is true or not. The macro takes the form of BOOST_TTI_TRAIT_HAS_ENUM(trait,name) where

trait = the name of the metafunction
name = the name of the inner enum. The name can be that of an enum or, in C++11 on up, an enum class.

BOOST_TTI_TRAIT_HAS_ENUM generates a metafunction called "trait" where 'trait' is the macro parameter.

template<class BOOST_TTI_TP_T,class BOOST_TTI_TP_U>
struct trait
  {
  static const value = unspecified;
  typedef mpl::bool_<true-or-false> type;
  };

The metafunction types and return:

  BOOST_TTI_TP_T = the enclosing type in which to look for our 'name'.
                   The enclosing type can be a class, struct, or union.
  
  BOOST_TTI_TP_U = (optional) An optional template parameter, defaulting to a marker type.
                     If specified it is an MPL lambda expression which is invoked 
                     with the inner enum found and must return a constant boolean 
                     value.
                     
  returns = 'value' depends on whether or not the optional BOOST_TTI_TP_U is specified.
  
            If BOOST_TTI_TP_U is not specified, then 'value' is true if the 'name' enum
            exists within the enclosing type BOOST_TTI_TP_T; otherwise 'value' is false.
            
            If BOOST_TTI_TP_U is specified , then 'value' is true if the 'name' enum exists 
            within the enclosing type BOOST_TTI_TP_T and the MPL lambda expression as specified 
            by BOOST_TTI_TP_U, invoked by passing the actual inner enum of 'name', returns 
            a 'value' of true; otherwise 'value' is false.
               
            The action taken with BOOST_TTI_TP_U occurs only when the 'name' enum exists 
            within the enclosing type BOOST_TTI_TP_T.

Example usage:

BOOST_TTI_TRAIT_HAS_ENUM(LookFor,MyType) generates the metafunction LookFor in the current scope
to look for an inner enum called MyType.

LookFor<EnclosingType>::value is true if MyType is an inner enum of EnclosingType, otherwise false.

LookFor<EnclosingType,ALambdaExpression>::value is true if MyType is an inner enum of EnclosingType
  and invoking ALambdaExpression with the inner enum returns a value of true, otherwise false.
  
A popular use of the optional MPL lambda expression is to check whether the enum found is the same  
as another type, when the enum found is a typedef. In that case our example would be:

LookFor<EnclosingType,boost::is_same<_,SomeOtherType> >::value is true if MyType is an inner enum
  of EnclosingType and is the same type as SomeOtherType.


PrevUpHomeNext