Base class for Attributes, that manipulates an attribute stored in an AttributesManager. More...

#include <geogram/basic/attributes.h>

Inheritance diagram for GEO::AttributeBase< T >:

Public Member Functions
	AttributeBase ()
	Creates an uninitialized (unbound) Attribute.

	AttributeBase (AttributesManager &manager, const std::string &name)
	Creates or retrieves a persistent attribute attached to a given AttributesManager.

bool	is_bound () const
	Tests whether an Attribute is bound.

void	unbind ()
	Unbinds this Attribute.

void	bind (AttributesManager &manager, const std::string &name)
	Binds this Attribute to an AttributesManager.

bool	bind_if_is_defined (AttributesManager &manager, const std::string &name)
	Binds this Attribute to an AttributesManager if it already exists in the AttributesManager.

bool	bind_if_is_compatible (AttributesManager &manager, const std::string &name)
	Binds this Attribute to an AttributesManager if it already exists in the AttributesManager and tyopes are compatible.

void	create_vector_attribute (AttributesManager &manager, const std::string &name, index_t dimension)
	Creates and binds a new vector attribute.

void	destroy ()
	Destroys this attribute in the AttributesManager.

void	redim (index_t new_dim)
	Sets the dimension.

	~AttributeBase ()
	Attribute destructor.

index_t	size () const
	Gets the size.

void	zero ()
	Sets all the elements of this Attribute to zero.

bool	can_get_vector ()
	Tests whether get_vector() can be called on this Attribute.

vector< T > &	get_vector ()
	Gets a reference to the internal vector<T> used to store the attribute.

const vector< T > &	get_vector () const
	Gets a const reference to the internal vector<T> used to store the attribute.

AttributesManager *	manager () const
	Gets the AttributesManager this Attribute is bound to.

Public Member Functions inherited from GEO::AttributeStoreObserver
	AttributeStoreObserver ()
	Creates a new uninitialied AttributeStore.

void	notify (Memory::pointer base_addr, index_t size, index_t dim)
	Callback function, called by the AttributeStore whenever it is modified.

index_t	size () const
	Gets the size.

index_t	dimension () const
	Gets the dimension.

index_t	nb_elements () const
	Gets the total number of elements.

void	register_me (AttributeStore *store)
	Registers this observer to an AttributeStore.

void	unregister_me (AttributeStore *store)
	Unregisters this observer from an AttributeStore.

void	disconnect ()
	Disconnects this AttributeStoreObserver from its AttributeStore.

Static Public Member Functions
static bool	is_defined (AttributesManager &manager, const std::string &name, index_t dim=0)
	Tests whether an attribute with the specified name and with corresponding type exists in an AttributesManager.

Protected Attributes
AttributesManager *	manager_

AttributeStore *	store_

Protected Attributes inherited from GEO::AttributeStoreObserver
Memory::pointer	base_addr_

index_t	size_

index_t	dimension_

bool	disconnected_

Detailed Description

template<class T>
class GEO::AttributeBase< T >

Base class for Attributes, that manipulates an attribute stored in an AttributesManager.

Definition at line 1106 of file attributes.h.

Constructor & Destructor Documentation

◆ AttributeBase() [1/2]

template<class T >

GEO::AttributeBase< T >::AttributeBase ( )

inline

Creates an uninitialized (unbound) Attribute.

Definition at line 1112 of file attributes.h.

◆ AttributeBase() [2/2]

template<class T >

GEO::AttributeBase< T >::AttributeBase	(	AttributesManager &	manager,
		const std::string &	name
	)

inline

Creates or retrieves a persistent attribute attached to a given AttributesManager.

If the attribute already exists with the specified name in the AttributesManager then it is retrieved, else it is created and bound to the name.

Parameters

[in]	manager	a reference to the AttributesManager
[in]	name	name of the attribute

Definition at line 1126 of file attributes.h.

◆ ~AttributeBase()

template<class T >

GEO::AttributeBase< T >::~AttributeBase ( )

inline

Attribute destructor.

The attribute is not destroyed, it can be retrieved later by binding with the same name. To destroy the attribute, use destroy() instead.

Definition at line 1283 of file attributes.h.

Member Function Documentation

◆ bind()

template<class T >

void GEO::AttributeBase< T >::bind	(	AttributesManager &	manager,
		const std::string &	name
	)

inline

Binds this Attribute to an AttributesManager.

If the attribute already exists with the specified name in the AttributesManager then it is retrieved, else it is created and bound to the name.

Parameters

[in]	manager	a reference to the AttributesManager
[in]	name	name of the attribute

Precondition: !is_bound()

Definition at line 1166 of file attributes.h.

◆ bind_if_is_compatible()

template<class T >

bool GEO::AttributeBase< T >::bind_if_is_compatible	(	AttributesManager &	manager,
		const std::string &	name
	)

inline

Binds this Attribute to an AttributesManager if it already exists in the AttributesManager and tyopes are compatible.

Parameters

[in]	manager	a reference to the AttributesManager
[in]	name	name of the attribute

Precondition: !is_bound()

Returns: true if this Attribute was successfully bound

Definition at line 1210 of file attributes.h.

◆ bind_if_is_defined()

template<class T >

bool GEO::AttributeBase< T >::bind_if_is_defined	(	AttributesManager &	manager,
		const std::string &	name
	)

inline

Binds this Attribute to an AttributesManager if it already exists in the AttributesManager.

Parameters

[in]	manager	a reference to the AttributesManager
[in]	name	name of the attribute

Precondition: !is_bound()

Returns: true if this Attribute was successfully bound

Definition at line 1188 of file attributes.h.

◆ can_get_vector()

template<class T >

bool GEO::AttributeBase< T >::can_get_vector ( )

inline

Tests whether get_vector() can be called on this Attribute.

get_vector() can be called if this attribute is bound and if type T corresponds to the type used to create the attribute.

Note: Advanced users only. Most client code will not need to use this function.

Definition at line 1335 of file attributes.h.

◆ create_vector_attribute()

template<class T >

void GEO::AttributeBase< T >::create_vector_attribute	(	AttributesManager &	manager,
		const std::string &	name,
		index_t	dimension
	)

inline

Creates and binds a new vector attribute.

Parameters

[in]	manager	the attribute manager
[in]	name	the name of the attribute
[in]	dimension	the number of elements per item

Definition at line 1235 of file attributes.h.

◆ destroy()

template<class T >

void GEO::AttributeBase< T >::destroy ( )

inline

Destroys this attribute in the AttributesManager.

On exit, the attribute is no-longer accessible in the AttributesManager, its name is available again, and this attribute is in the unbound state.

Definition at line 1254 of file attributes.h.

◆ get_vector() [1/2]

template<class T >

vector< T > & GEO::AttributeBase< T >::get_vector ( )

inline

Gets a reference to the internal vector<T> used to store the attribute.

It is forbidden to modify the size of the returned vector.

Returns: a reference to the vector<T> used to store the attribute.

Note: Advanced users only. Most client code will not need to use this function.

Definition at line 1351 of file attributes.h.

◆ get_vector() [2/2]

template<class T >

const vector< T > & GEO::AttributeBase< T >::get_vector ( ) const

inline

Gets a const reference to the internal vector<T> used to store the attribute.

Returns: a const reference to the vector<T> used to store the attribute.

Definition at line 1364 of file attributes.h.

◆ is_bound()

template<class T >

bool GEO::AttributeBase< T >::is_bound ( ) const

inline

Tests whether an Attribute is bound.

Return values

true	if this Attribute is bound
false	otherwise

Definition at line 1137 of file attributes.h.

◆ is_defined()

template<class T >

static bool GEO::AttributeBase< T >::is_defined	(	AttributesManager &	manager,
		const std::string &	name,
		index_t	dim = `0`
	)

inlinestatic

Tests whether an attribute with the specified name and with corresponding type exists in an AttributesManager.

Parameters

[in]	manager	a reference to the AttributesManager
[in]	name	the name of the attribute
[in]	dim	dimension, or 0 if any dimension can match

Definition at line 1297 of file attributes.h.

◆ manager()

template<class T >

AttributesManager * GEO::AttributeBase< T >::manager ( ) const

inline

Gets the AttributesManager this Attribute is bound to.

Returns: a pointer to the attributes manager.

Definition at line 1375 of file attributes.h.

◆ redim()

template<class T >

void GEO::AttributeBase< T >::redim ( index_t new_dim )

inline

Sets the dimension.

The dimension is 1 for standard attributes and can be greater for vector attributes. The existing fields are kept. If the new dimension is greater than the old one, then new fields are initialized to the default value for the attribute type.

Parameters

[in] new_dim the new dimension

Definition at line 1271 of file attributes.h.

◆ size()

template<class T >

index_t GEO::AttributeBase< T >::size ( ) const

inline

Gets the size.

Returns: The number of items in this attribute.

Definition at line 1313 of file attributes.h.

◆ unbind()

template<class T >

void GEO::AttributeBase< T >::unbind ( )

inline

Unbinds this Attribute.

Precondition: is_bound()

Definition at line 1145 of file attributes.h.

◆ zero()

template<class T >

void GEO::AttributeBase< T >::zero ( )

inline

Sets all the elements of this Attribute to zero.

Definition at line 1321 of file attributes.h.

Member Data Documentation

◆ manager_

template<class T >

AttributesManager* GEO::AttributeBase< T >::manager_

protected

Definition at line 1380 of file attributes.h.

◆ store_

template<class T >

AttributeStore* GEO::AttributeBase< T >::store_

protected

Definition at line 1381 of file attributes.h.

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

geogram/basic/attributes.h

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ AttributeBase() [1/2]

◆ AttributeBase() [2/2]

◆ ~AttributeBase()

Member Function Documentation

◆ bind()

◆ bind_if_is_compatible()

◆ bind_if_is_defined()

◆ can_get_vector()

◆ create_vector_attribute()

◆ destroy()

◆ get_vector() [1/2]

◆ get_vector() [2/2]

◆ is_bound()

◆ is_defined()

◆ manager()

◆ redim()

◆ size()

◆ unbind()

◆ zero()

Member Data Documentation

◆ manager_

◆ store_