Iterates on the children of a label, at the first level only. It is possible to ask the iterator to explore all the sub label levels of the given one, with the option "allLevels". More...

#include <TDF_ChildIterator.hxx>

Public Member Functions
	TDF_ChildIterator ()
	Creates an empty iterator object to explore the children of a label. More...

	TDF_ChildIterator (const TDF_Label &aLabel, const Standard_Boolean allLevels=Standard_False)
	Constructs the iterator object defined by the label aLabel. Iterates on the children of the given label. If <allLevels> option is set to true, it explores not only the first, but all the sub label levels. More...

void	Initialize (const TDF_Label &aLabel, const Standard_Boolean allLevels=Standard_False)
	Initializes the iteration on the children of the given label. If <allLevels> option is set to true, it explores not only the first, but all the sub label levels. If allLevels is false, only the first level of child labels is explored. In the example below, the label is iterated using Initialize, More and Next and its child labels dumped using TDF_Tool::Entry. Example void DumpChildren(const TDF_Label& aLabel) { TDF_ChildIterator it; TCollection_AsciiString es; for (it.Initialize(aLabel,Standard_True); it.More(); it.Next()){ TDF_Tool::Entry(it.Value(),es); std::cout << as.ToCString() << std::endl; } }. More...

Standard_Boolean	More () const
	Returns true if a current label is found in the iteration process. More...

void	Next ()
	Move the current iteration to the next Item. More...

void	NextBrother ()
	Moves this iteration to the next brother label. A brother label is one with the same father as an initial label. Use this function when the non-empty constructor or Initialize has allLevels set to true. The result is that the iteration does not explore the children of the current label. This method is interesting only with "allLevels" behavior, because it avoids to explore the current label children. More...

const TDF_Label	Value () const
	Returns the current label; or, if there is none, a null label. More...

Detailed Description

Iterates on the children of a label, at the first level only. It is possible to ask the iterator to explore all the sub label levels of the given one, with the option "allLevels".

Constructor & Destructor Documentation

◆ TDF_ChildIterator() [1/2]

TDF_ChildIterator::TDF_ChildIterator ( )

Creates an empty iterator object to explore the children of a label.

◆ TDF_ChildIterator() [2/2]

TDF_ChildIterator::TDF_ChildIterator	(	const TDF_Label &	aLabel,
		const Standard_Boolean	allLevels = `Standard_False`
	)

Constructs the iterator object defined by the label aLabel. Iterates on the children of the given label. If <allLevels> option is set to true, it explores not only the first, but all the sub label levels.

Member Function Documentation

◆ Initialize()

void TDF_ChildIterator::Initialize	(	const TDF_Label &	aLabel,
		const Standard_Boolean	allLevels = `Standard_False`
	)

Initializes the iteration on the children of the given label. If <allLevels> option is set to true, it explores not only the first, but all the sub label levels. If allLevels is false, only the first level of child labels is explored. In the example below, the label is iterated using Initialize, More and Next and its child labels dumped using TDF_Tool::Entry. Example void DumpChildren(const TDF_Label& aLabel) { TDF_ChildIterator it; TCollection_AsciiString es; for (it.Initialize(aLabel,Standard_True); it.More(); it.Next()){ TDF_Tool::Entry(it.Value(),es); std::cout << as.ToCString() << std::endl; } }.

◆ More()

Standard_Boolean TDF_ChildIterator::More ( ) const

Returns true if a current label is found in the iteration process.

◆ Next()

void TDF_ChildIterator::Next ( )

Move the current iteration to the next Item.

◆ NextBrother()

void TDF_ChildIterator::NextBrother ( )

Moves this iteration to the next brother label. A brother label is one with the same father as an initial label. Use this function when the non-empty constructor or Initialize has allLevels set to true. The result is that the iteration does not explore the children of the current label. This method is interesting only with "allLevels" behavior, because it avoids to explore the current label children.

◆ Value()

const TDF_Label TDF_ChildIterator::Value ( ) const

Returns the current label; or, if there is none, a null label.

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

TDF_ChildIterator.hxx

Public Member Functions