cException Class Reference¶

Error is identified by an error code, and the message comes from a string table. The error string may expect printf-like arguments (s, d) which also have to be passed to the constructor.

To be called like printf(). The error code is set to E_CUSTOM.

Error is identified by an error code, and the message comes from a string table. The error string may expect printf-like arguments (s, d) which also have to be passed to the constructor. The 1st arg is the object where the error occurred: its class and object name will be prepended to the message like this: "(cArray)arr".

To be called like printf(). The error code is set to E_CUSTOM. The 1st arg is the object where the error occurred: its class and object name will be prepended to the message like this: "(cArray)arr".

References init().

Copy constructor. We unfortunately need to copy exception objects when handing them back from an activity() method.

Destructor.

Helper function for constructors: assembles and stores the message text. If the first arg is non-nullptr, the message text will be prepended (if needed) with the object type and name, like this: "(cArray)array: ..."

Referenced by cException(), cRuntimeError::cRuntimeError(), and cTerminationException::cTerminationException().

Creates and returns an exact copy of this object. We unfortunately need to copy exception objects when handing them back from an activity() method.

Reimplemented in cDeleteModuleException, cRuntimeError, cStackCleanupException, and cTerminationException.

Overwrites the message text with the given one.

Prefixes the message with the given printf-like formatted text.

References prependMessage().

Referenced by prependMessage().

Appends the given printf-like formatted text to the message.

References appendMessage().

Referenced by appendMessage().

Whether the exception represents an error or a normal (non-error) terminating condition (e.g. "Simulation completed").

Reimplemented in cDeleteModuleException, cStackCleanupException, and cTerminationException.

References isError().

Referenced by isError().

Returns the error code.

Returns the text of the error. Redefined from std::exception.

Returns a formatted message that includes the "Error" word, context information, the event number and simulation time if available and relevant, in addition to the exception message (what()).

Returns in which stage of the simulation the exception object was created: during network building (CTX_BUILD), network initialization (CTX_INITIALIZE), simulation execution (CTX_EVENT), finalization (CTX_FINISH), or network cleanup (CTX_CLEANUP).

Returns the event number at the creation of the exception object.

Returns the simulation time at the creation of the exception object.

Returns true if the exception has "context info", that is, it occurred within a known module or channel. getContextClassName(), getContextFullPath() and getContextComponentId() may only be called if this method returns true.

Returns the class name (NED type name) of the component in context when the exception occurred.

Returns the full path of the component in context when the exception occurred.

Returns the ID of the component in context when the exception occurred, or -1 if there was no component in context. The component may not exist any more when the exception is caught (ie. if the exception occurs during network setup, the network is cleaned up immediately).

Returns the kind of the component in context when the exception occurred. (The return value can be safely cast to cComponent::ComponentKind.)