Open CASCADE Technology  7.4.0
Public Member Functions

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. More...
 
 Interface_CheckIterator (const Standard_CString name)
 Creates a CheckIterator with a name (displayed by Print as a title) More...
 
void SetName (const Standard_CString name)
 Sets / Changes the name. More...
 
Standard_CString Name () const
 Returns the recorded name (can be empty) More...
 
void SetModel (const Handle< Interface_InterfaceModel > &model)
 Defines a Model, used to locate entities (not required, if it is absent, entities are simply less documented) More...
 
Handle< Interface_InterfaceModelModel () const
 Returns the stored model (can be a null handle) More...
 
void Clear ()
 Clears the list of checks. More...
 
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. More...
 
void Add (const Handle< Interface_Check > &ach, const Standard_Integer 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. More...
 
const Handle< Interface_Check > & Check (const Standard_Integer 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) More...
 
const Handle< Interface_Check > & Check (const 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) More...
 
Handle< Interface_Check > & CCheck (const Standard_Integer 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. More...
 
Handle< Interface_Check > & CCheck (const 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. More...
 
Standard_Boolean IsEmpty (const Standard_Boolean failsonly) const
 Returns True if : no Fail has been recorded if <failsonly> is True, no Check at all if <failsonly> is False. More...
 
Interface_CheckStatus Status () const
 Returns worst status among : OK, Warning, Fail. More...
 
Standard_Boolean 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. More...
 
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) More...
 
Interface_CheckIterator Extract (const Standard_CString mess, const Standard_Integer 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. More...
 
Standard_Boolean Remove (const Standard_CString mess, const Standard_Integer 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. More...
 
Handle< TColStd_HSequenceOfTransient > Checkeds (const Standard_Boolean failsonly, const Standard_Boolean 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. More...
 
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. More...
 
Standard_Boolean More () const
 Returns True if there are more Checks to get. More...
 
void Next () const
 Sets Iteration to next Item. More...
 
const Handle< Interface_Check > & Value () const
 Returns Check currently Iterated It brings all other informations (status, messages, ...) The Number of the Entity in the Model is given by Number below. More...
 
Standard_Integer Number () const
 Returns Number of Entity for the Check currently iterated or 0 for GlobalCheck. More...
 
void Print (const Handle< Message_Messenger > &S, const Standard_Boolean failsonly, const Standard_Integer 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) More...
 
void Print (const Handle< Message_Messenger > &S, const Handle< Interface_InterfaceModel > &model, const Standard_Boolean failsonly, const Standard_Integer 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". More...
 
void Destroy ()
 Clears data of iteration. More...
 
 ~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 Standard_CString  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 Handle< Interface_Check > &  ach,
const Standard_Integer  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]

Handle< Interface_Check >& Interface_CheckIterator::CCheck ( const Standard_Integer  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]

Handle< Interface_Check >& Interface_CheckIterator::CCheck ( const 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 Handle< Interface_Check >& Interface_CheckIterator::Check ( const Standard_Integer  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 Handle< Interface_Check >& Interface_CheckIterator::Check ( const 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()

Handle< TColStd_HSequenceOfTransient > Interface_CheckIterator::Checkeds ( const Standard_Boolean  failsonly,
const Standard_Boolean  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()

Standard_Boolean 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 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)

◆ Extract() [2/2]

Interface_CheckIterator Interface_CheckIterator::Extract ( const Standard_CString  mess,
const Standard_Integer  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.

◆ IsEmpty()

Standard_Boolean Interface_CheckIterator::IsEmpty ( const Standard_Boolean  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()

Handle< Interface_InterfaceModel > Interface_CheckIterator::Model ( ) const

Returns the stored model (can be a null handle)

◆ More()

Standard_Boolean Interface_CheckIterator::More ( ) const

Returns True if there are more Checks to get.

◆ Name()

Standard_CString Interface_CheckIterator::Name ( ) const

Returns the recorded name (can be empty)

◆ Next()

void Interface_CheckIterator::Next ( ) const

Sets Iteration to next Item.

◆ Number()

Standard_Integer Interface_CheckIterator::Number ( ) const

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

◆ Print() [1/2]

void Interface_CheckIterator::Print ( const Handle< Message_Messenger > &  S,
const Standard_Boolean  failsonly,
const Standard_Integer  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 ( const Handle< Message_Messenger > &  S,
const Handle< Interface_InterfaceModel > &  model,
const Standard_Boolean  failsonly,
const Standard_Integer  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()

Standard_Boolean Interface_CheckIterator::Remove ( const Standard_CString  mess,
const Standard_Integer  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 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 Standard_CString  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 Handle< Interface_Check >& Interface_CheckIterator::Value ( ) const

Returns Check currently Iterated It brings all other informations (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: