This class serves to provide a "view" of a multidimensional array. More...

#include <ArrayView.hpp>

Public Types
using	ValueType = T
	The type of the values in the ArrayView.

using	IndexType = INDEX_TYPE
	The integer type used for indexing.

using	NestedViewType = ArrayView< std::remove_reference_t< typeManipulation::NestedViewType< T > >, NDIM, USD, INDEX_TYPE, BUFFER_TYPE >
	The type when all inner array classes are converted to const views.

using	NestedViewTypeConst = ArrayView< std::remove_reference_t< typeManipulation::NestedViewTypeConst< T > >, NDIM, USD, INDEX_TYPE, BUFFER_TYPE >
	The type when all inner array classes are converted to const views and the inner most view's values are also const.

using	SliceType = ArraySlice< T, NDIM, USD, INDEX_TYPE > const
	The type of the ArrayView when converted to an ArraySlice.

using	SliceTypeConst = ArraySlice< T const, NDIM, USD, INDEX_TYPE > const
	The type of the ArrayView when converted to an immutable ArraySlice.

using	value_type = T
	The type of the values in the ArrayView, here for stl compatability.

using	size_type = INDEX_TYPE
	The integer type used for indexing, here for stl compatability.

Public Member Functions
Constructors, destructor and assignment operators.
	ArrayView ()=default
	A constructor to create an uninitialized ArrayView. More...

constexpr	ArrayView (ArrayView const &source) noexcept
	Copy Constructor. More...

	ArrayView (ArrayView &&source)=default
	Move constructor, creates a shallow copy and invalidates the source. More...

constexpr	ArrayView (typeManipulation::CArray< INDEX_TYPE, NDIM > const &dims, typeManipulation::CArray< INDEX_TYPE, NDIM > const &strides, int const singleParameterResizeIndex, BUFFER_TYPE< T > const &buffer)
	Construct a new ArrayView from existing components. More...

	~ArrayView ()=default
	The default destructor.

LVARRAY_INTEL_CONSTEXPR ArrayView &	operator= (ArrayView &&rhs)
	Move assignment operator, creates a shallow copy and invalidates the source. More...

LVARRAY_INTEL_CONSTEXPR ArrayView &	operator= (ArrayView const &rhs) noexcept
	Copy assignment operator, creates a shallow copy. More...

ArrayView and ArraySlice creation methods and user defined conversions.
constexpr ArrayView	toView () const &

constexpr ArrayView< T const, NDIM, USD, INDEX_TYPE, BUFFER_TYPE >	toViewConst () const &

constexpr NestedViewType	toNestedView () const &

constexpr NestedViewTypeConst	toNestedViewConst () const &

constexpr ArraySlice< T, NDIM, USD, INDEX_TYPE >	toSlice () const &noexcept

constexpr ArraySlice< T, NDIM, USD, INDEX_TYPE >	toSlice () const &&noexcept=delete
	Overload for rvalues that is deleted. More...

constexpr ArraySlice< T const, NDIM, USD, INDEX_TYPE >	toSliceConst () const &noexcept

constexpr ArraySlice< T const, NDIM, USD, INDEX_TYPE >	toSliceConst () const &&noexcept=delete
	Overload for rvalues that is deleted. More...

template<typename _T = T>
constexpr	operator std::enable_if_t< !std::is_const< _T >::value, ArrayView< T const, NDIM, USD, INDEX_TYPE, BUFFER_TYPE > > () const noexcept
	A user defined conversion operator (UDC) to an ArrayView< T const, ... >. More...

constexpr	operator ArraySlice< T, NDIM, USD, INDEX_TYPE > () const &noexcept

constexpr	operator ArraySlice< T, NDIM, USD, INDEX_TYPE > () const &&noexcept=delete
	Overload for rvalues that is deleted. More...

template<typename _T = T>
constexpr	operator std::enable_if_t< !std::is_const< _T >::value, ArraySlice< T const, NDIM, USD, INDEX_TYPE > const > () const &noexcept

template<typename _T = T>
constexpr	operator std::enable_if_t< !std::is_const< _T >::value, ArraySlice< T const, NDIM, USD, INDEX_TYPE > const > () const &&noexcept=delete
	Overload for rvalues that is deleted. More...

Attribute querying methods
INDEX_TYPE	size () const noexcept

INDEX_TYPE	size (int const dim) const noexcept

constexpr bool	empty () const

constexpr INDEX_TYPE	capacity () const

constexpr int	getSingleParameterResizeIndex () const

template<typename ... INDICES>
constexpr INDEX_TYPE	linearIndex (INDICES const ... indices) const

constexpr INDEX_TYPE const *	dims () const noexcept

constexpr INDEX_TYPE const *	strides () const noexcept

Methods that provide access to the data.
template<int _NDIM = NDIM>
constexpr std::enable_if_t<(_NDIM > 1), ArraySlice< T, NDIM - 1, USD - 1, INDEX_TYPE > >	operator[] (INDEX_TYPE const index) const &noexcept

template<int _NDIM = NDIM>
constexpr std::enable_if_t<(_NDIM > 1), ArraySlice< T, NDIM - 1, USD - 1, INDEX_TYPE > >	operator[] (INDEX_TYPE const index) const &&noexcept=delete
	Overload for rvalues that is deleted. More...

template<int _NDIM = NDIM>
constexpr std::enable_if_t< _NDIM==1, T &>	operator[] (INDEX_TYPE const index) const &noexcept

template<typename ... INDICES>
constexpr T &	operator() (INDICES... indices) const

constexpr T *	data () const

constexpr T *	begin () const

constexpr T *	end () const

T &	front () const

T &	back () const

Methods that set all the values
template<typename POLICY >
void	setValues (T const &value) const
	Set all entries in the array to `value`. More...

template<typename POLICY >
void	setValues (ArrayView< T const, NDIM, USD, INDEX_TYPE, BUFFER_TYPE > const &rhs) const
	Set entries to values from another compatible ArrayView. More...

Methods dealing with memory spaces
void	registerTouch (MemorySpace const space) const
	Touch the memory in `space`. More...

void	move (MemorySpace const space, bool const touch=true) const
	Move the Array to the given execution space, optionally touching it. More...

Static Public Attributes
static constexpr int	NDIM = NDIM_TPARAM
	The number of dimensions.

static constexpr int	USD = USD_TPARAM
	The unit stride dimension.

Protected Member Functions
constexpr	ArrayView (bool) noexcept
	Protected constructor to be used by the Array class. More...

Protected Attributes
typeManipulation::CArray< INDEX_TYPE, NDIM >	m_dims = { 0 }
	the dimensions of the array.

typeManipulation::CArray< INDEX_TYPE, NDIM >	m_strides = { 0 }
	the strides of the array.

BUFFER_TYPE< T >	m_dataBuffer
	this data member contains the actual data for the array.

int	m_singleParameterResizeIndex = 0

Detailed Description

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>
class LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >

This class serves to provide a "view" of a multidimensional array.

Template Parameters

T	type of data that is contained by the array
NDIM_TPARAM	number of dimensions in array (e.g. NDIM=1->vector, NDIM=2->Matrix, etc. ).
USD	the dimension with a unit stride, in an Array with a standard layout this is the last dimension.
INDEX_TYPE	the integer to use for indexing.
BUFFER_TYPE	A class that defines how to actually allocate memory for the Array. Must take one template argument that describes the type of the data being stored (T).

When using the ChaiBuffer the copy copy constructor of this class calls the copy constructor for the ChaiBuffer which will move the data to the location of the touch (host or device). In general, the ArrayView should be what is passed by value into a lambda that is used to launch kernels as it copy will trigger the desired data motion onto the appropriate memory space.

Key features: 1) When using a ChaiBuffer as the BUFFER_TYPE the ArrayView copy constructor will move the data to the current execution space. 2) Defines a slicing operator[]. 3) Defines operator() array accessor. 3) operator[] and operator() are all const and may be called in non-mutable lambdas. 4) Conversion operators to go from ArrayView<T> to ArrayView<T const>. 5) Since the Array is derived from ArrayView, it may be upcasted: Array<T,NDIM> array; ArrayView<T,NDIM> const & arrView = array;

A good guideline is to upcast to an ArrayView when you don't need allocation capabilities that are only present in Array.

Definition at line 67 of file ArrayView.hpp.

Constructor & Destructor Documentation

◆ ArrayView() [1/5]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::ArrayView ( )

default

A constructor to create an uninitialized ArrayView.

Note: An uninitialized ArrayView should not be used until it is assigned to.

◆ ArrayView() [2/5]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::ArrayView ( ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE > const & source )

inlinenoexcept

Copy Constructor.

Parameters

source The object to copy.

Note: Triggers the copy constructor for

Template Parameters

BUFFER_TYPE. When using the ChaiBuffer this can move the underlying buffer to a new memory space if the execution context is set.

Definition at line 126 of file ArrayView.hpp.

◆ ArrayView() [3/5]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::ArrayView ( ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE > && source )

default

Move constructor, creates a shallow copy and invalidates the source.

Parameters

source object to move.

Note: Since this invalidates the source this should not be used when source is the parent of an Array. Do not do this:
Array< int, RAJA::PERM_I, std::ptrdiff_t, MallocBuffer > array( 10 );
ArrayView< int, 1, 0, std::ptrdiff_t, MallocBuffer > view = std::move( array.toView() );
However this is ok:
Array< int, RAJA::PERM_I, std::ptrdiff_t, MallocBuffer > array( 10 );
ArrayView< int, 1, 0, std::ptrdiff_t, MallocBuffer > view = array.toView();
ArrayView< int, 1, 0, std::ptrdiff_t, MallocBuffer > anotherView = std::move( view );

◆ ArrayView() [4/5]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::ArrayView	(	typeManipulation::CArray< INDEX_TYPE, NDIM > const &	dims,
		typeManipulation::CArray< INDEX_TYPE, NDIM > const &	strides,
		int const	singleParameterResizeIndex,
		BUFFER_TYPE< T > const &	buffer
	)

inline

Construct a new ArrayView from existing components.

Parameters

dims	The array of dimensions.
strides	The array of strides.
singleParameterResizeIndex	The single parameter resize index.
buffer	The buffer to copy construct.

Definition at line 159 of file ArrayView.hpp.

◆ ArrayView() [5/5]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::ArrayView ( bool )

inlineexplicitprotectednoexcept

Protected constructor to be used by the Array class.

Note: The unused boolean parameter is to distinguish this from the default constructor.

Definition at line 642 of file ArrayView.hpp.

Member Function Documentation

◆ back()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

T& LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::back ( ) const

inline

Returns: Return a reference to the last value.

Definition at line 534 of file ArrayView.hpp.

◆ begin()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr T* LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::begin ( ) const

inline

Returns: Return an iterator to the begining of the data.

Definition at line 515 of file ArrayView.hpp.

◆ capacity()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr INDEX_TYPE LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::capacity ( ) const

inline

Returns: Return the maximum number of values the Array can hold without reallocation.

Definition at line 401 of file ArrayView.hpp.

◆ data()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr T* LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::data ( ) const

inline

Returns: Return a pointer to the values.

Definition at line 508 of file ArrayView.hpp.

◆ dims()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr INDEX_TYPE const* LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::dims ( ) const

inlinenoexcept

Returns: A pointer to the array containing the size of each dimension.

Definition at line 431 of file ArrayView.hpp.

◆ empty()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr bool LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::empty ( ) const

inline

Returns: Return true if the array is empty.

Definition at line 394 of file ArrayView.hpp.

◆ end()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr T* LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::end ( ) const

inline

Returns: Return an iterator to the end of the data.

Definition at line 522 of file ArrayView.hpp.

◆ front()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

T& LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::front ( ) const

inline

Returns: Return a reference to the first value.

Definition at line 528 of file ArrayView.hpp.

◆ getSingleParameterResizeIndex()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr int LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::getSingleParameterResizeIndex ( ) const

inline

Returns: Return the default resize dimension.

Definition at line 408 of file ArrayView.hpp.

◆ linearIndex()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

template<typename ... INDICES>

constexpr INDEX_TYPE LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::linearIndex ( INDICES const ... indices ) const

inline

Template Parameters

INDICES A variadic pack of integral types.

Returns: Return the linear index from a multidimensional index.

Parameters

indices The indices of the value to get the linear index of.

Definition at line 418 of file ArrayView.hpp.

◆ move()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

void LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::move	(	MemorySpace const	space,
		bool const	touch = `true`
	)		const

inline

Move the Array to the given execution space, optionally touching it.

Parameters

space	the space to move the Array to.
touch	whether the Array should be touched in the new space or not.

Note: Not all Buffers support memory movement.

Definition at line 605 of file ArrayView.hpp.

◆ operator ArraySlice< T, NDIM, USD, INDEX_TYPE >() [1/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::operator ArraySlice< T, NDIM, USD, INDEX_TYPE > ( ) const &

inlinenoexcept

Returns: Return an ArraySlice representing this ArrayView.

Definition at line 316 of file ArrayView.hpp.

◆ operator ArraySlice< T, NDIM, USD, INDEX_TYPE >() [2/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::operator ArraySlice< T, NDIM, USD, INDEX_TYPE > ( ) const &&

inlinedeletenoexcept

Overload for rvalues that is deleted.

Returns: A null ArraySlice. This conversion cannot be called on a rvalue since the ArraySlice would contain pointers to the dims and strides of the current ArrayView that is about to be destroyed. This overload prevents that from happening.

◆ operator std::enable_if_t< !std::is_const< _T >::value, ArraySlice< T const, NDIM, USD, INDEX_TYPE > const >() [1/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

template<typename _T = T>

constexpr LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::operator std::enable_if_t< !std::is_const< _T >::value, ArraySlice< T const, NDIM, USD, INDEX_TYPE > const > ( ) const &

inlinenoexcept

Returns: Return an immutable ArraySlice representing this ArrayView.

Definition at line 335 of file ArrayView.hpp.

◆ operator std::enable_if_t< !std::is_const< _T >::value, ArraySlice< T const, NDIM, USD, INDEX_TYPE > const >() [2/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

template<typename _T = T>

constexpr LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::operator std::enable_if_t< !std::is_const< _T >::value, ArraySlice< T const, NDIM, USD, INDEX_TYPE > const > ( ) const &&

inlinedeletenoexcept

Overload for rvalues that is deleted.

Returns: A null ArraySlice. This conversion cannot be called on a rvalue since the ArraySlice would contain pointers to the dims and strides of the current ArrayView that is about to be destroyed. This overload prevents that from happening.

◆ operator std::enable_if_t< !std::is_const< _T >::value, ArrayView< T const, NDIM, USD, INDEX_TYPE, BUFFER_TYPE > >()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

template<typename _T = T>

constexpr LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::operator std::enable_if_t< !std::is_const< _T >::value, ArrayView< T const, NDIM, USD, INDEX_TYPE, BUFFER_TYPE > > ( ) const

inlinenoexcept

A user defined conversion operator (UDC) to an ArrayView< T const, ... >.

Returns: A new ArrayView where T is const.

Definition at line 309 of file ArrayView.hpp.

◆ operator()()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

template<typename ... INDICES>

constexpr T& LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::operator() ( INDICES... indices ) const

inline

Template Parameters

INDICES A variadic pack of integral types.

Returns: Return a reference to the value at the given multidimensional index.

Parameters

indices The indices of the value to access.

Definition at line 498 of file ArrayView.hpp.

◆ operator=() [1/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

LVARRAY_INTEL_CONSTEXPR ArrayView& LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::operator= ( ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE > && rhs )

inline

Move assignment operator, creates a shallow copy and invalidates the source.

Parameters

rhs	The object to copy.

Returns: *this.

Note: Since this invalidates the source this should not be used when rhs is the parent of an Array. Do not do this:
Array< int, RAJA::PERM_I, std::ptrdiff_t, MallocBuffer > array( 10 );
ArrayView< int, 1, 0, std::ptrdiff_t, MallocBuffer > view;
view = std::move( array.toView() );
However this is ok:
Array< int, RAJA::PERM_I, std::ptrdiff_t, MallocBuffer > array( 10 );
ArrayView< int, 1, 0, std::ptrdiff_t, MallocBuffer > view = array.toView();
ArrayView< int, 1, 0, std::ptrdiff_t, MallocBuffer > anotherView;
anotherView = std::move( view );

Definition at line 192 of file ArrayView.hpp.

◆ operator=() [2/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

LVARRAY_INTEL_CONSTEXPR ArrayView& LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::operator= ( ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE > const & rhs )

inlinenoexcept

Copy assignment operator, creates a shallow copy.

Parameters

rhs	object to copy.

Returns: *this

Definition at line 211 of file ArrayView.hpp.

◆ operator[]() [1/3]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

template<int _NDIM = NDIM>

constexpr std::enable_if_t< (_NDIM > 1), ArraySlice< T, NDIM - 1, USD - 1, INDEX_TYPE > > LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::operator[] ( INDEX_TYPE const index ) const &

inlinenoexcept

Returns: Return a lower dimensional slice of this ArrayView.

Parameters

index The index of the slice to create.

Note: This method is only active when NDIM > 1.

Definition at line 456 of file ArrayView.hpp.

◆ operator[]() [2/3]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

template<int _NDIM = NDIM>

constexpr std::enable_if_t< (_NDIM > 1), ArraySlice< T, NDIM - 1, USD - 1, INDEX_TYPE > > LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::operator[] ( INDEX_TYPE const index ) const &&

inlinedeletenoexcept

Overload for rvalues that is deleted.

Parameters

index Not used.

Returns: A null ArraySlice. The multidimensional operator[] cannot be called on a rvalue since the ArraySlice would contain pointers to the object that is about to be destroyed. This overload prevents that from happening.

◆ operator[]() [3/3]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

template<int _NDIM = NDIM>

constexpr std::enable_if_t< _NDIM == 1, T & > LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::operator[] ( INDEX_TYPE const index ) const &

inlinenoexcept

Returns: Return a reference to the value at the given index.

Parameters

index The index of the value to access.

Note: This method is only active when NDIM == 1.

Definition at line 485 of file ArrayView.hpp.

◆ registerTouch()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

void LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::registerTouch ( MemorySpace const space ) const

inline

Touch the memory in space.

Parameters

space The memory space in which a touch will be recorded.

Definition at line 593 of file ArrayView.hpp.

◆ setValues() [1/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

template<typename POLICY >

void LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::setValues ( T const & value ) const

inline

Set all entries in the array to value.

Template Parameters

POLICY The RAJA policy to use.

Parameters

value The value to set entries to.

Definition at line 551 of file ArrayView.hpp.

◆ setValues() [2/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

template<typename POLICY >

void LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::setValues ( ArrayView< T const, NDIM, USD, INDEX_TYPE, BUFFER_TYPE > const & rhs ) const

inline

Set entries to values from another compatible ArrayView.

Template Parameters

POLICY The RAJA policy to use.

Parameters

rhs	The source array view, must have the same dimensions and strides as *this.

Definition at line 566 of file ArrayView.hpp.

◆ size() [1/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

INDEX_TYPE LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::size ( ) const

inlinenoexcept

Returns: Return the allocated size.

Definition at line 361 of file ArrayView.hpp.

◆ size() [2/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

INDEX_TYPE LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::size ( int const dim ) const

inlinenoexcept

Returns: Return the length of the given dimension.

Parameters

dim	The dimension to get the length of.

Definition at line 381 of file ArrayView.hpp.

◆ strides()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr INDEX_TYPE const* LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::strides ( ) const

inlinenoexcept

Returns: A pointer to the array containing the stride of each dimension.

Definition at line 438 of file ArrayView.hpp.

◆ toNestedView()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr NestedViewType LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::toNestedView ( ) const &

inline

Returns: Return *this after converting any nested arrays to const views.

Definition at line 254 of file ArrayView.hpp.

◆ toNestedViewConst()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr NestedViewTypeConst LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::toNestedViewConst ( ) const &

inline

Returns: Return *this after converting any nested arrays to const views to const values.

Definition at line 261 of file ArrayView.hpp.

◆ toSlice() [1/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr ArraySlice< T, NDIM, USD, INDEX_TYPE > LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::toSlice ( ) const &

inlinenoexcept

Returns: Return an ArraySlice representing this ArrayView.

Definition at line 269 of file ArrayView.hpp.

◆ toSlice() [2/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr ArraySlice< T, NDIM, USD, INDEX_TYPE > LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::toSlice ( ) const &&

inlinedeletenoexcept

Overload for rvalues that is deleted.

Returns: A null ArraySlice.

Note: This cannot be called on a rvalue since the ArraySlice would contain pointers to the dims and strides of the current ArrayView that is about to be destroyed. This overload prevents that from happening.

◆ toSliceConst() [1/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr ArraySlice< T const, NDIM, USD, INDEX_TYPE > LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::toSliceConst ( ) const &

inlinenoexcept

Returns: Return an immutable ArraySlice representing this ArrayView.

Definition at line 288 of file ArrayView.hpp.

◆ toSliceConst() [2/2]

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr ArraySlice< T const, NDIM, USD, INDEX_TYPE > LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::toSliceConst ( ) const &&

inlinedeletenoexcept

Overload for rvalues that is deleted.

Returns: A null ArraySlice. This cannot be called on a rvalue since the ArraySlice would contain pointers to the dims and strides of the current ArrayView that is about to be destroyed. This overload prevents that from happening.

◆ toView()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr ArrayView LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::toView ( ) const &

inline

Returns: Return a new ArrayView.

Definition at line 235 of file ArrayView.hpp.

◆ toViewConst()

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

constexpr ArrayView< T const, NDIM, USD, INDEX_TYPE, BUFFER_TYPE > LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::toViewConst ( ) const &

inline

Returns: Return a new ArrayView where T is const.

Definition at line 242 of file ArrayView.hpp.

Member Data Documentation

◆ m_singleParameterResizeIndex

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>

int LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >::m_singleParameterResizeIndex = 0

protected

this data member specifies the dimension that will be resized as a result of a call to the single dimension resize method.

Definition at line 663 of file ArrayView.hpp.

The documentation for this class was generated from the following file:

coreComponents/LvArray/src/ArrayView.hpp

Public Types

Public Member Functions

Static Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE> class LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >

Constructor & Destructor Documentation

◆ ArrayView() [1/5]

◆ ArrayView() [2/5]

◆ ArrayView() [3/5]

◆ ArrayView() [4/5]

◆ ArrayView() [5/5]

Member Function Documentation

◆ back()

◆ begin()

◆ capacity()

◆ data()

◆ dims()

◆ empty()

◆ end()

◆ front()

◆ getSingleParameterResizeIndex()

◆ linearIndex()

◆ move()

◆ operator ArraySlice< T, NDIM, USD, INDEX_TYPE >() [1/2]

◆ operator ArraySlice< T, NDIM, USD, INDEX_TYPE >() [2/2]

◆ operator std::enable_if_t< !std::is_const< _T >::value, ArraySlice< T const, NDIM, USD, INDEX_TYPE > const >() [1/2]

◆ operator std::enable_if_t< !std::is_const< _T >::value, ArraySlice< T const, NDIM, USD, INDEX_TYPE > const >() [2/2]

◆ operator std::enable_if_t< !std::is_const< _T >::value, ArrayView< T const, NDIM, USD, INDEX_TYPE, BUFFER_TYPE > >()

◆ operator()()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator[]() [1/3]

◆ operator[]() [2/3]

◆ operator[]() [3/3]

◆ registerTouch()

◆ setValues() [1/2]

◆ setValues() [2/2]

◆ size() [1/2]

◆ size() [2/2]

◆ strides()

◆ toNestedView()

◆ toNestedViewConst()

◆ toSlice() [1/2]

◆ toSlice() [2/2]

◆ toSliceConst() [1/2]

◆ toSliceConst() [2/2]

◆ toView()

◆ toViewConst()

Member Data Documentation

◆ m_singleParameterResizeIndex

template<typename T, int NDIM_TPARAM, int USD_TPARAM, typename INDEX_TYPE, template< typename > class BUFFER_TYPE>
class LvArray::ArrayView< T, NDIM_TPARAM, USD_TPARAM, INDEX_TYPE, BUFFER_TYPE >