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

PrevUpHomeNext

Function template extract_or_default

boost::log::extract_or_default

Synopsis

// In header: <boost/log/attributes/value_extraction.hpp>


template<typename T, typename TagT = void, typename DefaultT> 
  result_of::extract_or_default< T, DefaultT, TagT >::type 
  extract_or_default(attribute_name const & name, 
                     attribute_value_set const & attrs, 
                     DefaultT const & def_val);

Description

The function extracts an attribute value from the view. The user has to explicitly specify the type or set of possible types of the attribute value to be extracted.

[Note] Note

Caution must be exercised if the default value is a temporary object. Because the function returns a reference, if the temporary object is destroyed, the reference may become dangling.

Parameters:

name

The name of the attribute value to extract.

attrs

A set of attribute values in which to look for the specified attribute value.

def_val

The default value

Returns:

The extracted value, if found. The default value otherwise.


PrevUpHomeNext