Interface_CheckIterator Class Reference

Result of a Check operation (especially from InterfaceModel) More...

#include <Interface_CheckIterator.hxx>

Public Member Functions
	Interface_CheckIterator ()
	Creates an empty CheckIterator.
	Interface_CheckIterator (const char *const name)
	Creates a CheckIterator with a name (displayed by Print as a title)
void	SetName (const char *const name)
	Sets / Changes the name.
const char *	Name () const
	Returns the recorded name (can be empty)
void	SetModel (const occ::handle< Interface_InterfaceModel > &model)
	Defines a Model, used to locate entities (not required, if it is absent, entities are simply less documented)
occ::handle< Interface_InterfaceModel >	Model () const
	Returns the stored model (can be a null handle)
void	Clear ()
	Clears the list of checks.
void	Merge (Interface_CheckIterator &other)
	Merges another CheckIterator into <me>, i.e. adds each of its Checks. Content of <other> remains unchanged. Takes also the Model but not the Name.
void	Add (const occ::handle< Interface_Check > &ach, const int num=0)
	Adds a Check to the list to be iterated This Check is Accompanied by Entity Number in the Model (0 for Global Check or Entity unknown in the Model), if 0 and Model is recorded in <me>, it is computed.
const occ::handle< Interface_Check > &	Check (const int num) const
	Returns the Check which was attached to an Entity given its Number in the Model. <num>=0 is for the Global Check. If no Check was recorded for this Number, returns an empty Check. Remark : Works apart from the iteration methods (no interference)
const occ::handle< Interface_Check > &	Check (const occ::handle< Standard_Transient > &ent) const
	Returns the Check attached to an Entity If no Check was recorded for this Entity, returns an empty Check. Remark : Works apart from the iteration methods (no interference)
occ::handle< Interface_Check > &	CCheck (const int num)
	Returns the Check bound to an Entity Number (0 : Global) in order to be consulted or completed on the spot I.e. returns the Check if is already exists, or adds it then returns the new empty Check.
occ::handle< Interface_Check > &	CCheck (const occ::handle< Standard_Transient > &ent)
	Returns the Check bound to an Entity, in order to be consulted or completed on the spot I.e. returns the Check if is already exists, or adds it then returns the new empty Check.
bool	IsEmpty (const bool failsonly) const
	Returns True if : no Fail has been recorded if <failsonly> is True, no Check at all if <failsonly> is False.
Interface_CheckStatus	Status () const
	Returns worst status among : OK, Warning, Fail.
bool	Complies (const Interface_CheckStatus status) const
	Tells if this check list complies with a given status : OK (i.e. empty), Warning (at least one Warning, but no Fail), Fail (at least one), Message (not OK), NoFail, Any.
Interface_CheckIterator	Extract (const Interface_CheckStatus status) const
	Returns a CheckIterator which contains the checks which comply with a given status Each check is added completely (no split Warning/Fail)
Interface_CheckIterator	Extract (const char *const mess, const int incl, const Interface_CheckStatus status) const
	Returns a CheckIterator which contains the check which comply with a message, plus some conditions as follows : <incl> = 0 : <mess> exactly matches one of the messages <incl> < 0 : <mess> is contained by one of the messages <incl> > 0 : <mess> contains one of the messages For <status> : for CheckWarning and CheckFail, considers only resp. Warning or Check messages. for CheckAny, considers all other values are ignored (answer will be false) Each Check which complies is entirely taken.
bool	Remove (const char *const mess, const int incl, const Interface_CheckStatus status)
	Removes the messages of all Checks, under these conditions : <incl> = 0 : <mess> exactly matches one of the messages <incl> < 0 : <mess> is contained by one of the messages <incl> > 0 : <mess> contains one of the messages For <status> : for CheckWarning and CheckFail, considers only resp. Warning or Check messages. for CheckAny, considers all other values are ignored (nothing is done) Returns True if at least one message has been removed, False else.
occ::handle< NCollection_HSequence< occ::handle< Standard_Transient > > >	Checkeds (const bool failsonly, const bool global) const
	Returns the list of entities concerned by a Check Only fails if <failsonly> is True, else all non-empty checks If <global> is true, adds the model for a global check Else, global check is ignored.
void	Start () const
	Starts Iteration. Thus, it is possible to restart it Remark : an iteration may be done with a const Iterator While its content is modified (through a pointer), this allows to give it as a const argument to a function.
bool	More () const
	Returns True if there are more Checks to get.
void	Next () const
	Sets Iteration to next Item.
const occ::handle< Interface_Check > &	Value () const
	Returns Check currently Iterated It brings all other information (status, messages, ...) The Number of the Entity in the Model is given by Number below.
int	Number () const
	Returns Number of Entity for the Check currently iterated or 0 for GlobalCheck.
void	Print (Standard_OStream &S, const bool failsonly, const int final=0) const
	Prints the list of Checks with their attached Numbers If <failsonly> is True, prints only Fail messages If <failsonly> is False, prints all messages If <final> = 0 (D), prints also original messages if different If <final> < 0, prints only original messages If <final> > 0, prints only final messages It uses the recorded Model if it is defined Remark : Works apart from the iteration methods (no interference)
void	Print (Standard_OStream &S, const occ::handle< Interface_InterfaceModel > &model, const bool failsonly, const int final=0) const
	Works as Print without a model, but for entities which have no attached number (Number not positive), tries to compute this Number from <model> and displays "original" or "computed".
void	Destroy ()
	Clears data of iteration.
	~Interface_CheckIterator ()

Detailed Description

Result of a Check operation (especially from InterfaceModel)

Constructor & Destructor Documentation

Interface_CheckIterator() [1/2]

Interface_CheckIterator::Interface_CheckIterator

(

)

Creates an empty CheckIterator.

Interface_CheckIterator() [2/2]

Interface_CheckIterator::Interface_CheckIterator

(

const char *const

name

)

Creates a CheckIterator with a name (displayed by Print as a title)

~Interface_CheckIterator()

Interface_CheckIterator::~Interface_CheckIterator ( )

inline

Member Function Documentation

Add()

void Interface_CheckIterator::Add	(	const occ::handle< Interface_Check > &	ach,
		const int	num = 0 )

Adds a Check to the list to be iterated This Check is Accompanied by Entity Number in the Model (0 for Global Check or Entity unknown in the Model), if 0 and Model is recorded in <me>, it is computed.

CCheck() [1/2]

occ::handle< Interface_Check > & Interface_CheckIterator::CCheck

(

const int

num

)

Returns the Check bound to an Entity Number (0 : Global) in order to be consulted or completed on the spot I.e. returns the Check if is already exists, or adds it then returns the new empty Check.

CCheck() [2/2]

occ::handle< Interface_Check > & Interface_CheckIterator::CCheck

(

const occ::handle< Standard_Transient > &

ent

)

Returns the Check bound to an Entity, in order to be consulted or completed on the spot I.e. returns the Check if is already exists, or adds it then returns the new empty Check.

Check() [1/2]

const occ::handle< Interface_Check > & Interface_CheckIterator::Check

(

const int

num

)

const

Returns the Check which was attached to an Entity given its Number in the Model. <num>=0 is for the Global Check. If no Check was recorded for this Number, returns an empty Check. Remark : Works apart from the iteration methods (no interference)

Check() [2/2]

const occ::handle< Interface_Check > & Interface_CheckIterator::Check

(

const occ::handle< Standard_Transient > &

ent

)

const

Returns the Check attached to an Entity If no Check was recorded for this Entity, returns an empty Check. Remark : Works apart from the iteration methods (no interference)

Checkeds()

occ::handle< NCollection_HSequence< occ::handle< Standard_Transient > > > Interface_CheckIterator::Checkeds	(	const bool	failsonly,
		const bool	global ) const

Returns the list of entities concerned by a Check Only fails if <failsonly> is True, else all non-empty checks If <global> is true, adds the model for a global check Else, global check is ignored.

Clear()

void Interface_CheckIterator::Clear

(

)

Clears the list of checks.

Complies()

bool Interface_CheckIterator::Complies

(

const Interface_CheckStatus

status

)

const

Tells if this check list complies with a given status : OK (i.e. empty), Warning (at least one Warning, but no Fail), Fail (at least one), Message (not OK), NoFail, Any.

Destroy()

void Interface_CheckIterator::Destroy

(

)

Clears data of iteration.

Extract() [1/2]

Interface_CheckIterator Interface_CheckIterator::Extract	(	const char *const	mess,
		const int	incl,
		const Interface_CheckStatus	status ) const

Returns a CheckIterator which contains the check which comply with a message, plus some conditions as follows : <incl> = 0 : <mess> exactly matches one of the messages <incl> < 0 : <mess> is contained by one of the messages <incl> > 0 : <mess> contains one of the messages For <status> : for CheckWarning and CheckFail, considers only resp. Warning or Check messages. for CheckAny, considers all other values are ignored (answer will be false) Each Check which complies is entirely taken.

Extract() [2/2]

Interface_CheckIterator Interface_CheckIterator::Extract

(

const Interface_CheckStatus

status

)

const

Returns a CheckIterator which contains the checks which comply with a given status Each check is added completely (no split Warning/Fail)

IsEmpty()

bool Interface_CheckIterator::IsEmpty

(

const bool

failsonly

)

const

Returns True if : no Fail has been recorded if <failsonly> is True, no Check at all if <failsonly> is False.

Merge()

void Interface_CheckIterator::Merge

(

Interface_CheckIterator &

other

)

Merges another CheckIterator into <me>, i.e. adds each of its Checks. Content of <other> remains unchanged. Takes also the Model but not the Name.

Model()

occ::handle< Interface_InterfaceModel > Interface_CheckIterator::Model

(

)

const

Returns the stored model (can be a null handle)

More()

bool Interface_CheckIterator::More

(

)

const

Returns True if there are more Checks to get.

Name()

const char * Interface_CheckIterator::Name

(

)

const

Returns the recorded name (can be empty)

Next()

void Interface_CheckIterator::Next

(

)

const

Sets Iteration to next Item.

Number()

int Interface_CheckIterator::Number

(

)

const

Returns Number of Entity for the Check currently iterated or 0 for GlobalCheck.

Print() [1/2]

void Interface_CheckIterator::Print	(	Standard_OStream &	S,
		const bool	failsonly,
		const int	final = 0 ) const

Prints the list of Checks with their attached Numbers If <failsonly> is True, prints only Fail messages If <failsonly> is False, prints all messages If <final> = 0 (D), prints also original messages if different If <final> < 0, prints only original messages If <final> > 0, prints only final messages It uses the recorded Model if it is defined Remark : Works apart from the iteration methods (no interference)

Print() [2/2]

void Interface_CheckIterator::Print	(	Standard_OStream &	S,
		const occ::handle< Interface_InterfaceModel > &	model,
		const bool	failsonly,
		const int	final = 0 ) const

Works as Print without a model, but for entities which have no attached number (Number not positive), tries to compute this Number from <model> and displays "original" or "computed".

Remove()

bool Interface_CheckIterator::Remove	(	const char *const	mess,
		const int	incl,
		const Interface_CheckStatus	status )

Removes the messages of all Checks, under these conditions : <incl> = 0 : <mess> exactly matches one of the messages <incl> < 0 : <mess> is contained by one of the messages <incl> > 0 : <mess> contains one of the messages For <status> : for CheckWarning and CheckFail, considers only resp. Warning or Check messages. for CheckAny, considers all other values are ignored (nothing is done) Returns True if at least one message has been removed, False else.

SetModel()

void Interface_CheckIterator::SetModel

(

const occ::handle< Interface_InterfaceModel > &

model

)

Defines a Model, used to locate entities (not required, if it is absent, entities are simply less documented)

SetName()

void Interface_CheckIterator::SetName

(

const char *const

name

)

Sets / Changes the name.

Start()

void Interface_CheckIterator::Start

(

)

const

Starts Iteration. Thus, it is possible to restart it Remark : an iteration may be done with a const Iterator While its content is modified (through a pointer), this allows to give it as a const argument to a function.

Status()

Interface_CheckStatus Interface_CheckIterator::Status

(

)

const

Returns worst status among : OK, Warning, Fail.

Value()

const occ::handle< Interface_Check > & Interface_CheckIterator::Value

(

)

const

Returns Check currently Iterated It brings all other information (status, messages, ...) The Number of the Entity in the Model is given by Number below.

---

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

• Interface_CheckIterator.hxx