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 (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 _T = T, typename = std::enable_if_t< std::is_const< _T >::value >>
constexpr	ChaiBuffer (ChaiBuffer< std::remove_const_t< T > > const &src)
	Create a copy of `src` with const T. 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, 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...

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/6]

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/6]

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/6]

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 155 of file ChaiBuffer.hpp.

◆ ChaiBuffer() [4/6]

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 173 of file ChaiBuffer.hpp.

◆ ChaiBuffer() [5/6]

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 190 of file ChaiBuffer.hpp.

◆ ChaiBuffer() [6/6]

template<typename T >

template<typename _T = T, typename = std::enable_if_t< std::is_const< _T >::value >>

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

inline

Create a copy of src with const T.

Template Parameters

_T	A dummy parameter to allow enable_if, do not specify.

Parameters

src	The buffer to copy.

Definition at line 207 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 300 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 307 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 287 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 365 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 337 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 219 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 233 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 326 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 315 of file ChaiBuffer.hpp.

◆ reallocate()

template<typename T >

void LvArray::ChaiBuffer< T >::reallocate	(	std::ptrdiff_t const	size,
		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.
newCapacity	the new capacity of the buffer.

Note: This currently only reallocates the buffer on the CPU and it frees the buffer in every other memory space.

Definition at line 254 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 391 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 404 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/6]

◆ ChaiBuffer() [2/6]

◆ ChaiBuffer() [3/6]

◆ ChaiBuffer() [4/6]

◆ ChaiBuffer() [5/6]

◆ ChaiBuffer() [6/6]

Member Function Documentation

◆ capacity()

◆ data()

◆ free()

◆ move()

◆ moveNested()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator[]()

◆ pointerRecord()

◆ reallocate()

◆ registerTouch()

◆ setName()

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