resize#

Header File: <Kokkos_Core.hpp>

Usage#

resize(view,n0,n1,n2,n3);
resize(view,layout);

Reallocates a view to have the new dimensions. Can grow or shrink, and will preserve content of the common subextents.

Description#

  • template <class T, class... P>
    void resize(View<T, P...>& v,
                const size_t n0 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n1 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n2 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n3 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n4 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n5 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n6 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n7 = KOKKOS_IMPL_CTOR_DEFAULT_ARG);
    

    Resizes v to have the new dimensions while preserving the contents for the common subview of the old and new view.

    • v: existing view, can be a default constructed one.

    • n[X]: new length for extent X.

    Restrictions:

    • View<T, P...>::array_layout is either LayoutLeft or LayoutRight.

  • template <class I, class T, class... P>
    void resize(const I& arg_prop, Kokkos::View<T, P...>& v,
                const size_t n0 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n1 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n2 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n3 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n4 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n5 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n6 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n7 = KOKKOS_IMPL_CTOR_DEFAULT_ARG);
    

    Resizes v to have the new dimensions while preserving the contents for the common subview of the old and new view. The new Kokkos::View is constructed using the View constructor property arg_prop, e.g., Kokkos::WithoutInitializing.

    • v: existing view, can be a default constructed one.

    • n[X]: new length for extent X.

    • arg_prop: View constructor property, e.g., Kokkos::WithoutInitializing.

    Restrictions:

    • View<T, P...>::array_layout is either LayoutLeft` or `LayoutRight.

  • template <class T, class... P, class ALLOC_PROP>
    void resize(const ALLOC_PROP& arg_prop,
                Kokkos::View<T, P...>& v,
                const size_t n0 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n1 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n2 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n3 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n4 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n5 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n6 = KOKKOS_IMPL_CTOR_DEFAULT_ARG,
                const size_t n7 = KOKKOS_IMPL_CTOR_DEFAULT_ARG);
    

    Resizes v to have the new dimensions while preserving the contents for the common subview of the old and new view. The new Kokkos::View is constructed using the View constructor properties arg_prop, e.g., Kokkos::view_alloc(Kokkos::WithoutInitializing). If arg_prop includes an execution space, it is used for allocating memory and for copying elements without using a final fence.

    • v: existing view, can be a default constructed one.

    • n[X]: new length for extent X.

    • arg_prop: View constructor properties, e.g., Kokkos::view_alloc(Kokkos::WithoutInitializing).

    Restrictions:

    • View<T, P...>::array_layout is either LayoutLeft or LayoutRight.

    • arg_prop must not include a pointer to memory, a label, or a memory space.

  • template <class T, class... P>
    void resize(Kokkos::View<T, P...>& v,
                const typename Kokkos::View<T, P...>::array_layout& layout);
    

    Resizes v to have the new dimensions while preserving the contents for the common subview of the old and new view.

    • v: existing view, can be a default constructed one.

    • layout: a layout instance containing the new dimensions.

  • template <class T, class... P>
    void resize(const I& arg_prop, Kokkos::View<T, P...>& v,
                const typename Kokkos::View<T, P...>::array_layout& layout);
    

    Resizes v to have the new dimensions while preserving the contents for the common subview of the old and new view. The new Kokkos::View is constructed using the View constructor property arg_prop, e.g., Kokkos::WithoutInitializing.

    • v: existing view, can be a default constructed one.

    • layout: a layout instance containing the new dimensions.

    • arg_prop: View constructor property, e.g., Kokkos::WithoutInitializing.

  • template <class T, class... P, class ALLOC_PROP>
    void resize(const ALLOC_PROP& arg_prop,
                Kokkos::View<T, P...>& v,
                const typename Kokkos::View<T, P...>::array_layout& layout);
    

    Resizes v to have the new dimensions while preserving the contents for the common subview of the old and new view. The new Kokkos::View is constructed using the View constructor properties arg_prop, e.g., Kokkos::view_alloc(Kokkos::WithoutInitializing). If arg_prop includes an execution space, it is used for allocating memory and for copying elements without using a final fence.

    • v: existing view, can be a default constructed one.

    • layout: a layout instance containing the new dimensions.

    • arg_prop: View constructor properties, e.g., Kokkos::view_alloc(Kokkos::WithoutInitializing).

    Restrictions:

    • arg_prop must not include a pointer to memory, a label, or a memory space.

Example:#

  • Kokkos::resize(v, 2, 3);
    

Resize a Kokkos::View with dynamic rank 2 to have dynamic extent 2 and 3 respectively preserving previous content.

  • Kokkos::resize(Kokkos::WithoutInitializing, v, 2, 3);
    

Resize a Kokkos::View with dynamic rank 2 to have dynamic extent 2 and 3 respectively preserving previous content. After this call, the new content is uninitialized.