move#

Header File: Kokkos_StdAlgorithms.hpp

namespace Kokkos{
namespace Experimental{

template <class ExecutionSpace, class InputIterator, class OutputIterator>
OutputIterator move(const ExecutionSpace& exespace,                          (1)
                    InputIterator first_from,
                    InputIterator last_from,
                    OutputIterator first_to);

template <class ExecutionSpace, class InputIterator, class OutputIterator>
OutputIterator move(const std::string& label,                                (2)
                    const ExecutionSpace& exespace,
                    InputIterator first_from,
                    InputIterator last_from,
                    OutputIterator first_to);

template <
  class ExecutionSpace,
  class DataType1, class... Properties1,
  class DataType2, class... Properties2
>
auto move(const ExecutionSpace& exespace,                                    (3)
          const Kokkos::View<DataType1, Properties1...>& source,
          Kokkos::View<DataType2, Properties2...>& dest);

template <
  class ExecutionSpace,
  class DataType1, class... Properties1,
  class DataType2, class... Properties2
>
auto move(const std::string& label,                                          (4)
          const ExecutionSpace& exespace,
          const Kokkos::View<DataType1, Properties1...>& source,
          Kokkos::View<DataType2, Properties2...>& dest);

} //end namespace Experimental
} //end namespace Kokkos

Description#

  • Overloads 1,2: moves the elements from the range [first_from, last_from) to the range beginning at first_to

  • Overloads 3,4: moves the elements from source view to dest view

Parameters and Requirements#

  • exespace:

    • execution space instance

  • label:

    • used to name the implementation kernels for debugging purposes

    • for 1, the default string is: “Kokkos::move_iterator_api_default”

    • for 3, the default string is: “Kokkos::move_view_api_default”

  • first_from, last_from:

    • range of elements to move

    • must be random access iterators

    • must represent a valid range, i.e., last_from >= first_from (checked in debug mode)

    • must be accessible from exespace

  • source, dest:

    • views to move from and to, must be rank-1, and have LayoutLeft, LayoutRight, or LayoutStride

    • must be accessible from exespace

Return#

Iterator to the element after the last element moved.