// Boost.Range library

//

//  Copyright Thorsten Ottosen 2003-2004. Use, modification and

//  distribution is subject to 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)

//

// For more information, see http://www.boost.org/libs/range/

//

#ifndef BOOST_RANGE_BEGIN_HPP

#define BOOST_RANGE_BEGIN_HPP

#if defined(_MSC_VER) && (_MSC_VER >= 1200)

# pragma once

#endif

#include <boost/type_traits/remove_const.hpp>

#include <boost/range/config.hpp>

#ifdef BOOST_NO_FUNCTION_TEMPLATE_ORDERING

#include <boost/range/detail/begin.hpp>

#else

#include <boost/range/iterator.hpp>

#include <boost/range/const_iterator.hpp>

namespace boost

{

#if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564)) && \

    !BOOST_WORKAROUND(__GNUC__, < 3) \

    /**/

namespace range_detail

{

#endif

    //////////////////////////////////////////////////////////////////////

    // primary template

    //////////////////////////////////////////////////////////////////////

    template< typename C >

    inline BOOST_DEDUCED_TYPENAME range_const_iterator<C>::type

    boost_range_begin( const C& c )

    {

        return c.begin();

    }

    template< typename C >

    inline BOOST_DEDUCED_TYPENAME range_iterator<

                                                                        typename remove_const<C>::type >::type

    boost_range_begin( C& c )

    {

        return c.begin();

    }

    //////////////////////////////////////////////////////////////////////

    // pair

    //////////////////////////////////////////////////////////////////////

    template< typename Iterator >

    inline Iterator boost_range_begin( const std::pair<Iterator,Iterator>& p )

    {

        return p.first;

    }

    template< typename Iterator >

    inline Iterator boost_range_begin( std::pair<Iterator,Iterator>& p )

    {

        return p.first;

    }

    //////////////////////////////////////////////////////////////////////

    // array

    //////////////////////////////////////////////////////////////////////

    template< typename T, std::size_t sz >

    inline const T* boost_range_begin( const T (&array)[sz] )

    {

        return array;

    }

    template< typename T, std::size_t sz >

    inline T* boost_range_begin( T (&array)[sz] )

    {

        return array;

    }

    //////////////////////////////////////////////////////////////////////

    // string

    //////////////////////////////////////////////////////////////////////

#if 1 || BOOST_WORKAROUND(__MWERKS__, <= 0x3204 ) || BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))

// CW up to 9.3 and borland have troubles with function ordering

    inline const char* boost_range_begin( const char* s )

    {

        return s;

    }

    inline char* boost_range_begin( char* s )

    {

        return s;

    }

    inline const wchar_t* boost_range_begin( const wchar_t* s )

    {

        return s;

    }

    inline wchar_t* boost_range_begin( wchar_t* s )

    {

        return s;

    }

#else

    inline const char* boost_range_begin( const char*& s )

    {

        return s;

    }

    inline char* boost_range_begin( char*& s )

    {

        return s;

    }

    inline const wchar_t* boost_range_begin( const wchar_t*& s )

    {

        return s;

    }

    inline wchar_t* boost_range_begin( wchar_t*& s )

    {

        return s;

    }

#endif

#if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564)) && \

    !BOOST_WORKAROUND(__GNUC__, < 3) \

    /**/

} // namespace 'range_detail'

#endif

template< class T >

inline BOOST_DEDUCED_TYPENAME range_iterator<

                        typename remove_const<T>::type >::type begin( T& r )

{

#if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564)) && \

    !BOOST_WORKAROUND(__GNUC__, < 3) \

    /**/

    using namespace range_detail;

#endif

    return boost_range_begin( r );

}

template< class T >

inline BOOST_DEDUCED_TYPENAME range_const_iterator<T>::type begin( const T& r )

{

#if !BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564)) && \

    !BOOST_WORKAROUND(__GNUC__, < 3) \

    /**/

    using namespace range_detail;

#endif

    return boost_range_begin( r );

}

#if BOOST_WORKAROUND(__MWERKS__, <= 0x3003 ) || BOOST_WORKAROUND(__BORLANDC__, BOOST_TESTED_AT(0x564))

// BCB and CW are not able to overload pointer when class overloads are also available.

template<>

inline range_const_iterator<const char*>::type begin<const char*>( const char*& r )

{

    return r;

}

template<>

inline range_const_iterator<const wchar_t*>::type begin<const wchar_t*>( const wchar_t*& r )

{

    return r;

}

#endif

} // namespace boost

#endif // BOOST_NO_FUNCTION_TEMPLATE_ORDERING

namespace boost

{

    template< class T >

    inline BOOST_DEDUCED_TYPENAME range_const_iterator<T>::type

    const_begin( const T& r )

    {

        return boost::begin( r );

    }

}

#endif