Open CASCADE Technology  6.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
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_InterfaceModel Model () 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 <br>
     Number in the Model. <num>=0 is for the Global Check. <br>
     If no Check was recorded for this Number, returns an empty <br>
     Check. <br>

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 <br>
     If no Check was recorded for this Entity, returns an empty <br>
     Check. <br>

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 <br>
     If <failsonly> is True, prints only Fail messages <br>
     If <failsonly> is False, prints all messages <br>
     If <final> = 0 (D), prints also original messages if different <br>
     If <final> < 0, prints only original messages <br>
     If <final> > 0, prints only final messages <br>
     It uses the recorded Model if it is defined <br>

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

Creates an empty CheckIterator

Interface_CheckIterator::Interface_CheckIterator ( const Standard_CString  name)

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

Interface_CheckIterator::~Interface_CheckIterator ( )
inline

Member Function Documentation

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

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

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

const Handle_Interface_Check& Interface_CheckIterator::Check ( const Standard_Integer  num) const

Returns the Check which was attached to an Entity given its <br>
     Number in the Model. <num>=0 is for the Global Check. <br>
     If no Check was recorded for this Number, returns an empty <br>
     Check. <br>

Remark : Works apart from the iteration methods (no interference)

const Handle_Interface_Check& Interface_CheckIterator::Check ( const Handle< Standard_Transient > &  ent) const

Returns the Check attached to an Entity <br>
     If no Check was recorded for this Entity, returns an empty <br>
     Check. <br>

Remark : Works apart from the iteration methods (no interference)

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

void Interface_CheckIterator::Clear ( )

Clears the list of checks

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

void Interface_CheckIterator::Destroy ( )

Clears data of iteration

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)

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

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

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

Handle_Interface_InterfaceModel Interface_CheckIterator::Model ( ) const

Returns the stored model (can be a null handle)

Standard_Boolean Interface_CheckIterator::More ( ) const

Returns True if there are more Checks to get

Standard_CString Interface_CheckIterator::Name ( ) const

Returns the recorded name (can be empty)

void Interface_CheckIterator::Next ( ) const

Sets Iteration to next Item

Standard_Integer Interface_CheckIterator::Number ( ) const

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

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 <br>
     If <failsonly> is True, prints only Fail messages <br>
     If <failsonly> is False, prints all messages <br>
     If <final> = 0 (D), prints also original messages if different <br>
     If <final> < 0, prints only original messages <br>
     If <final> > 0, prints only final messages <br>
     It uses the recorded Model if it is defined <br>

Remark : Works apart from the iteration methods (no interference)

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"

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

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)

void Interface_CheckIterator::SetName ( const Standard_CString  name)

Sets / Changes the name

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

Interface_CheckStatus Interface_CheckIterator::Status ( ) const

Returns worst status among : OK, Warning, Fail

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: