Blame boost/next_prior.hpp

Packit 58578d
//  Boost next_prior.hpp header file  ---------------------------------------//
Packit 58578d
Packit 58578d
//  (C) Copyright Dave Abrahams and Daniel Walker 1999-2003.
Packit 58578d
//  Copyright (c) Andrey Semashev 2017
Packit 58578d
//
Packit 58578d
//  Distributed under the Boost Software License, Version 1.0.
Packit 58578d
//  (See accompanying file LICENSE_1_0.txt or copy at
Packit 58578d
//  http://www.boost.org/LICENSE_1_0.txt)
Packit 58578d
Packit 58578d
//  See http://www.boost.org/libs/utility for documentation.
Packit 58578d
Packit 58578d
//  Revision History
Packit 58578d
//  13 Dec 2003  Added next(x, n) and prior(x, n) (Daniel Walker)
Packit 58578d
Packit 58578d
#ifndef BOOST_NEXT_PRIOR_HPP_INCLUDED
Packit 58578d
#define BOOST_NEXT_PRIOR_HPP_INCLUDED
Packit 58578d
Packit 58578d
#include <iterator>
Packit 58578d
#include <boost/config.hpp>
Packit 58578d
#include <boost/core/enable_if.hpp>
Packit 58578d
#include <boost/type_traits/has_plus.hpp>
Packit 58578d
#include <boost/type_traits/has_plus_assign.hpp>
Packit 58578d
#include <boost/type_traits/has_minus.hpp>
Packit 58578d
#include <boost/type_traits/has_minus_assign.hpp>
Packit 58578d
#include <boost/iterator/advance.hpp>
Packit 58578d
#include <boost/iterator/reverse_iterator.hpp>
Packit 58578d
Packit 58578d
namespace boost {
Packit 58578d
Packit 58578d
//  Helper functions for classes like bidirectional iterators not supporting
Packit 58578d
//  operator+ and operator-
Packit 58578d
//
Packit 58578d
//  Usage:
Packit 58578d
//    const std::list<T>::iterator p = get_some_iterator();
Packit 58578d
//    const std::list<T>::iterator prev = boost::prior(p);
Packit 58578d
//    const std::list<T>::iterator next = boost::next(prev, 2);
Packit 58578d
Packit 58578d
//  Contributed by Dave Abrahams
Packit 58578d
Packit 58578d
namespace next_prior_detail {
Packit 58578d
Packit 58578d
// The trait attempts to detect if the T type is an iterator. Class-type iterators are assumed
Packit 58578d
// to have the nested type iterator_category. Strictly speaking, this is not required to be the
Packit 58578d
// case (e.g. a user can specialize iterator_traits for T without defining T::iterator_category).
Packit 58578d
// Still, this is a good heuristic in practice, and we can't do anything better anyway.
Packit 58578d
// Since C++17 we can test for iterator_traits<T>::iterator_category presence instead as it is
Packit 58578d
// required to be only present for iterators.
Packit 58578d
template< typename T, typename Void = void >
Packit 58578d
struct is_iterator_class
Packit 58578d
{
Packit 58578d
    static BOOST_CONSTEXPR_OR_CONST bool value = false;
Packit 58578d
};
Packit 58578d
Packit 58578d
template< typename T >
Packit 58578d
struct is_iterator_class<
Packit 58578d
    T,
Packit 58578d
    typename enable_if_has_type<
Packit 58578d
#if !defined(BOOST_NO_CXX17_ITERATOR_TRAITS)
Packit 58578d
        typename std::iterator_traits< T >::iterator_category
Packit 58578d
#else
Packit 58578d
        typename T::iterator_category
Packit 58578d
#endif
Packit 58578d
    >::type
Packit 58578d
>
Packit 58578d
{
Packit 58578d
    static BOOST_CONSTEXPR_OR_CONST bool value = true;
Packit 58578d
};
Packit 58578d
Packit 58578d
template< typename T >
Packit 58578d
struct is_iterator :
Packit 58578d
    public is_iterator_class< T >
Packit 58578d
{
Packit 58578d
};
Packit 58578d
Packit 58578d
template< typename T >
Packit 58578d
struct is_iterator< T* >
Packit 58578d
{
Packit 58578d
    static BOOST_CONSTEXPR_OR_CONST bool value = true;
Packit 58578d
};
Packit 58578d
Packit 58578d
Packit 58578d
template< typename T, typename Distance, bool HasPlus = has_plus< T, Distance >::value >
Packit 58578d
struct next_plus_impl;
Packit 58578d
Packit 58578d
template< typename T, typename Distance >
Packit 58578d
struct next_plus_impl< T, Distance, true >
Packit 58578d
{
Packit 58578d
    static T call(T x, Distance n)
Packit 58578d
    {
Packit 58578d
        return x + n;
Packit 58578d
    }
Packit 58578d
};
Packit 58578d
Packit 58578d
template< typename T, typename Distance, bool HasPlusAssign = has_plus_assign< T, Distance >::value >
Packit 58578d
struct next_plus_assign_impl :
Packit 58578d
    public next_plus_impl< T, Distance >
Packit 58578d
{
Packit 58578d
};
Packit 58578d
Packit 58578d
template< typename T, typename Distance >
Packit 58578d
struct next_plus_assign_impl< T, Distance, true >
Packit 58578d
{
Packit 58578d
    static T call(T x, Distance n)
Packit 58578d
    {
Packit 58578d
        x += n;
Packit 58578d
        return x;
Packit 58578d
    }
Packit 58578d
};
Packit 58578d
Packit 58578d
template< typename T, typename Distance, bool IsIterator = is_iterator< T >::value >
Packit 58578d
struct next_advance_impl :
Packit 58578d
    public next_plus_assign_impl< T, Distance >
Packit 58578d
{
Packit 58578d
};
Packit 58578d
Packit 58578d
template< typename T, typename Distance >
Packit 58578d
struct next_advance_impl< T, Distance, true >
Packit 58578d
{
Packit 58578d
    static T call(T x, Distance n)
Packit 58578d
    {
Packit 58578d
        boost::iterators::advance(x, n);
Packit 58578d
        return x;
Packit 58578d
    }
Packit 58578d
};
Packit 58578d
Packit 58578d
Packit 58578d
template< typename T, typename Distance, bool HasMinus = has_minus< T, Distance >::value >
Packit 58578d
struct prior_minus_impl;
Packit 58578d
Packit 58578d
template< typename T, typename Distance >
Packit 58578d
struct prior_minus_impl< T, Distance, true >
Packit 58578d
{
Packit 58578d
    static T call(T x, Distance n)
Packit 58578d
    {
Packit 58578d
        return x - n;
Packit 58578d
    }
Packit 58578d
};
Packit 58578d
Packit 58578d
template< typename T, typename Distance, bool HasMinusAssign = has_minus_assign< T, Distance >::value >
Packit 58578d
struct prior_minus_assign_impl :
Packit 58578d
    public prior_minus_impl< T, Distance >
Packit 58578d
{
Packit 58578d
};
Packit 58578d
Packit 58578d
template< typename T, typename Distance >
Packit 58578d
struct prior_minus_assign_impl< T, Distance, true >
Packit 58578d
{
Packit 58578d
    static T call(T x, Distance n)
Packit 58578d
    {
Packit 58578d
        x -= n;
Packit 58578d
        return x;
Packit 58578d
    }
Packit 58578d
};
Packit 58578d
Packit 58578d
template< typename T, typename Distance, bool IsIterator = is_iterator< T >::value >
Packit 58578d
struct prior_advance_impl :
Packit 58578d
    public prior_minus_assign_impl< T, Distance >
Packit 58578d
{
Packit 58578d
};
Packit 58578d
Packit 58578d
template< typename T, typename Distance >
Packit 58578d
struct prior_advance_impl< T, Distance, true >
Packit 58578d
{
Packit 58578d
    static T call(T x, Distance n)
Packit 58578d
    {
Packit 58578d
        // Avoid negating n to sidestep possible integer overflow
Packit 58578d
        boost::iterators::reverse_iterator< T > rx(x);
Packit 58578d
        boost::iterators::advance(rx, n);
Packit 58578d
        return rx.base();
Packit 58578d
    }
Packit 58578d
};
Packit 58578d
Packit 58578d
} // namespace next_prior_detail
Packit 58578d
Packit 58578d
template <class T>
Packit 58578d
inline T next(T x) { return ++x; }
Packit 58578d
Packit 58578d
template <class T, class Distance>
Packit 58578d
inline T next(T x, Distance n)
Packit 58578d
{
Packit 58578d
    return next_prior_detail::next_advance_impl< T, Distance >::call(x, n);
Packit 58578d
}
Packit 58578d
Packit 58578d
template <class T>
Packit 58578d
inline T prior(T x) { return --x; }
Packit 58578d
Packit 58578d
template <class T, class Distance>
Packit 58578d
inline T prior(T x, Distance n)
Packit 58578d
{
Packit 58578d
    return next_prior_detail::prior_advance_impl< T, Distance >::call(x, n);
Packit 58578d
}
Packit 58578d
Packit 58578d
} // namespace boost
Packit 58578d
Packit 58578d
#endif  // BOOST_NEXT_PRIOR_HPP_INCLUDED