#include <cexception.h>

Description

Thrown when the simulation kernel or other components detect a runtime error.

For example, cSimpleModule::scheduleAt() throws this exception when the specified simulation time is in the past, or the message pointer is nullptr.

Inheritance diagram for cRuntimeError:

Public Member Functions
	cRuntimeError (ErrorCodeInt errcode,...)

	cRuntimeError (const char *msg,...)

	cRuntimeError (const cObject *where, ErrorCodeInt errcode,...)

	cRuntimeError (const cObject where, const char msg,...)

	cRuntimeError (const std::exception &e, const char *location)

	cRuntimeError (const cRuntimeError &e)

virtual cRuntimeError *	dup () const override

Public Member Functions inherited from cException
	cException (ErrorCodeInt errcode,...)

	cException (const char *msg,...)

	cException (const cObject *where, ErrorCodeInt errcode,...)

	cException (const cObject where, const char msg,...)

	cException (const cException &)=default

virtual	~cException () throw ()

virtual void	setMessage (const char *txt)

virtual void	prependMessage (const char *txt)

virtual bool	isError () const

virtual int	getErrorCode () const

virtual const char *	what () const override throw ()

virtual std::string	getFormattedMessage () const

virtual int	getSimulationStage () const

virtual eventnumber_t	getEventNumber () const

virtual simtime_t	getSimtime () const

virtual bool	hasContext () const

virtual const char *	getContextClassName () const

virtual const char *	getContextFullPath () const

virtual int	getContextComponentId () const

virtual int	getContextComponentKind () const

Additional Inherited Members
Protected Member Functions inherited from cException
void	init (const cObject *obj, ErrorCode errorcode, const std::string &msg)

Constructor & Destructor Documentation

◆ cRuntimeError() [1/6]

cRuntimeError	(	ErrorCodeInt	errcode,
			...
	)

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.

◆ cRuntimeError() [2/6]

cRuntimeError	(	const char *	msg,
			...
	)

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

◆ cRuntimeError() [3/6]

cRuntimeError	(	const cObject *	where,
		ErrorCodeInt	errcode,
			...
	)

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".

◆ cRuntimeError() [4/6]

cRuntimeError	(	const cObject *	where,
		const char *	msg,
			...
	)

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".

◆ cRuntimeError() [5/6]

cRuntimeError	(	const std::exception &	e,
		const char *	location
	)

Constructor for re-throwing an exception with location info.

◆ cRuntimeError() [6/6]

cRuntimeError ( const cRuntimeError & e )

inline

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

Member Function Documentation

◆ dup()

virtual cRuntimeError* dup ( ) const

inlineoverridevirtual

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 from cException.

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

cexception.h