Detailed Description

Exceptions support (C)

Those fonctions are used to throw C++ exceptions from C code. This feature should probably be removed in the future because C and exception do not exactly play nicely together.

Classes
class	xbt_ex
	A legacy exception. More...

Macros
#define	THROW(c, v)
	Builds and throws an exception. More...

#define	THROWF(c, v, ...)
	Builds and throws an exception with a printf-like formatted message. More...

#define	THROW_IMPOSSIBLE xbt_throw_impossible(__FILE__, __LINE__, __func__)
	Throw an exception because something impossible happened. More...

#define	DIE_IMPOSSIBLE xbt_die("The Impossible Did Happen (yet again)")
	Die because something impossible happened. More...

Enumerations
enum	xbt_errcat_t { unknown_error = 0, arg_error, bound_error, mismatch_error, not_found_error, system_error, network_error, timeout_error, cancel_error, thread_error, host_error, tracing_error, io_error, vm_error }
	Categories of errors. More...

Functions
const char *	xbt_ex_catname (xbt_errcat_t cat)
	Get the name of a category. More...

void	xbt_throw_unimplemented (const char file, int line, const char func)
	Throw an exception because something unimplemented stuff has been attempted. More...

Macro Definition Documentation

◆ THROW

#define THROW	(	c,
		v
	)

Builds and throws an exception.

◆ THROWF

#define THROWF	(	c,
		v,
		...
	)

Builds and throws an exception with a printf-like formatted message.

◆ THROW_IMPOSSIBLE

#define THROW_IMPOSSIBLE xbt_throw_impossible(__FILE__, __LINE__, __func__)

Throw an exception because something impossible happened.

◆ DIE_IMPOSSIBLE

#define DIE_IMPOSSIBLE xbt_die("The Impossible Did Happen (yet again)")

Die because something impossible happened.

Enumeration Type Documentation

◆ xbt_errcat_t

enum xbt_errcat_t

Categories of errors.

This very similar to std::error_catgory and should probably be replaced by this in the future.

Enumerator
unknown_error	unknown error
arg_error	Invalid argument.
bound_error	Out of bounds argument.
mismatch_error	The provided ID does not match.
not_found_error	The searched element was not found.
system_error	a syscall did fail
network_error	error while sending/receiving data
timeout_error	not quick enough, dude
cancel_error	an action was canceled
thread_error	error while [un]locking
host_error	host failed
tracing_error	error during the simulation tracing
io_error	disk or file error
vm_error	vm error

Function Documentation

◆ xbt_ex_catname()

const char* xbt_ex_catname ( xbt_errcat_t cat )

Get the name of a category.

◆ xbt_throw_unimplemented()

void xbt_throw_unimplemented	(	const char *	file,
		int	line,
		const char *	func
	)

Throw an exception because something unimplemented stuff has been attempted.