Exception Class Reference

#include <evo/impl/sys.h>

Inheritance diagram for Exception:

Detailed Description

Evo base exception class.

• Use EVO_THROW() or EVO_THROW_ERR() macro to throw an Evo exception
• See EVO_CREATE_EXCEPTION() for creating a custom Evo exception type

Public Types
typedef ListBase< char, StrSizeT >	StringBase
	Alias for evo::StringBase. More...

Public Member Functions
	Exception (const char *file, ulong line, const StringBase &msg, Error error=EUnknown)
	Constructor with file/line info. More...
	Exception (const Exception &e)
	Copy constructor. More...
	~Exception ()
	Destructor. More...
Error	error () const
	Get error code. More...
template<class TOut >
TOut &	errormsg_out (TOut &out)
	Write error message with errno to output stream/string. More...
const char *	file () const
	Get exception file name. More...
ulong	line () const
	Get exception line number. More...
const char *	msg () const
	Get exception message. More...

Protected Types
typedef const char *(*	ErrorMsgFunc) (Error)
	Pointer type to function returning error message from error code. More...

Protected Member Functions
	Exception (const char *file, ulong line, const char *type, const StringBase &msg, Error error, ErrorMsgFunc errmsg_func)
	Constructor with exception type. More...

Member Typedef Documentation

ErrorMsgFunc

typedef const char*(* ErrorMsgFunc) (Error)

protected

Pointer type to function returning error message from error code.

StringBase

typedef ListBase<char,StrSizeT> StringBase

Alias for evo::StringBase.

Constructor & Destructor Documentation

Exception() [1/3]

Exception ( const char *  file, ulong  line, const StringBase &  msg, Error  error = EUnknown  )

inline

Constructor with file/line info.

• Use EVO_THROW() or EVO_THROW_ERR() macro to throw exception and automatically populate the file/line info

Parameters

file	Exception file name (use FILE macro)
line	Exception line number (use LINE macro)
msg	Exception message
error	Error code, EUnknown if unknown

Exception() [2/3]

Exception ( const Exception &  e )

inline

Copy constructor.

Parameters

e	Exception to copy

~Exception()

~Exception ( )

inline

Destructor.

Exception() [3/3]

Exception ( const char *  file, ulong  line, const char *  type, const StringBase &  msg, Error  error, ErrorMsgFunc  errmsg_func  )

inlineprotected

Constructor with exception type.

Use EVO_THROW() or EVO_THROW_E() macro to throw exception.

Parameters

file	Exception file name
line	Exception line number
type	Exception type as string, used as msg prefix
msg	Exception message
error	Error code, EUnknown if unknown
errmsg_func	Error message function to use

Member Function Documentation

error()

Error error ( ) const

inline

Get error code.

Returns

Error code, 0 if unknown

errormsg_out()

TOut& errormsg_out ( TOut &  out )

inline

Write error message with errno to output stream/string.

• Must call right after the error, otherwise errno may be overwritten

Template Parameters

TOut	Output stream or string type

Parameters

out	Stream or String to write output to

Returns

This

file()

const char* file ( ) const

inline

Get exception file name.

Returns

File name

line()

ulong line ( ) const

inline

Get exception line number.

Returns

Line number

msg()

const char* msg ( ) const

inline

Get exception message.

Returns

Message

---

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

• evo/impl/sys.h