SG::AtomicDecorator< T, ALLOC > Class Template Reference

Access an auxiliary variable atomically. More...

#include <AtomicDecorator.h>

Inheritance diagram for SG::AtomicDecorator< T, ALLOC >:

Collaboration diagram for SG::AtomicDecorator< T, ALLOC >:

Public Types
using	Base = Decorator<T, ALLOC>
	Base class.
using	reference_type = std::atomic<T>&
	Type referencing an item.
using	element_type = typename AuxDataTraits<T, ALLOC>::element_type
	Type the user sees.
using	container_pointer_type = std::atomic<T>*
	Pointer into the container holding this item.
using	const_container_pointer_type = const std::atomic<T>*

Public Member Functions
	AtomicDecorator (const std::string &name)
	Constructor.
	AtomicDecorator (const std::string &name, const std::string &clsname)
	Constructor.
	AtomicDecorator (const SG::auxid_t auxid)
	Constructor taking an auxid directly.
template<IsConstAuxElement ELT>
reference_type	operator() (const ELT &e) const
	Fetch the variable for one element, as a non-const reference.
reference_type	operator() (const AuxVectorData &container, size_t index) const
	Fetch the variable for one element, as a non-const reference.
void	set (const AuxElement &e, const element_type &x) const
	Set the variable for one element.
const_container_pointer_type	getDataArray (const AuxVectorData &container) const
	Get a pointer to the start of the auxiliary data array.
container_pointer_type	getDecorationArray (const AuxVectorData &container) const
	Get a pointer to the start of the auxiliary data array.

Detailed Description

template<class T, class ALLOC = AuxAllocator_t<T>>
class SG::AtomicDecorator< T, ALLOC >

Access an auxiliary variable atomically.

Definition at line 42 of file AtomicDecorator.h.

Member Typedef Documentation

Base

template<class T, class ALLOC = AuxAllocator_t<T>>

using SG::AtomicDecorator< T, ALLOC >::Base = Decorator<T, ALLOC>

Base class.

Definition at line 47 of file AtomicDecorator.h.

const_container_pointer_type

template<class T, class ALLOC = AuxAllocator_t<T>>

using SG::AtomicDecorator< T, ALLOC >::const_container_pointer_type = const std::atomic<T>*

Definition at line 57 of file AtomicDecorator.h.

container_pointer_type

template<class T, class ALLOC = AuxAllocator_t<T>>

using SG::AtomicDecorator< T, ALLOC >::container_pointer_type = std::atomic<T>*

Pointer into the container holding this item.

Definition at line 56 of file AtomicDecorator.h.

element_type

template<class T, class ALLOC = AuxAllocator_t<T>>

using SG::AtomicDecorator< T, ALLOC >::element_type = typename AuxDataTraits<T, ALLOC>::element_type

Type the user sees.

Definition at line 53 of file AtomicDecorator.h.

reference_type

template<class T, class ALLOC = AuxAllocator_t<T>>

using SG::AtomicDecorator< T, ALLOC >::reference_type = std::atomic<T>&

Type referencing an item.

Definition at line 50 of file AtomicDecorator.h.

Constructor & Destructor Documentation

AtomicDecorator() [1/3]

template<class T, class ALLOC = AuxAllocator_t<T>>

SG::AtomicDecorator< T, ALLOC >::AtomicDecorator

(

const std::string &

name

)

Constructor.

Parameters

name	Name of this aux variable.

The name -> auxid lookup is done here.

AtomicDecorator() [2/3]

template<class T, class ALLOC = AuxAllocator_t<T>>

SG::AtomicDecorator< T, ALLOC >::AtomicDecorator	(	const std::string &	name,
		const std::string &	clsname )

Constructor.

Parameters

name	Name of this aux variable.
clsname	The name of its associated class. May be blank.

The name -> auxid lookup is done here.

AtomicDecorator() [3/3]

template<class T, class ALLOC = AuxAllocator_t<T>>

SG::AtomicDecorator< T, ALLOC >::AtomicDecorator

(

const SG::auxid_t

auxid

)

Constructor taking an auxid directly.

Parameters

auxid

ID for this auxiliary variable.

Will throw SG::ExcAuxTypeMismatch if the types don't match.

Member Function Documentation

getDataArray()

template<class T, class ALLOC = AuxAllocator_t<T>>

const_container_pointer_type SG::AtomicDecorator< T, ALLOC >::getDataArray

(

const AuxVectorData &

container

)

const

Get a pointer to the start of the auxiliary data array.

Parameters

container

The container from which to fetch the variable.

getDecorationArray()

template<class T, class ALLOC = AuxAllocator_t<T>>

container_pointer_type SG::AtomicDecorator< T, ALLOC >::getDecorationArray

(

const AuxVectorData &

container

)

const

Get a pointer to the start of the auxiliary data array.

Parameters

container

The container from which to fetch the variable.

If the container is locked, this will allow fetching only variables that do not yet exist (in which case they will be marked as decorations) or variables already marked as decorations.

operator()() [1/2]

template<class T, class ALLOC = AuxAllocator_t<T>>

reference_type SG::AtomicDecorator< T, ALLOC >::operator()	(	const AuxVectorData &	container,
		size_t	index ) const

Fetch the variable for one element, as a non-const reference.

Parameters

container	The container from which to fetch the variable.
index	The index of the desired element.

This allows retrieving aux data by container / index. Looping over the index via this method will be faster then looping over the elements of the container.

If the container is locked, this will allow fetching only variables that do not yet exist (in which case they will be marked as decorations) or variables already marked as decorations.

operator()() [2/2]

template<class T, class ALLOC = AuxAllocator_t<T>>

template<IsConstAuxElement ELT>

reference_type SG::AtomicDecorator< T, ALLOC >::operator()

(

const ELT &

e

)

const

Fetch the variable for one element, as a non-const reference.

Parameters

e	The element for which to fetch the variable.

If the container is locked, this will allow fetching only variables that do not yet exist (in which case they will be marked as decorations) or variables already marked as decorations.

set()

template<class T, class ALLOC = AuxAllocator_t<T>>

void SG::AtomicDecorator< T, ALLOC >::set	(	const AuxElement &	e,
		const element_type &	x ) const

Set the variable for one element.

Parameters

e	The element for which to fetch the variable.
x	The variable value to set.

---

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

• AtomicDecorator.h