Open CASCADE Technology  7.3.1.dev
Public Member Functions
TDF_Label Class Reference

This class provides basic operations to define a label in a data structure. A label is a feature in the feature hierarchy. A label is always connected to a Data from TDF. To a label is attached attributes containing the software components information. More...

#include <TDF_Label.hxx>

Public Member Functions

 TDF_Label ()
 Constructs an empty label object. More...
 
void Nullify ()
 Nullifies the label. More...
 
Handle< TDF_DataData () const
 Returns the Data owning <me>. More...
 
Standard_Integer Tag () const
 Returns the tag of the label. This is the integer assigned randomly to a label in a data framework. This integer is used to identify this label in an entry. More...
 
const TDF_Label Father () const
 Returns the label father. This label may be null if the label is root. More...
 
Standard_Boolean IsNull () const
 Returns True if the <aLabel> is null, i.e. it has not been included in the data framework. More...
 
void Imported (const Standard_Boolean aStatus) const
 Sets or unsets <me> and all its descendants as imported label, according to <aStatus>. More...
 
Standard_Boolean IsImported () const
 Returns True if the <aLabel> is imported. More...
 
Standard_Boolean IsEqual (const TDF_Label &aLabel) const
 Returns True if the <aLabel> is equal to me (same LabelNode*). More...
 
Standard_Boolean operator== (const TDF_Label &aLabel) const
 
Standard_Boolean IsDifferent (const TDF_Label &aLabel) const
 
Standard_Boolean operator!= (const TDF_Label &aLabel) const
 
Standard_Boolean IsRoot () const
 
Standard_Boolean IsAttribute (const Standard_GUID &anID) const
 Returns true if <me> owns an attribute with <anID> as ID. More...
 
void AddAttribute (const Handle< TDF_Attribute > &anAttribute, const Standard_Boolean append=Standard_True) const
 Adds an Attribute to the current label. Raises if there is already one. More...
 
void ForgetAttribute (const Handle< TDF_Attribute > &anAttribute) const
 Forgets an Attribute from the current label, setting its forgotten status true and its valid status false. Raises if the attribute is not in the structure. More...
 
Standard_Boolean ForgetAttribute (const Standard_GUID &aguid) const
 Forgets the Attribute of GUID <aguid> from the current label . If the attribute doesn't exist returns False. Otherwise returns True. More...
 
void ForgetAllAttributes (const Standard_Boolean clearChildren=Standard_True) const
 Forgets all the attributes. Does it on also on the sub-labels if <clearChildren> is set to true. Of course, this method is compatible with Transaction & Delta mecanisms. More...
 
void ResumeAttribute (const Handle< TDF_Attribute > &anAttribute) const
 Undo Forget action, setting its forgotten status false and its valid status true. Raises if the attribute is not in the structure. More...
 
Standard_Boolean FindAttribute (const Standard_GUID &anID, Handle< TDF_Attribute > &anAttribute) const
 Finds an attribute of the current label, according to <anID>. If anAttribute is not a valid one, false is returned. More...
 
template<class T >
Standard_Boolean FindAttribute (const Standard_GUID &theID, Handle< T > &theAttr) const
 Safe variant of FindAttribute() for arbitrary type of argument. More...
 
Standard_Boolean FindAttribute (const Standard_GUID &anID, const Standard_Integer aTransaction, Handle< TDF_Attribute > &anAttribute) const
 Finds an attribute of the current label, according to <anID> and <aTransaction>. This attribute has/had to be a valid one for the given transaction index . So, this attribute is not necessary a valid one. More...
 
Standard_Boolean MayBeModified () const
 Returns true if <me> or a DESCENDANT of <me> owns attributes not yet available in transaction 0. It means at least one of their attributes is new, modified or deleted. More...
 
Standard_Boolean AttributesModified () const
 Returns true if <me> owns attributes not yet available in transaction 0. It means at least one attribute is new, modified or deleted. More...
 
Standard_Boolean HasAttribute () const
 Returns true if this label has at least one attribute. More...
 
Standard_Integer NbAttributes () const
 Returns the number of attributes. More...
 
Standard_Integer Depth () const
 Returns the depth of the label in the data framework. This corresponds to the number of fathers which this label has, and is used in determining whether a label is root, null or equivalent to another label. Exceptions: Standard_NullObject if this label is null. This is because a null object can have no depth. More...
 
Standard_Boolean IsDescendant (const TDF_Label &aLabel) const
 Returns True if <me> is a descendant of <aLabel>. Attention: every label is its own descendant. More...
 
const TDF_Label Root () const
 Returns the root label Root of the data structure. This has a depth of 0. Exceptions: Standard_NullObject if this label is null. This is because a null object can have no depth. More...
 
Standard_Boolean HasChild () const
 Returns true if this label has at least one child. More...
 
Standard_Integer NbChildren () const
 Returns the number of children. More...
 
TDF_Label FindChild (const Standard_Integer aTag, const Standard_Boolean create=Standard_True) const
 Finds a child label having <aTag> as tag. Creates The tag aTag identifies the label which will be the parent. If create is true and no child label is found, a new one is created. Example: //creating a label with tag 10 at Root TDF_Label lab1 = aDF->Root().FindChild(10); //creating labels 7 and 2 on label 10 TDF_Label lab2 = lab1.FindChild(7); TDF_Label lab3 = lab1.FindChild(2);. More...
 
TDF_Label NewChild () const
 Create a new child label of me using autoamtic delivery tags provided by TagSource. More...
 
Standard_Integer Transaction () const
 Returns the current transaction index. More...
 
Standard_Boolean HasLowerNode (const TDF_Label &otherLabel) const
 Returns true if node address of <me> is lower than <otherLabel> one. Used to quickly sort labels (not on entry criterion). More...
 
Standard_Boolean HasGreaterNode (const TDF_Label &otherLabel) const
 Returns true if node address of <me> is greater than <otherLabel> one. Used to quickly sort labels (not on entry criterion). More...
 
Standard_OStreamDump (Standard_OStream &anOS) const
 Dumps the minimum information about <me> on <aStream>. More...
 
Standard_OStreamoperator<< (Standard_OStream &anOS) const
 
void ExtendedDump (Standard_OStream &anOS, const TDF_IDFilter &aFilter, TDF_AttributeIndexedMap &aMap) const
 Dumps the label on <aStream> and its attributes rank in <aMap> if their IDs are kept by <IDFilter>. More...
 
void EntryDump (Standard_OStream &anOS) const
 Dumps the label entry. More...
 

Detailed Description

This class provides basic operations to define a label in a data structure. A label is a feature in the feature hierarchy. A label is always connected to a Data from TDF. To a label is attached attributes containing the software components information.

Label information:

It is possible to know the tag, the father, the depth in the tree of the label, if the label is root, null or equal to another label.

Comfort methods: Some methods useful on a label.

Attributes:

It is possible to get an attribute in accordance to an ID, or the yougest previous version of a current attribute.

Constructor & Destructor Documentation

◆ TDF_Label()

TDF_Label::TDF_Label ( )

Constructs an empty label object.

Member Function Documentation

◆ AddAttribute()

void TDF_Label::AddAttribute ( const Handle< TDF_Attribute > &  anAttribute,
const Standard_Boolean  append = Standard_True 
) const

Adds an Attribute to the current label. Raises if there is already one.

◆ AttributesModified()

Standard_Boolean TDF_Label::AttributesModified ( ) const

Returns true if <me> owns attributes not yet available in transaction 0. It means at least one attribute is new, modified or deleted.

◆ Data()

Handle< TDF_Data > TDF_Label::Data ( ) const

Returns the Data owning <me>.

◆ Depth()

Standard_Integer TDF_Label::Depth ( ) const

Returns the depth of the label in the data framework. This corresponds to the number of fathers which this label has, and is used in determining whether a label is root, null or equivalent to another label. Exceptions: Standard_NullObject if this label is null. This is because a null object can have no depth.

◆ Dump()

Standard_OStream& TDF_Label::Dump ( Standard_OStream anOS) const

Dumps the minimum information about <me> on <aStream>.

◆ EntryDump()

void TDF_Label::EntryDump ( Standard_OStream anOS) const

Dumps the label entry.

◆ ExtendedDump()

void TDF_Label::ExtendedDump ( Standard_OStream anOS,
const TDF_IDFilter aFilter,
TDF_AttributeIndexedMap aMap 
) const

Dumps the label on <aStream> and its attributes rank in <aMap> if their IDs are kept by <IDFilter>.

◆ Father()

const TDF_Label TDF_Label::Father ( ) const

Returns the label father. This label may be null if the label is root.

◆ FindAttribute() [1/3]

Standard_Boolean TDF_Label::FindAttribute ( const Standard_GUID anID,
Handle< TDF_Attribute > &  anAttribute 
) const

Finds an attribute of the current label, according to <anID>. If anAttribute is not a valid one, false is returned.

The method returns True if found, False otherwise.

A removed attribute cannot be found.

◆ FindAttribute() [2/3]

template<class T >
Standard_Boolean TDF_Label::FindAttribute ( const Standard_GUID theID,
Handle< T > &  theAttr 
) const
inline

Safe variant of FindAttribute() for arbitrary type of argument.

◆ FindAttribute() [3/3]

Standard_Boolean TDF_Label::FindAttribute ( const Standard_GUID anID,
const Standard_Integer  aTransaction,
Handle< TDF_Attribute > &  anAttribute 
) const

Finds an attribute of the current label, according to <anID> and <aTransaction>. This attribute has/had to be a valid one for the given transaction index . So, this attribute is not necessary a valid one.

The method returns True if found, False otherwise.

A removed attribute cannot be found nor a backuped attribute of a removed one.

◆ FindChild()

TDF_Label TDF_Label::FindChild ( const Standard_Integer  aTag,
const Standard_Boolean  create = Standard_True 
) const

Finds a child label having <aTag> as tag. Creates The tag aTag identifies the label which will be the parent. If create is true and no child label is found, a new one is created. Example: //creating a label with tag 10 at Root TDF_Label lab1 = aDF->Root().FindChild(10); //creating labels 7 and 2 on label 10 TDF_Label lab2 = lab1.FindChild(7); TDF_Label lab3 = lab1.FindChild(2);.

◆ ForgetAllAttributes()

void TDF_Label::ForgetAllAttributes ( const Standard_Boolean  clearChildren = Standard_True) const

Forgets all the attributes. Does it on also on the sub-labels if <clearChildren> is set to true. Of course, this method is compatible with Transaction & Delta mecanisms.

◆ ForgetAttribute() [1/2]

void TDF_Label::ForgetAttribute ( const Handle< TDF_Attribute > &  anAttribute) const

Forgets an Attribute from the current label, setting its forgotten status true and its valid status false. Raises if the attribute is not in the structure.

◆ ForgetAttribute() [2/2]

Standard_Boolean TDF_Label::ForgetAttribute ( const Standard_GUID aguid) const

Forgets the Attribute of GUID <aguid> from the current label . If the attribute doesn't exist returns False. Otherwise returns True.

◆ HasAttribute()

Standard_Boolean TDF_Label::HasAttribute ( ) const

Returns true if this label has at least one attribute.

◆ HasChild()

Standard_Boolean TDF_Label::HasChild ( ) const

Returns true if this label has at least one child.

◆ HasGreaterNode()

Standard_Boolean TDF_Label::HasGreaterNode ( const TDF_Label otherLabel) const

Returns true if node address of <me> is greater than <otherLabel> one. Used to quickly sort labels (not on entry criterion).

-C++: inline

◆ HasLowerNode()

Standard_Boolean TDF_Label::HasLowerNode ( const TDF_Label otherLabel) const

Returns true if node address of <me> is lower than <otherLabel> one. Used to quickly sort labels (not on entry criterion).

-C++: inline

◆ Imported()

void TDF_Label::Imported ( const Standard_Boolean  aStatus) const

Sets or unsets <me> and all its descendants as imported label, according to <aStatus>.

◆ IsAttribute()

Standard_Boolean TDF_Label::IsAttribute ( const Standard_GUID anID) const

Returns true if <me> owns an attribute with <anID> as ID.

◆ IsDescendant()

Standard_Boolean TDF_Label::IsDescendant ( const TDF_Label aLabel) const

Returns True if <me> is a descendant of <aLabel>. Attention: every label is its own descendant.

◆ IsDifferent()

Standard_Boolean TDF_Label::IsDifferent ( const TDF_Label aLabel) const

◆ IsEqual()

Standard_Boolean TDF_Label::IsEqual ( const TDF_Label aLabel) const

Returns True if the <aLabel> is equal to me (same LabelNode*).

◆ IsImported()

Standard_Boolean TDF_Label::IsImported ( ) const

Returns True if the <aLabel> is imported.

◆ IsNull()

Standard_Boolean TDF_Label::IsNull ( ) const

Returns True if the <aLabel> is null, i.e. it has not been included in the data framework.

◆ IsRoot()

Standard_Boolean TDF_Label::IsRoot ( ) const

◆ MayBeModified()

Standard_Boolean TDF_Label::MayBeModified ( ) const

Returns true if <me> or a DESCENDANT of <me> owns attributes not yet available in transaction 0. It means at least one of their attributes is new, modified or deleted.

◆ NbAttributes()

Standard_Integer TDF_Label::NbAttributes ( ) const

Returns the number of attributes.

◆ NbChildren()

Standard_Integer TDF_Label::NbChildren ( ) const

Returns the number of children.

◆ NewChild()

TDF_Label TDF_Label::NewChild ( ) const

Create a new child label of me using autoamtic delivery tags provided by TagSource.

◆ Nullify()

void TDF_Label::Nullify ( )

Nullifies the label.

◆ operator!=()

Standard_Boolean TDF_Label::operator!= ( const TDF_Label aLabel) const
inline

◆ operator<<()

Standard_OStream& TDF_Label::operator<< ( Standard_OStream anOS) const
inline

◆ operator==()

Standard_Boolean TDF_Label::operator== ( const TDF_Label aLabel) const
inline

◆ ResumeAttribute()

void TDF_Label::ResumeAttribute ( const Handle< TDF_Attribute > &  anAttribute) const

Undo Forget action, setting its forgotten status false and its valid status true. Raises if the attribute is not in the structure.

◆ Root()

const TDF_Label TDF_Label::Root ( ) const

Returns the root label Root of the data structure. This has a depth of 0. Exceptions: Standard_NullObject if this label is null. This is because a null object can have no depth.

◆ Tag()

Standard_Integer TDF_Label::Tag ( ) const

Returns the tag of the label. This is the integer assigned randomly to a label in a data framework. This integer is used to identify this label in an entry.

◆ Transaction()

Standard_Integer TDF_Label::Transaction ( ) const

Returns the current transaction index.


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