Implements the Buffer interface using CHAI. More...

#include <ChaiBuffer.hpp>

Public Types
using	value_type = T
	Alias for T used used in the bufferManipulation functions.

using	T_non_const = std::remove_const_t< T >
	An alias for the non const version of T.

Public Member Functions
constexpr	ChaiBuffer ()
	Default constructor, creates an uninitialized ChaiBuffer. More...

	ChaiBuffer (bool)
	Constructor for creating an empty Buffer. More...

	ChaiBuffer (std::initializer_list< MemorySpace > const &spaces, std::initializer_list< umpire::Allocator > const &allocators)
	Construct a ChaiBuffer which uses the specific allocator for each space. More...

	ChaiBuffer (ChaiBuffer const &src)
	Copy constructor. More...

	ChaiBuffer (ChaiBuffer const &src, std::ptrdiff_t const size)
	Copy constructor. More...

constexpr	ChaiBuffer (ChaiBuffer &&src)
	Move constructor. More...

template<typename U >
constexpr	ChaiBuffer (ChaiBuffer< U > const &src)
	Create a shallow copy of `src` but with a different type. More...

LVARRAY_INTEL_CONSTEXPR ChaiBuffer &	operator= (ChaiBuffer const &src)
	Copy assignment operator. More...

LVARRAY_INTEL_CONSTEXPR ChaiBuffer &	operator= (ChaiBuffer &&src)
	Move assignment operator. More...

void	reallocate (std::ptrdiff_t const size, MemorySpace const space, std::ptrdiff_t const newCapacity)
	Reallocate the buffer to the new capacity. More...

void	free ()
	Free the data in the buffer but does not destroy any values. More...

constexpr std::ptrdiff_t	capacity () const

constexpr T *	data () const

constexpr chai::PointerRecord &	pointerRecord () const
	Return a reference to the associated CHAI PointerRecord. More...

template<typename INDEX_TYPE >
constexpr T &	operator[] (INDEX_TYPE const i) const

void	moveNested (MemorySpace const space, std::ptrdiff_t const size, bool const touch) const
	Move the buffer to the given execution space, optionally touching it. More...

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

MemorySpace	getPreviousSpace () const

constexpr void	registerTouch (MemorySpace const space) const
	Touch the buffer in the given space. More...

template<typename U = ChaiBuffer< T >>
void	setName (std::string const &name)
	Set the name associated with this buffer which is used in the chai callback. More...

Static Public Attributes
static constexpr bool	hasShallowCopy = true
	A flag indicating that the ChaiBuffer's copy semantics are shallow.

Detailed Description

template<typename T>
class LvArray::ChaiBuffer< T >

Implements the Buffer interface using CHAI.

Template Parameters

T	type of data that is contained in the buffer.

The ChaiBuffer's allocation can exist in multiple memory spaces. If the chai execution space is set the copy constructor will ensure that the newly constructed ChaiBuffer's pointer points to memory in that space. If the memory does exist it will be allocated and the data copied over. If the memory exists but the data has been touched (modified) in the current space it will be copied over. The data is touched in the new space if T is non const and is not touched if T is const.

Note: Both the copy constructor and copy assignment constructor perform a shallow copy of the source. Similarly the destructor does not free the allocation.

Definition at line 104 of file ChaiBuffer.hpp.

Constructor & Destructor Documentation

◆ ChaiBuffer() [1/7]

template<typename T>

constexpr LvArray::ChaiBuffer< T >::ChaiBuffer ( )

inline

Default constructor, creates an uninitialized ChaiBuffer.

An uninitialized ChaiBuffer is an undefined state and may only be assigned to. An uninitialized ChaiBuffer holds no recources and does not need to be free'd.

Definition at line 123 of file ChaiBuffer.hpp.

◆ ChaiBuffer() [2/7]

template<typename T>

LvArray::ChaiBuffer< T >::ChaiBuffer ( bool )

inline

Constructor for creating an empty Buffer.

An empty buffer may hold resources and needs to be free'd.

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

Definition at line 134 of file ChaiBuffer.hpp.

◆ ChaiBuffer() [3/7]

template<typename T>

LvArray::ChaiBuffer< T >::ChaiBuffer	(	std::initializer_list< MemorySpace > const &	spaces,
		std::initializer_list< umpire::Allocator > const &	allocators
	)

inline

Construct a ChaiBuffer which uses the specific allocator for each space.

Parameters

spaces	The list of spaces.
allocators	The allocators, must be the same length as `spaces`.

allocator[ i ]

is used for the memory space

spaces[ i ]

.

Definition at line 154 of file ChaiBuffer.hpp.

◆ ChaiBuffer() [4/7]

template<typename T>

LvArray::ChaiBuffer< T >::ChaiBuffer ( ChaiBuffer< T > const & src )

inline

Copy constructor.

Parameters

src	The buffer to copy.

In addition to performing a shallow copy of src if the chai execution space is set *this will contain a pointer the the allocation in that space.

Definition at line 183 of file ChaiBuffer.hpp.

◆ ChaiBuffer() [5/7]

template<typename T>

LvArray::ChaiBuffer< T >::ChaiBuffer	(	ChaiBuffer< T > const &	src,
		std::ptrdiff_t const	size
	)

inline

Copy constructor.

Parameters

src	The buffer to copy.

In addition to performing a shallow copy of src if the chai execution space is set *this will contain a pointer the the allocation in that space.

Parameters

size	The number of values in the allocation.

Note: In addition to performing a shallow copy of src if the chai execution space is set *this will contain a pointer the the allocation in that space. It will also move any nested objects.

Definition at line 201 of file ChaiBuffer.hpp.

◆ ChaiBuffer() [6/7]

template<typename T>

constexpr LvArray::ChaiBuffer< T >::ChaiBuffer ( ChaiBuffer< T > && src )

inline

Move constructor.

Parameters

src	The ChaiBuffer to be moved from, is uninitialized after this call.

Definition at line 218 of file ChaiBuffer.hpp.

◆ ChaiBuffer() [7/7]

template<typename T>

template<typename U >

constexpr LvArray::ChaiBuffer< T >::ChaiBuffer ( ChaiBuffer< U > const & src )

inline

Create a shallow copy of src but with a different type.

Template Parameters

U	The type to convert from.

Parameters

src	The buffer to copy.

Definition at line 235 of file ChaiBuffer.hpp.

Member Function Documentation

◆ capacity()

template<typename T>

constexpr std::ptrdiff_t LvArray::ChaiBuffer< T >::capacity ( ) const

inline

Returns: Return the capacity of the buffer.

Definition at line 334 of file ChaiBuffer.hpp.

◆ data()

template<typename T>

constexpr T* LvArray::ChaiBuffer< T >::data ( ) const

inline

Returns: Return a pointer to the beginning of the buffer.

Definition at line 341 of file ChaiBuffer.hpp.

◆ free()

template<typename T>

void LvArray::ChaiBuffer< T >::free ( )

inline

Free the data in the buffer but does not destroy any values.

Note: To destroy the values and free the data call bufferManipulation::free.

Definition at line 321 of file ChaiBuffer.hpp.

◆ getPreviousSpace()

template<typename T>

MemorySpace LvArray::ChaiBuffer< T >::getPreviousSpace ( ) const

inline

Returns: The last space the ChaiBuffer was moved to.

Definition at line 423 of file ChaiBuffer.hpp.

◆ move()

template<typename T>

void LvArray::ChaiBuffer< T >::move	(	MemorySpace const	space,
		bool const	touch
	)		const

inline

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

Parameters

space	The space to move the buffer to.
touch	If the buffer should be touched in the new space or not.

Note: This will not move subobjects.

Definition at line 399 of file ChaiBuffer.hpp.

◆ moveNested()

template<typename T>

void LvArray::ChaiBuffer< T >::moveNested	(	MemorySpace const	space,
		std::ptrdiff_t const	size,
		bool const	touch
	)		const

inline

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

Parameters

space	The space to move the buffer to.
size	The size of the buffer.
touch	If the buffer should be touched in the new space or not.

Note: If they type T supports it this will call move( space, touch ) on each sub object.

Definition at line 371 of file ChaiBuffer.hpp.

◆ operator=() [1/2]

template<typename T>

LVARRAY_INTEL_CONSTEXPR ChaiBuffer& LvArray::ChaiBuffer< T >::operator= ( ChaiBuffer< T > const & src )

inline

Copy assignment operator.

Parameters

src	The ChaiBuffer to be copied.

Returns: *this.

Definition at line 247 of file ChaiBuffer.hpp.

◆ operator=() [2/2]

template<typename T>

LVARRAY_INTEL_CONSTEXPR ChaiBuffer& LvArray::ChaiBuffer< T >::operator= ( ChaiBuffer< T > && src )

inline

Move assignment operator.

Parameters

src	The ChaiBuffer to be moved from, is uninitialized after this call.

Returns: *this.

Definition at line 261 of file ChaiBuffer.hpp.

◆ operator[]()

template<typename T>

template<typename INDEX_TYPE >

constexpr T& LvArray::ChaiBuffer< T >::operator[] ( INDEX_TYPE const i ) const

inline

Template Parameters

INDEX_TYPE the type used to index into the values.

Returns: The value at position i .

Parameters

i	The position of the value to access.

Note: No bounds checks are performed.

Definition at line 360 of file ChaiBuffer.hpp.

◆ pointerRecord()

template<typename T>

constexpr chai::PointerRecord& LvArray::ChaiBuffer< T >::pointerRecord ( ) const

inline

Return a reference to the associated CHAI PointerRecord.

Returns: A reference to the associated CHAI PointerRecord.

Definition at line 349 of file ChaiBuffer.hpp.

◆ reallocate()

template<typename T>

void LvArray::ChaiBuffer< T >::reallocate	(	std::ptrdiff_t const	size,
		MemorySpace const	space,
		std::ptrdiff_t const	newCapacity
	)

inline

Reallocate the buffer to the new capacity.

Parameters

size	the number of values that are initialized in the buffer. Values between [0, size) are destroyed.
space	The space to perform the reallocation in. If space is the CPU then the buffer is reallocated only on the CPU and it is free'd in the other spaces. If the space is the GPU the the current size must be zero.
newCapacity	the new capacity of the buffer.

Definition at line 281 of file ChaiBuffer.hpp.

◆ registerTouch()

template<typename T>

constexpr void LvArray::ChaiBuffer< T >::registerTouch ( MemorySpace const space ) const

inline

Touch the buffer in the given space.

Parameters

space the space to touch.

Definition at line 431 of file ChaiBuffer.hpp.

◆ setName()

template<typename T>

template<typename U = ChaiBuffer< T >>

void LvArray::ChaiBuffer< T >::setName ( std::string const & name )

inline

Set the name associated with this buffer which is used in the chai callback.

Template Parameters

U	The type of the owning class, will be displayed in the callback.

Parameters

name	the of the buffer.

Definition at line 444 of file ChaiBuffer.hpp.

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

coreComponents/LvArray/src/ChaiBuffer.hpp

Public Types

Public Member Functions

Static Public Attributes

Detailed Description

template<typename T> class LvArray::ChaiBuffer< T >

Constructor & Destructor Documentation

◆ ChaiBuffer() [1/7]

◆ ChaiBuffer() [2/7]

◆ ChaiBuffer() [3/7]

◆ ChaiBuffer() [4/7]

◆ ChaiBuffer() [5/7]

◆ ChaiBuffer() [6/7]

◆ ChaiBuffer() [7/7]

Member Function Documentation

◆ capacity()

◆ data()

◆ free()

◆ getPreviousSpace()

◆ move()

◆ moveNested()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator[]()

◆ pointerRecord()

◆ reallocate()

◆ registerTouch()

◆ setName()

template<typename T>
class LvArray::ChaiBuffer< T >