Chris@16: // Boost.Range library
Chris@16: //
Chris@16: //  Copyright Thorsten Ottosen 2003-2004. Use, modification and
Chris@16: //  distribution is subject to the Boost Software License, Version
Chris@16: //  1.0. (See accompanying file LICENSE_1_0.txt or copy at
Chris@16: //  http://www.boost.org/LICENSE_1_0.txt)
Chris@16: //
Chris@16: // For more information, see http://www.boost.org/libs/range/
Chris@16: //
Chris@16: 
Chris@16: #ifndef BOOST_RANGE_BEGIN_HPP
Chris@16: #define BOOST_RANGE_BEGIN_HPP
Chris@16: 
Chris@101: #if defined(_MSC_VER)
Chris@16: # pragma once
Chris@16: #endif
Chris@16: 
Chris@16: #include <boost/range/config.hpp>
Chris@16: 
Chris@16: #ifdef BOOST_NO_FUNCTION_TEMPLATE_ORDERING
Chris@16: #include <boost/range/detail/begin.hpp>
Chris@16: #else
Chris@16: 
Chris@16: #include <boost/range/iterator.hpp>
Chris@16: 
Chris@16: namespace boost
Chris@16: {
Chris@16: 
Chris@101: #if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))
Chris@16: namespace range_detail
Chris@16: {
Chris@16: #endif
Chris@16: 
Chris@16:     //////////////////////////////////////////////////////////////////////
Chris@16:     // primary template
Chris@16:     //////////////////////////////////////////////////////////////////////
Chris@16: 
Chris@16:     template< typename C >
Chris@16:     inline BOOST_DEDUCED_TYPENAME range_iterator<C>::type
Chris@16:     range_begin( C& c )
Chris@16:     {
Chris@16:         //
Chris@16:         // If you get a compile-error here, it is most likely because
Chris@16:         // you have not implemented range_begin() properly in
Chris@16:         // the namespace of C
Chris@16:         //
Chris@16:         return c.begin();
Chris@16:     }
Chris@16: 
Chris@16:     //////////////////////////////////////////////////////////////////////
Chris@16:     // pair
Chris@16:     //////////////////////////////////////////////////////////////////////
Chris@16: 
Chris@16:     template< typename Iterator >
Chris@16:     inline Iterator range_begin( const std::pair<Iterator,Iterator>& p )
Chris@16:     {
Chris@16:         return p.first;
Chris@16:     }
Chris@16: 
Chris@16:     template< typename Iterator >
Chris@16:     inline Iterator range_begin( std::pair<Iterator,Iterator>& p )
Chris@16:     {
Chris@16:         return p.first;
Chris@16:     }
Chris@16: 
Chris@16:     //////////////////////////////////////////////////////////////////////
Chris@16:     // array
Chris@16:     //////////////////////////////////////////////////////////////////////
Chris@16: 
Chris@16:     //
Chris@16:     // May this be discarded? Or is it needed for bad compilers?
Chris@16:     //
Chris@16:     template< typename T, std::size_t sz >
Chris@16:     inline const T* range_begin( const T (&a)[sz] )
Chris@16:     {
Chris@16:         return a;
Chris@16:     }
Chris@16: 
Chris@16:     template< typename T, std::size_t sz >
Chris@16:     inline T* range_begin( T (&a)[sz] )
Chris@16:     {
Chris@16:         return a;
Chris@16:     }
Chris@16: 
Chris@16: 
Chris@101: #if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))
Chris@16: } // namespace 'range_detail'
Chris@16: #endif
Chris@16: 
Chris@16: // Use a ADL namespace barrier to avoid ambiguity with other unqualified
Chris@16: // calls. This is particularly important with C++0x encouraging
Chris@16: // unqualified calls to begin/end.
Chris@16: namespace range_adl_barrier
Chris@16: {
Chris@16: 
Chris@16: template< class T >
Chris@16: inline BOOST_DEDUCED_TYPENAME range_iterator<T>::type begin( T& r )
Chris@16: {
Chris@101: #if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))
Chris@16:     using namespace range_detail;
Chris@16: #endif
Chris@16:     return range_begin( r );
Chris@16: }
Chris@16: 
Chris@16: template< class T >
Chris@16: inline BOOST_DEDUCED_TYPENAME range_iterator<const T>::type begin( const T& r )
Chris@16: {
Chris@101: #if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))
Chris@16:     using namespace range_detail;
Chris@16: #endif
Chris@16:     return range_begin( r );
Chris@16: }
Chris@16: 
Chris@16:     } // namespace range_adl_barrier
Chris@16: } // namespace boost
Chris@16: 
Chris@16: #endif // BOOST_NO_FUNCTION_TEMPLATE_ORDERING
Chris@16: 
Chris@16: namespace boost
Chris@16: {
Chris@16:     namespace range_adl_barrier
Chris@16:     {
Chris@16:         template< class T >
Chris@16:         inline BOOST_DEDUCED_TYPENAME range_iterator<const T>::type
Chris@16:         const_begin( const T& r )
Chris@16:         {
Chris@16:             return boost::range_adl_barrier::begin( r );
Chris@16:         }
Chris@16:     } // namespace range_adl_barrier
Chris@16: 
Chris@16:     using namespace range_adl_barrier;
Chris@16: } // namespace boost
Chris@16: 
Chris@16: #endif
Chris@16: