#include <lstind_err_info.hxx>
Public Member Functions | |
| void | add () |
| Increments the use count. | |
| void | add_entities (const ENTITY_LIST &entities) |
Adds entities to this error_info, if not already there. | |
| void | add_entity (ENTITY *ent) |
Adds an entity to this error_info, if not already there. | |
| char const * | error_message () const |
Returns the message string of the error that this error_info_base object is encapsulating. | |
| err_mess_type | error_number () const |
Returns the error number of the error that this error_info_base object is encapsulating. | |
| i_aux_data_holder * | get_aux_data () const |
Queries the auxiliary data provided by this error_info object. | |
| void | get_entities_alive (ENTITY_LIST &entities) const |
Adds all the alive entities that belong to this error_info to the incoming list of ENTITYs. | |
| int const * | get_error_indices () const |
| Returns the list of error indices. | |
| int | get_num_error_indices () const |
| Returns the number of error indices. | |
| logical | has_reasons () const |
Returns TRUE if this error_info_base object has at least one reason; returns FALSE otherwise. | |
| list_index_error_info (int num_error_indices, int *error_indices, err_mess_type err_mess, spa_outcome_severity_type err_severity) | |
C++ constructor to construct an list_index_error_info object with the specified error number, error severity and a list of entities. | |
| void | reasons (error_info_base_list &err_reasons) const |
Adds all the reasons of this error_info_base into the given list, err_reasons. | |
| void | reasons (error_info_list &err_reasons) const |
Adds all the reasons of this error_info to the given list, err_reasons. | |
| void | remove () |
| Decrements the use count. | |
| spa_outcome_severity_type | severity () const |
Returns the severity of the error that this error_info_base object is encapsulating. | |
| virtual int | type () const |
| Returns the id number for whichever class this object happens to be. | |
Static Public Member Functions | |
| static int | id () |
Returns the id number for the class list_index_error_info. | |
Role: This class is derived from error_info and additionally stores an integer array. list_index_error_info is specifically designed to hold an array of integers in addition to the error number and severity that is represented by error_info. This class can be used by those APIs that want to return error information specifying a list of integers in their outcome; for instance, in order to notify failing members of an input list or array.
| list_index_error_info::list_index_error_info | ( | int | num_error_indices, | |
| int * | error_indices, | |||
| err_mess_type | err_mess, | |||
| spa_outcome_severity_type | err_severity | |||
| ) |
C++ constructor to construct an list_index_error_info object with the specified error number, error severity and a list of entities.
| err_mess | err_mess_type indicating the error. | |
| err_severity | error severity |
| void error_info_base::add | ( | ) | [inherited] |
Increments the use count.
Customers should only have to pay attention to use counting if they explicitly call add.
| void error_info::add_entities | ( | const ENTITY_LIST & | entities | ) | [inherited] |
Adds entities to this error_info, if not already there.
Any dead entity in the given list would not get added.
| entities | ENTITY_LIST to add |
| void error_info::add_entity | ( | ENTITY * | ent | ) | [inherited] |
Adds an entity to this error_info, if not already there.
| ent | pointer to an ENTITY that is to be added. This should not point to a NULL or a dead entity. |
| char const* error_info_base::error_message | ( | ) | const [inherited] |
Returns the message string of the error that this error_info_base object is encapsulating.
| err_mess_type error_info_base::error_number | ( | ) | const [inherited] |
Returns the error number of the error that this error_info_base object is encapsulating.
| i_aux_data_holder* error_info::get_aux_data | ( | ) | const [inherited] |
Queries the auxiliary data provided by this error_info object.
Returns NULL if no additional/auxiliary information is available. Note that the object (i.e., the i_aux_data_holder) returned by this function is owned by the caller and the memory needs to be cleaned up after use.
| void error_info::get_entities_alive | ( | ENTITY_LIST & | entities | ) | const [inherited] |
Adds all the alive entities that belong to this error_info to the incoming list of ENTITYs.
Note that this method does not clear the given list of entities.
| entities | ENTITY_LIST to which the alive entities are added. |
| int const* list_index_error_info::get_error_indices | ( | ) | const |
Returns the list of error indices.
| int list_index_error_info::get_num_error_indices | ( | ) | const |
Returns the number of error indices.
| logical error_info_base::has_reasons | ( | ) | const [inherited] |
Returns TRUE if this error_info_base object has at least one reason; returns FALSE otherwise.
| static int list_index_error_info::id | ( | ) | [static] |
| void error_info_base::reasons | ( | error_info_base_list & | err_reasons | ) | const [inherited] |
Adds all the reasons of this error_info_base into the given list, err_reasons.
In some cases, an error_info_base may need to provide some additional information about the errors or problems that would have caused the error that is indicated by this error_info_base object. These additional errors and problems are stored as reasons. For example, an error_info_base object encapsulating the error 'Operation failed due to check errors' might include the list of check errors in the 'reasons' list.
| err_reasons | error_info_base_list to which the reasons are added. |
| void error_info::reasons | ( | error_info_list & | err_reasons | ) | const [inherited] |
Adds all the reasons of this error_info to the given list, err_reasons.
In some cases, error_info may need to provide some additional information about the errors or problems that would have caused the error that is indicated by this error_info object. These additional errors and problems are stored as 'reasons'. For example, an error_info object encapsulating the error 'Operation failed due to check errors' might include the list of check errors in the 'reasons' list.
| err_reasons | error_info_list to which the reasons are added |
| void error_info_base::remove | ( | ) | [inherited] |
Decrements the use count.
Customers should only have to pay attention to use counting if they explicitly call add.
| spa_outcome_severity_type error_info_base::severity | ( | ) | const [inherited] |
Returns the severity of the error that this error_info_base object is encapsulating.
| virtual int list_index_error_info::type | ( | ) | const [virtual] |
Returns the id number for whichever class this object happens to be.
If this object is of the class list_index_error_info, then the id number returned by this function would be equal to the one returned by list_index_error_info::id().
Reimplemented from error_info.