text: [/
      Copyright 2010 Neil Groves
      Distributed under the Boost Software License, Version 1.0.
      (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
  /]
  [def __mfc_collections__ [@http://msdn.microsoft.com/en-us/library/942860sh.aspx MFC Collection Classes]]
  [def __atl_collections__ [@http://msdn.microsoft.com/en-us/library/15e672bd.aspx ATL Collection Classes]]
  
  [section:mfc_atl MFC/ATL (courtesy of Shunsuke Sogame)]
  
  [h4 Introduction]
  This implementation was kindly donated by Shunsuke Sogame. This header adapts MFC and ATL containers to the appropriate Range concepts.
  
  [table
      []
      [[[*Author:]]    [Shunsuke Sogame]]
      [[[*Contact:]]   [mb2act@yahoo.co.jp]]
      [[[*Date:]]      [26th of May 2006]]
      [[[*Copyright:]] [Shunsuke Sogame 2005-2006. Use, modification and distribution is subject to the Boost Software License, Version 1.0]]
  ]
  
  [h4 Overview]
  
  Boost.Range MFC/ATL Extension provides Boost.Range support for MFC/ATL collection and string types.
  
  ``
  CTypedPtrArray<CPtrArray, CList<CString> *> myArray;
  ...
  BOOST_FOREACH (CList<CString> *theList, myArray)
  {
      BOOST_FOREACH (CString& str, *theList)
      {
          boost::to_upper(str);
          std::sort(boost::begin(str), boost::end(str));
          ...
      }
  }
  ``
  
  [section:requirements Requirements]
  
  * Boost C++ Libraries Version 1.34.0 or later (no compilation required)
  * Visual C++ 7.1 or later (for MFC and ATL)
  
  [endsect]
  
  [section:mfc_ranges MFC Ranges]
  If the `<boost/range/mfc.hpp>` 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.
  
  [table
      [[Range] [Traversal Category] [`range_reference<Range>::type`]]
      [[`CArray<T,A>`]           [__random_access_range__]   [`T&`]]
      [[`CList<T,A>`]            [__bidirectional_range__]   [`T&`]]
      [[`CMap<K,AK,M,AM>`]       [__forward_range__]         [`Range::CPair&`]]
      [[`CTypedPtrArray<B,T*>`]  [__random_access_range__]   [`T* const`]]
      [[`CTypedPtrList<B,T*>`]   [__bidirectional_range__]   [`T* const`]]
      [[`CTypedPtrMap<B,T*,V*>`] [__forward_range__]         [`std::pair<T*,V*> const`]]
      [[`CByteArray`]            [__random_access_range__]   [`BYTE&`]]
      [[`CDWordArray`]           [__random_access_range__]   [`DWORD&`]]
      [[`CObArray`]              [__random_access_range__]   [`CObject*&`]]
      [[`CPtrArray`]             [__random_access_range__]   [`void*&`]]
      [[`CStringArray`]          [__random_access_range__]   [`CString&`]]
      [[`CUIntArray`]            [__random_access_range__]   [`UINT&`]]
      [[`CWordArray`]            [__random_access_range__]   [`WORD&`]]
      [[`CObList`]               [__bidirectional_range__]   [`CObject*&`]]
      [[`CPtrList`]              [__bidirectional_range__]   [`void*&`]]
      [[`CStringList`]           [__bidirectional_range__]   [`CString&`]]
      [[`CMapPtrToWord`]         [__forward_range__]         [`std::pair<void*,WORD> const`]]
      [[`CMapPtrToPtr`]          [__forward_range__]         [`std::pair<void*,void*> const`]]
      [[`CMapStringToOb`]        [__forward_range__]         [`std::pair<String,CObject*> const`]]
      [[`CMapStringToString`]    [__forward_range__]         [`Range::CPair&`]]
      [[`CMapWordToOb`]          [__forward_range__]         [`std::pair<WORD,CObject*> const`]]
      [[`CMapWordToPtr`]         [__forward_range__]         [`std::pair<WORD,void*> const`]]
  ]
  
  Other Boost.Range metafunctions are defined by the following. Let `Range` be any type listed above and `Ref` be the same as `range_reference<Range>::type`. `range_value<Range>::type` is the same as `remove_reference<remove_const<Ref>::type>::type`, `range_difference<Range>::type` is the same as `std::ptrdiff_t`, and `range_pointer<Range>::type` is the same as `add_pointer<remove_reference<Ref>::type>::type`. As for `const Range`, see below.
  
  Adam Walling has provided the header `<boost/range/mfc_map.hpp>` to add support
  for the map adaptor with MFC map types.
  
  [endsect]
  
  [section:atl_ranges ATL Ranges]
  
  If the `<boost/range/atl.hpp>` 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.
  
  [table
      [[Range]                    [Traversal Category]      [`range_reference<Range>::type`]]
      [[`CAtlArray<E,ET>`]        [__random_access_range__] [`E&`]]
      [[`CAutoPtrArray<E>`]       [__random_access_range__] [`E&`]]
      [[`CInterfaceArray<I,pi>`]  [__random_access_range__] [`CComQIPtr<I,pi>&`]]
      [[`CAtlList<E,ET>`]         [__bidirectional_range__] [`E&`]]
      [[`CAutoPtrList<E>`]        [__bidirectional_range__] [`E&`]]
      [[`CHeapPtrList<E,A>`]      [__bidirectional_range__] [`E&`]]
      [[`CInterfaceList<I,pi>`]   [__bidirectional_range__] [`CComQIPtr<I,pi>&`]]
      [[`CAtlMap<K,V,KT,VT>`]     [__forward_range__]       [`Range::CPair&`]]
      [[`CRBTree<K,V,KT,VT>`]     [__bidirectional_range__] [`Range::CPair&`]]
      [[`CRBMap<K,V,KT,VT>`]      [__bidirectional_range__] [`Range::CPair&`]]
      [[`CRBMultiMap<K,V,KT,VT>`] [__bidirectional_range__] [`Range::CPair&`]]
      [[`CSimpleStringT<B,b>`]    [__random_access_range__] [`B&`]]
      [[`CStringT<B,ST>`]         [__random_access_range__] [`B&`]]
      [[`CFixedStringT<S,n>`]     [__random_access_range__] [`range_reference<S>::type`]]
      [[`CComBSTR`]               [__random_access_range__] [`OLECHAR&`]]
      [[`CSimpleArray<T,TE>`]     [__random_access_range__] [`T&`]]
  ]
  
  Other __boost_range_home__ metafunctions are defined by the following. Let `Range` be any type listed above and `Ref` be the same as `range_reference<Range>::type`. `range_value<Range>::type` is the same as `remove_reference<Ref>::type`, `range_difference<Range>::type` is the same as `std::ptrdiff_t`, and `range_pointer<Range>::type` is the same as `add_pointer<remove_reference<Ref>::type>::type`. As for `const Range`, see below.
  
  [endsect]
  
  [section:const_ranges const Ranges]
  
  `range_reference<const Range>::type` is defined by the following algorithm. Let `Range` be any type listed above and `Ref` be the same as `range_reference<Range>::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.
  
  [table
      [[Range metafunction]                    [Result]]
      [[`range_value<const Range>::type`]      [`range_value<Range>::type`]]
      [[`range_difference<const Range>::type`] [`std::ptrdiff_t`]]
      [[`range_pointer<const Range>::type`]    [`add_pointer<remove_reference<range_reference<const Range>::type>::type>::type`]]
  ]
  
  [endsect]
  
  [section:references References]
  
  # __boost_range_home__
  # __mfc_collections__
  # __atl_collections__
  
  [endsect]
  
  [endsect]
  