xentara::memory::WriteSentinel< Array > Class Reference

A sentinel that protects write access to memory containing a heterogenious array. More...

#include <memory/WriteSentinel_Array.hpp>

Inheritance diagram for xentara::memory::WriteSentinel< Array >:

Public Member Functions
	WriteSentinel (const ArrayBlock &block)
	Constructor.
	WriteSentinel (const ArrayBlock &block, CopyOldValuesTag tag)
	Constructor that copies the old values, if necessary.
	~WriteSentinel ()=default
	Destructor.
internal auto	operator[] (const Array::Handle &handle) const noexcept -> void *
	Gets a raw memory element.
template<typename Type >
auto	operator[] (const Array::ObjectHandle< Type > &handle) const noexcept -> Type &
	Gets an element containing a C++ object.
auto	commit () -> void
	Commits the changes.
auto	discard () -> void
	Discards any uncommitted changes.
auto	oldValues () const -> ConstArrayAccessor
	Creates an accessor for the old values of the block.

Detailed Description

A sentinel that protects write access to memory containing a heterogenious array.

Note

Objects of this class can be moved, but not copied.

Constructor & Destructor Documentation

WriteSentinel() [1/2]

xentara::memory::WriteSentinel< Array >::WriteSentinel

(

const ArrayBlock &

block

)

Constructor.

Attention

The new values will be default constructed. To initialize the new values with the old values, use the other constructor.

Parameters

block

The memory block you wish to write to

WriteSentinel() [2/2]

xentara::memory::WriteSentinel< Array >::WriteSentinel	(	const ArrayBlock &	block,
		CopyOldValuesTag	tag
	)

Constructor that copies the old values, if necessary.

This constructor will initialize the new values with copies of the old values.

Parameters

block	The memory block you wish to write to
tag	Always pass WriteSentinel::kCopyOldValues as this parameter

~WriteSentinel()

xentara::memory::WriteSentinel< Array >::~WriteSentinel ( )

default

Destructor.

Discards any uncommitted changes.

Member Function Documentation

commit()

auto xentara::memory::WriteSentinel< Array >::commit

(

)

-> void

Commits the changes.

Warning

Do not access the data after you have called commit() or discard()!

discard()

auto xentara::memory::WriteSentinel< Array >::discard

(

)

-> void

Discards any uncommitted changes.

Warning

Do not access the data after you have called commit() or discard()!

oldValues()

auto xentara::memory::WriteSentinel< Array >::oldValues

(

)

const -> ConstArrayAccessor

Creates an accessor for the old values of the block.

This function can be used to access the old values of the block for memory resources that write by allocating a new block and swapping it in for the old one on commit. For memory resources that write data in place, the returned object provides access to the same memory as the writer itself.

Returns

An accessor suitable for accessing the old (current) values of the block.

Warning

Do not access the data after you have called commit() or discard()!

operator[]() [1/2]

internal auto xentara::memory::WriteSentinel< Array >::operator[] ( const Array::Handle &  handle ) const -> void *

noexcept

Gets a raw memory element.

Parameters

handle

The element handle

Returns

The placement of the corresponding element

operator[]() [2/2]

template<typename Type >

auto xentara::memory::WriteSentinel< Array >::operator[] ( const Array::ObjectHandle< Type > &  handle ) const -> Type &

noexcept

Gets an element containing a C++ object.

Parameters

handle

The element handle

Returns

A reference to the corresponding element