dds/external/ranges-v3/include/range/v3/algorithm/copy_backward.hpp

/// \file
// Range v3 library
//
//  Copyright Eric Niebler 2013-present
//
//  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)
//
// Project home: https://github.com/ericniebler/range-v3
//
#ifndef RANGES_V3_ALGORITHM_COPY_BACKWARD_HPP
#define RANGES_V3_ALGORITHM_COPY_BACKWARD_HPP

#include <utility>

#include <range/v3/range_fwd.hpp>

#include <range/v3/algorithm/result_types.hpp>
#include <range/v3/iterator/concepts.hpp>
#include <range/v3/iterator/operations.hpp>
#include <range/v3/iterator/traits.hpp>
#include <range/v3/range/access.hpp>
#include <range/v3/range/concepts.hpp>
#include <range/v3/range/dangling.hpp>
#include <range/v3/range/traits.hpp>
#include <range/v3/utility/static_const.hpp>

namespace ranges
{
    /// \addtogroup group-algorithms
    /// @{
    template<typename I, typename O>
    using copy_backward_result = detail::in_out_result<I, O>;

    RANGES_BEGIN_NIEBLOID(copy_backward)

        /// \brief function template \c copy_backward
        template<typename I, typename S, typename O>
        auto RANGES_FUN_NIEBLOID(copy_backward)(I first, S end_, O out)
            ->CPP_ret(copy_backward_result<I, O>)( //
                requires bidirectional_iterator<I> && sentinel_for<S, I> &&
                bidirectional_iterator<O> && indirectly_copyable<I, O>)
        {
            I i = ranges::next(first, end_), last = i;
            while(first != i)
                *--out = *--i;
            return {last, out};
        }

        /// \overload
        template<typename Rng, typename O>
        auto RANGES_FUN_NIEBLOID(copy_backward)(Rng && rng, O out)
            ->CPP_ret(copy_backward_result<safe_iterator_t<Rng>, O>)( //
                requires bidirectional_range<Rng> && bidirectional_iterator<O> &&
                indirectly_copyable<iterator_t<Rng>, O>)
        {
            return (*this)(begin(rng), end(rng), std::move(out));
        }
    RANGES_END_NIEBLOID(copy_backward)

    namespace cpp20
    {
        using ranges::copy_backward;
        using ranges::copy_backward_result;
    } // namespace cpp20
    /// @}
} // namespace ranges

#endif // include guard