Overview

Boost.Range MFC/ATL Extension provides Boost.Range support for MFC/ATL collection and string types.

CTypedPtrArray *> myArray;
...
BOOST_FOREACH (CList *theList, myArray)
{
    BOOST_FOREACH (CString& str, *theList)
    {
        boost::to_upper(str);
        std::sort(boost::begin(str), boost::end(str));
        ...
    }
}

• Requirements
• MFC Ranges
• ATL Ranges
• const Ranges
• References

Requirements

• Boost C++ Libraries Version 1.34.0 or later (no compilation required)
• Visual C++ 7.1 or Visual C++ 8.0

MFC Ranges

If the is included before or after Boost.Range headers, the MFC collections and strings become models of Range. The table below lists the Traversal Category and range_reference of MFC ranges.

Other Boost.Range metafunctions are defined by the following. Let Range be any type listed above and ReF be the same as range_reference::type. range_value::type is the same as remove_reference::type>::type, range_difference::type is the same as std::ptrdiff_t, and range_pointer::type is the same as add_pointer::type>::type. As for const Range, see const Ranges.

ATL Ranges

If the is included before or after Boost.Range headers, the ATL collections and strings become models of Range. The table below lists the Traversal Category and range_reference of ATL ranges.

Other Boost.Range metafunctions are defined by the following. Let Range be any type listed above and ReF be the same as range_reference::type. range_value::type is the same as remove_reference::type, range_difference::type is the same as std::ptrdiff_t, and range_pointer::type is the same as add_pointer::type>::type. As for const Range, see const Ranges.

const Ranges

range_reference Range>::type is defined by the following algorithm. Let Range be any type listed above and ReF be the same as range_reference::type.

if (Range is CObArray || Range is CObList)
    return CObject const * &
else if (Range is CPtrArray || Range is CPtrList)
    return void const * &
else if (there is a type X such that X& is the same as ReF)
    return X const &
else if (there is a type X such that X* const is the same as ReF)
    return X const * const
else
    return ReF

Other Boost.Range metafunctions are defined by the following. range_value Range>::type is the same as range_value::type, range_difference Range>::type is the same as std::ptrdiff_t, and range_pointer Range>::type is the same as add_pointer Range>::type>::type>::type.

References

• Boost.Range
• MFC Collections
• ATL Collection Classes