a Finder allows to map any kind of object as a Key for a Map. This works by defining, for a Hash Code, that of the real Key, not of the Finder which acts only as an intermediate. When a Map asks for the HashCode of a Finder, this one returns the code it has determined at creation time More...

#include <Transfer_Finder.hxx>

Inheritance diagram for Transfer_Finder:

[legend]

Public Member Functions
size_t	GetHashCode () const
	Returns the HashCode which has been stored by SetHashCode (remark that HashCode could be deferred then be defined by sub-classes, the result is the same)

virtual bool	Equates (const occ::handle< Transfer_Finder > &other) const =0
	Specific testof equality : to be defined by each sub-class, must be False if Finders have not the same true Type, else their contents must be compared.

virtual occ::handle< Standard_Type >	ValueType () const
	Returns the Type of the Value. By default, returns the DynamicType of <me>, but can be redefined.

virtual const char *	ValueTypeName () const
	Returns the name of the Type of the Value. Default is name of ValueType, unless it is for a non-handled object.

void	SetAttribute (const char *const name, const occ::handle< Standard_Transient > &val)
	Adds an attribute with a given name (replaces the former one with the same name if already exists)

bool	RemoveAttribute (const char *const name)
	Removes an attribute Returns True when done, False if this attribute did not exist.

bool	GetAttribute (const char *const name, const occ::handle< Standard_Type > &type, occ::handle< Standard_Transient > &val) const
	Returns an attribute from its name, filtered by a type If no attribute has this name, or if it is not kind of this type, <val> is Null and returned value is False Else, it is True.

occ::handle< Standard_Transient >	Attribute (const char *const name) const
	Returns an attribute from its name. Null Handle if not recorded (whatever Transient, Integer, Real ...)

Interface_ParamType	AttributeType (const char *const name) const
	Returns the type of an attribute : ParamInt , ParamReal , ParamText (String) , ParamIdent (any) or ParamVoid (not recorded)

void	SetIntegerAttribute (const char *const name, const int val)
	Adds an integer value for an attribute.

bool	GetIntegerAttribute (const char *const name, int &val) const
	Returns an attribute from its name, as integer If no attribute has this name, or not an integer, <val> is 0 and returned value is False Else, it is True.

int	IntegerAttribute (const char *const name) const
	Returns an integer attribute from its name. 0 if not recorded.

void	SetRealAttribute (const char *const name, const double val)
	Adds a real value for an attribute.

bool	GetRealAttribute (const char *const name, double &val) const
	Returns an attribute from its name, as real If no attribute has this name, or not a real <val> is 0.0 and returned value is False Else, it is True.

double	RealAttribute (const char *const name) const
	Returns a real attribute from its name. 0.0 if not recorded.

void	SetStringAttribute (const char const name, const char const val)
	Adds a String value for an attribute.

bool	GetStringAttribute (const char const name, const char &val) const
	Returns an attribute from its name, as String If no attribute has this name, or not a String <val> is 0.0 and returned value is False Else, it is True.

const char *	StringAttribute (const char *const name) const
	Returns a String attribute from its name. "" if not recorded.

NCollection_DataMap< TCollection_AsciiString, occ::handle< Standard_Transient > > &	AttrList ()
	Returns the exhaustive list of attributes.

void	SameAttributes (const occ::handle< Transfer_Finder > &other)
	Gets the list of attributes from <other>, as such, i.e. not copied : attributes are shared, any attribute edited, added, or removed in <other> is also in <me> and vice versa The former list of attributes of <me> is dropped.

void	GetAttributes (const occ::handle< Transfer_Finder > &other, const char *const fromname="", const bool copied=true)
	Gets the list of attributes from <other>, by copying it By default, considers all the attributes from <other> If <fromname> is given, considers only the attributes with name beginning by <fromname>

Public Member Functions inherited from Standard_Transient
	Standard_Transient ()
	Empty constructor.

	Standard_Transient (const Standard_Transient &)
	Copy constructor – does nothing.

Standard_Transient &	operator= (const Standard_Transient &)
	Assignment operator, needed to avoid copying reference counter.

virtual	~Standard_Transient ()=default
	Destructor must be virtual.

virtual const opencascade::handle< Standard_Type > &	DynamicType () const
	Returns a type descriptor about this object.

bool	IsInstance (const opencascade::handle< Standard_Type > &theType) const
	Returns a true value if this is an instance of Type.

bool	IsInstance (const char *const theTypeName) const
	Returns a true value if this is an instance of TypeName.

bool	IsKind (const opencascade::handle< Standard_Type > &theType) const
	Returns true if this is an instance of Type or an instance of any class that inherits from Type. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

bool	IsKind (const char *const theTypeName) const
	Returns true if this is an instance of TypeName or an instance of any class that inherits from TypeName. Note that multiple inheritance is not supported by OCCT RTTI mechanism.

Standard_Transient *	This () const
	Returns non-const pointer to this object (like const_cast). For protection against creating handle to objects allocated in stack or call from constructor, it will raise exception Standard_ProgramError if reference counter is zero.

int	GetRefCount () const noexcept
	Get the reference counter of this object.

void	IncrementRefCounter () noexcept
	Increments the reference counter of this object. Uses relaxed memory ordering since incrementing only requires atomicity, not synchronization with other memory operations.

int	DecrementRefCounter () noexcept
	Decrements the reference counter of this object; returns the decremented value. Uses release ordering for the decrement to ensure all writes to the object are visible before the count reaches zero. An acquire fence is added only when the count reaches zero, ensuring proper synchronization before deletion. This is more efficient than using acq_rel for every decrement.

virtual void	Delete () const
	Memory deallocator for transient classes.

Protected Member Functions
void	SetHashCode (const size_t code)
	Stores the HashCode which corresponds to the Value given to create the Mapper.

Additional Inherited Members
Public Types inherited from Standard_Transient
typedef void	base_type
	Returns a type descriptor about this object.

Static Public Member Functions inherited from Standard_Transient
static constexpr const char *	get_type_name ()
	Returns a type descriptor about this object.

static const opencascade::handle< Standard_Type > &	get_type_descriptor ()
	Returns type descriptor of Standard_Transient class.

Detailed Description

a Finder allows to map any kind of object as a Key for a Map. This works by defining, for a Hash Code, that of the real Key, not of the Finder which acts only as an intermediate. When a Map asks for the HashCode of a Finder, this one returns the code it has determined at creation time

Member Function Documentation

◆ Attribute()

occ::handle< Standard_Transient > Transfer_Finder::Attribute ( const char *const name ) const

Returns an attribute from its name. Null Handle if not recorded (whatever Transient, Integer, Real ...)

◆ AttributeType()

Interface_ParamType Transfer_Finder::AttributeType ( const char *const name ) const

Returns the type of an attribute : ParamInt , ParamReal , ParamText (String) , ParamIdent (any) or ParamVoid (not recorded)

◆ AttrList()

NCollection_DataMap< TCollection_AsciiString, occ::handle< Standard_Transient > > & Transfer_Finder::AttrList ( )

Returns the exhaustive list of attributes.

◆ Equates()

virtual bool Transfer_Finder::Equates ( const occ::handle< Transfer_Finder > & other ) const

pure virtual

Specific testof equality : to be defined by each sub-class, must be False if Finders have not the same true Type, else their contents must be compared.

Implemented in Transfer_TransientMapper, and TransferBRep_ShapeMapper.

◆ GetAttribute()

bool Transfer_Finder::GetAttribute	(	const char *const	name,
		const occ::handle< Standard_Type > &	type,
		occ::handle< Standard_Transient > &	val ) const

Returns an attribute from its name, filtered by a type If no attribute has this name, or if it is not kind of this type, <val> is Null and returned value is False Else, it is True.

◆ GetAttributes()

void Transfer_Finder::GetAttributes	(	const occ::handle< Transfer_Finder > &	other,
		const char *const	fromname = "",
		const bool	copied = true )

Gets the list of attributes from <other>, by copying it By default, considers all the attributes from <other> If <fromname> is given, considers only the attributes with name beginning by <fromname>

For each attribute, if <copied> is True (D), its value is also copied if it is a basic type (Integer,Real,String), else it remains shared between <other> and <me>

These new attributes are added to the existing ones in <me>, in case of same name, they replace the existing ones

◆ GetHashCode()

size_t Transfer_Finder::GetHashCode ( ) const

Returns the HashCode which has been stored by SetHashCode (remark that HashCode could be deferred then be defined by sub-classes, the result is the same)

◆ GetIntegerAttribute()

bool Transfer_Finder::GetIntegerAttribute	(	const char *const	name,
		int &	val ) const

Returns an attribute from its name, as integer If no attribute has this name, or not an integer, <val> is 0 and returned value is False Else, it is True.

◆ GetRealAttribute()

bool Transfer_Finder::GetRealAttribute	(	const char *const	name,
		double &	val ) const

Returns an attribute from its name, as real If no attribute has this name, or not a real <val> is 0.0 and returned value is False Else, it is True.

◆ GetStringAttribute()

bool Transfer_Finder::GetStringAttribute	(	const char *const	name,
		const char *&	val ) const

Returns an attribute from its name, as String If no attribute has this name, or not a String <val> is 0.0 and returned value is False Else, it is True.

◆ IntegerAttribute()

int Transfer_Finder::IntegerAttribute ( const char *const name ) const

Returns an integer attribute from its name. 0 if not recorded.

◆ RealAttribute()

double Transfer_Finder::RealAttribute ( const char *const name ) const

Returns a real attribute from its name. 0.0 if not recorded.

◆ RemoveAttribute()

bool Transfer_Finder::RemoveAttribute ( const char *const name )

Removes an attribute Returns True when done, False if this attribute did not exist.

◆ SameAttributes()

void Transfer_Finder::SameAttributes ( const occ::handle< Transfer_Finder > & other )

Gets the list of attributes from <other>, as such, i.e. not copied : attributes are shared, any attribute edited, added, or removed in <other> is also in <me> and vice versa The former list of attributes of <me> is dropped.

◆ SetAttribute()

void Transfer_Finder::SetAttribute	(	const char *const	name,
		const occ::handle< Standard_Transient > &	val )

Adds an attribute with a given name (replaces the former one with the same name if already exists)

◆ SetHashCode()

void Transfer_Finder::SetHashCode ( const size_t code )

protected

Stores the HashCode which corresponds to the Value given to create the Mapper.

◆ SetIntegerAttribute()

void Transfer_Finder::SetIntegerAttribute	(	const char *const	name,
		const int	val )

Adds an integer value for an attribute.

◆ SetRealAttribute()

void Transfer_Finder::SetRealAttribute	(	const char *const	name,
		const double	val )

Adds a real value for an attribute.

◆ SetStringAttribute()

void Transfer_Finder::SetStringAttribute	(	const char *const	name,
		const char *const	val )

Adds a String value for an attribute.

◆ StringAttribute()

const char * Transfer_Finder::StringAttribute ( const char *const name ) const

Returns a String attribute from its name. "" if not recorded.

◆ ValueType()

virtual occ::handle< Standard_Type > Transfer_Finder::ValueType ( ) const

virtual

Returns the Type of the Value. By default, returns the DynamicType of <me>, but can be redefined.

Reimplemented in Transfer_TransientMapper, and TransferBRep_ShapeMapper.

◆ ValueTypeName()

virtual const char * Transfer_Finder::ValueTypeName ( ) const