Abstract base class for registries. More...

#include <ogdf/basic/RegisteredArray.h>

Inheritance diagram for ogdf::RegistryBase< Key, Registry, Iterator >:

Public Types
using	iterator_type = Iterator

using	key_type = Key

using	registered_array_type = internal::RegisteredArrayBase< Registry >

using	registration_iterator_type = typename registration_list_type::iterator

using	registration_list_type = std::list< registered_array_type , OGDFAllocator< registered_array_type > >

using	registry_type = Registry

Public Member Functions
virtual	~RegistryBase () noexcept
	Destructor. Unregisters all associated arrays. More...

void	copyArrayEntries (int toIndex, int fromIndex)
	Copies the entry from `fromIndex` to `toIndex` in all registered arrays. More...

int	getArraySize () const
	Returns the current size of all registered arrays. More...

const ListPure< TObserver * > &	getObservers () const

const registration_list_type &	getRegisteredArrays () const
	Returns a reference to the list of all registered arrays. More...

bool	isAutoShrink () const
	Returns whether the registry allows arrays to shrink when keys are removed. More...

void	keyAdded (Key key)
	Records the addition of a new key and resizes all registered arrays if necessary. More...

void	keyRemoved (Key key)
	Records the deletion of a key and resizes all registered arrays if auto shrink is enabled. More...

void	keysCleared ()
	Records that all keys have been cleared. If auto shrink is enabled, all arrays are cleared and resized to 0. More...

void	moveRegisterArray (registration_iterator_type it, registered_array_type *pArray) const
	Stores array `pArray` at position `it` in the list of registered arrays. More...

OGDF_NODISCARD registration_iterator_type	registerArray (registered_array_type *pArray) const
	Registers a new array with this registry. More...

void	reserveSpace (int new_keys)
	Resizes all arrays to make space of `new_keys` new keys. More...

void	resizeArrays ()
	Resizes all arrays to the size requested by calculateArraySize(). Only shrinks the arrays if auto shrink is enabled. More...

void	resizeArrays (int size)
	Resizes all arrays to `size`. Only shrinks the arrays if auto shrink is enabled. More...

void	resizeArrays (int size, bool shrink)
	Resizes all arrays to `size`. If `shrink` is `true`, the arrays may also shrink. More...

void	setAutoShrink (bool mAutoShrink)
	Specifies whether the registry allows arrays to shrink when keys are removed. More...

void	swapArrayEntries (int index1, int index2)
	Swaps the entries at `index1` and `index2` in all registered arrays. More...

void	unregisterArray (registration_iterator_type it) const noexcept
	Unregisters an array associated with this registry. More...

void	unregisterArrays () noexcept
	Unregister all associated arrays. More...

Protected Member Functions
	RegistryBase ()=default

Private Types
using	Obs = Observable< RegisteredObserver< Registry >, Registry >

Private Attributes
bool	m_autoShrink = false

std::mutex	m_mutexRegArrays

registration_list_type	m_registeredArrays

int	m_size = 0

Detailed Description

template<typename Key, typename Registry, typename Iterator>
class ogdf::RegistryBase< Key, Registry, Iterator >

Abstract base class for registries.

Defines the interface for event handling regarding the indexed keys. A registry manages one key type and stores all registered arrays associated with that key. It determines the new size of all registered arrays when keys are added or removed.

The following methods must be implemented by all subclasses as they are used via the CRTP:

static inline int keyToIndex(Key key);
 
bool isKeyAssociated(Key key) const;
 
int maxKeyIndex() const;
 
int calculateArraySize(int add) const;

Remarks: To avoid frequent costly resize operations, the array size returned by calculateArraySize should grow in larger steps (e.g. powers of 2)

Template Parameters

Key	The key type the registry manages.
Registry	The class that implements the interface defined in RegistryBase.
Iterator	An iterator for all managed keys. Can be `void` if iterating the keys through the registered array is not required. To allow iterating over all keys, define `begin()` and `end()` methods.

See also: RegisteredArray

Definition at line 61 of file RegisteredArray.h.

Member Typedef Documentation

◆ iterator_type

template<typename Key , typename Registry , typename Iterator >

using ogdf::RegistryBase< Key, Registry, Iterator >::iterator_type = Iterator

Definition at line 144 of file RegisteredArray.h.

◆ key_type

template<typename Key , typename Registry , typename Iterator >

using ogdf::RegistryBase< Key, Registry, Iterator >::key_type = Key

Definition at line 142 of file RegisteredArray.h.

◆ Obs

template<typename Key , typename Registry , typename Iterator >

using ogdf::RegistryBase< Key, Registry, Iterator >::Obs = Observable<RegisteredObserver<Registry>, Registry>

private

Definition at line 150 of file RegisteredArray.h.

◆ registered_array_type

template<typename Key , typename Registry , typename Iterator >

using ogdf::RegistryBase< Key, Registry, Iterator >::registered_array_type = internal::RegisteredArrayBase<Registry>

Definition at line 141 of file RegisteredArray.h.

◆ registration_iterator_type

template<typename Key , typename Registry , typename Iterator >

using ogdf::RegistryBase< Key, Registry, Iterator >::registration_iterator_type = typename registration_list_type::iterator

Definition at line 147 of file RegisteredArray.h.

◆ registration_list_type

template<typename Key , typename Registry , typename Iterator >

using ogdf::RegistryBase< Key, Registry, Iterator >::registration_list_type = std::list<registered_array_type*, OGDFAllocator<registered_array_type*> >

Definition at line 146 of file RegisteredArray.h.

◆ registry_type

template<typename Key , typename Registry , typename Iterator >

using ogdf::RegistryBase< Key, Registry, Iterator >::registry_type = Registry

Definition at line 143 of file RegisteredArray.h.

Constructor & Destructor Documentation

◆ RegistryBase()

template<typename Key , typename Registry , typename Iterator >

ogdf::RegistryBase< Key, Registry, Iterator >::RegistryBase ( )

protecteddefault

◆ ~RegistryBase()

template<typename Key , typename Registry , typename Iterator >

virtual ogdf::RegistryBase< Key, Registry, Iterator >::~RegistryBase ( )

inlinevirtualnoexcept

Destructor. Unregisters all associated arrays.

Definition at line 165 of file RegisteredArray.h.

Member Function Documentation

◆ copyArrayEntries()

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::copyArrayEntries	(	int	toIndex,
		int	fromIndex
	)

inline

Copies the entry from fromIndex to toIndex in all registered arrays.

Definition at line 264 of file RegisteredArray.h.

◆ getArraySize()

template<typename Key , typename Registry , typename Iterator >

int ogdf::RegistryBase< Key, Registry, Iterator >::getArraySize ( ) const

inline

Returns the current size of all registered arrays.

Definition at line 294 of file RegisteredArray.h.

◆ getObservers()

template<typename Key , typename Registry , typename Iterator >

const ListPure<TObserver*>& ogdf::Observable< TObserver, TObserved >::getObservers

inline

Definition at line 206 of file Observer.h.

◆ getRegisteredArrays()

template<typename Key , typename Registry , typename Iterator >

const registration_list_type& ogdf::RegistryBase< Key, Registry, Iterator >::getRegisteredArrays ( ) const

inline

Returns a reference to the list of all registered arrays.

Definition at line 285 of file RegisteredArray.h.

◆ isAutoShrink()

template<typename Key , typename Registry , typename Iterator >

bool ogdf::RegistryBase< Key, Registry, Iterator >::isAutoShrink ( ) const

inline

Returns whether the registry allows arrays to shrink when keys are removed.

Definition at line 288 of file RegisteredArray.h.

◆ keyAdded()

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::keyAdded ( Key key )

inline

Records the addition of a new key and resizes all registered arrays if necessary.

Definition at line 203 of file RegisteredArray.h.

◆ keyRemoved()

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::keyRemoved ( Key key )

inline

Records the deletion of a key and resizes all registered arrays if auto shrink is enabled.

Definition at line 213 of file RegisteredArray.h.

◆ keysCleared()

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::keysCleared ( )

inline

Records that all keys have been cleared. If auto shrink is enabled, all arrays are cleared and resized to 0.

Definition at line 223 of file RegisteredArray.h.

◆ moveRegisterArray()

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::moveRegisterArray	(	registration_iterator_type	it,
		registered_array_type *	pArray
	)		const

inline

Stores array pArray at position it in the list of registered arrays.

Definition at line 195 of file RegisteredArray.h.

◆ registerArray()

template<typename Key , typename Registry , typename Iterator >

OGDF_NODISCARD registration_iterator_type ogdf::RegistryBase< Key, Registry, Iterator >::registerArray ( registered_array_type * pArray ) const

inline

Registers a new array with this registry.

Parameters

pArray A pointer to the registered array.

Returns: An iterator pointing to the entry for the registered array in the list of registered arrays. This iterator is required for unregistering the array again.

Definition at line 176 of file RegisteredArray.h.

◆ reserveSpace()

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::reserveSpace ( int new_keys )

inline

Resizes all arrays to make space of new_keys new keys.

Definition at line 249 of file RegisteredArray.h.

◆ resizeArrays() [1/3]

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::resizeArrays ( )

inline

Resizes all arrays to the size requested by calculateArraySize(). Only shrinks the arrays if auto shrink is enabled.

Definition at line 232 of file RegisteredArray.h.

◆ resizeArrays() [2/3]

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::resizeArrays ( int size )

inline

Resizes all arrays to size. Only shrinks the arrays if auto shrink is enabled.

Definition at line 235 of file RegisteredArray.h.

◆ resizeArrays() [3/3]

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::resizeArrays	(	int	size,
		bool	shrink
	)

inline

Resizes all arrays to size. If shrink is true, the arrays may also shrink.

Definition at line 238 of file RegisteredArray.h.

◆ setAutoShrink()

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::setAutoShrink ( bool mAutoShrink )

inline

Specifies whether the registry allows arrays to shrink when keys are removed.

Definition at line 291 of file RegisteredArray.h.

◆ swapArrayEntries()

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::swapArrayEntries	(	int	index1,
		int	index2
	)

inline

Swaps the entries at index1 and index2 in all registered arrays.

Definition at line 254 of file RegisteredArray.h.

◆ unregisterArray()

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::unregisterArray ( registration_iterator_type it ) const

inlinenoexcept

Unregisters an array associated with this registry.

Parameters

it	An iterator pointing to the entry of the array in the list of all registered arrays.

Definition at line 187 of file RegisteredArray.h.

◆ unregisterArrays()

template<typename Key , typename Registry , typename Iterator >

void ogdf::RegistryBase< Key, Registry, Iterator >::unregisterArrays ( )

inlinenoexcept

Unregister all associated arrays.

Definition at line 274 of file RegisteredArray.h.

Member Data Documentation

◆ m_autoShrink

template<typename Key , typename Registry , typename Iterator >

bool ogdf::RegistryBase< Key, Registry, Iterator >::m_autoShrink = false

private

Definition at line 153 of file RegisteredArray.h.

◆ m_mutexRegArrays

template<typename Key , typename Registry , typename Iterator >

std::mutex ogdf::RegistryBase< Key, Registry, Iterator >::m_mutexRegArrays

mutableprivate

Definition at line 157 of file RegisteredArray.h.

◆ m_registeredArrays

template<typename Key , typename Registry , typename Iterator >

registration_list_type ogdf::RegistryBase< Key, Registry, Iterator >::m_registeredArrays

mutableprivate

Definition at line 152 of file RegisteredArray.h.

◆ m_size

template<typename Key , typename Registry , typename Iterator >

int ogdf::RegistryBase< Key, Registry, Iterator >::m_size = 0

private

Definition at line 154 of file RegisteredArray.h.

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

include/ogdf/basic/RegisteredArray.h

OpenGraph DrawingFramework

Public Types

Public Member Functions

Protected Member Functions

Private Types

Private Attributes

Detailed Description

template<typename Key, typename Registry, typename Iterator> class ogdf::RegistryBase< Key, Registry, Iterator >

Member Typedef Documentation

◆ iterator_type

◆ key_type

◆ Obs

◆ registered_array_type

◆ registration_iterator_type

◆ registration_list_type

◆ registry_type

Constructor & Destructor Documentation

◆ RegistryBase()

◆ ~RegistryBase()

Member Function Documentation

◆ copyArrayEntries()

◆ getArraySize()

◆ getObservers()

◆ getRegisteredArrays()

◆ isAutoShrink()

◆ keyAdded()

◆ keyRemoved()

◆ keysCleared()

◆ moveRegisterArray()

◆ registerArray()

◆ reserveSpace()

◆ resizeArrays() [1/3]

◆ resizeArrays() [2/3]

◆ resizeArrays() [3/3]

◆ setAutoShrink()

◆ swapArrayEntries()

◆ unregisterArray()

◆ unregisterArrays()

Member Data Documentation

◆ m_autoShrink

◆ m_mutexRegArrays

◆ m_registeredArrays

◆ m_size

Open
Graph Drawing
Framework

template<typename Key, typename Registry, typename Iterator>
class ogdf::RegistryBase< Key, Registry, Iterator >