name: Error

synopsis:

 
g++ [flags ...] file ... -l /isip/tools/lib/$ISIP_BINARY/lib_system.a

#include <Error.h>

static boolean handle(const SysString& cname, const SysString& mname, long ecode, char* file, long line, EXIT level = DEF_EXIT, SysString& extras = DEF_EXTRAS);
static boolean set(EXIT exit_level);
static boolean reset();
quick start:

Error::debug(L"testing reset & warning");

// release the setting
//
Error::reset();

// set the mode to never exit, try a regular error
//
Error::set(Error::NONE);
Error::handle(Error::name(), L"error, still no exit", Error::TEST, __FILE__, __LINE__);
description:

The Error class is designed to provide a unified exception notification and exit point for all software. Everything in the class is static, so there is only one way to handle errors in a program. This class will never be instantiated, so the static member functions are the only available interface.

Error codes are unique across the entire ISIP environment and have been divided into two groups: (1) those which can easily be recovered from (known as warnings) and (2) unrecoverable errors. This division allows the highest level programs (presumably, main programs) to fully dictate the error behavior so they can ignore warnings.

To keep error codes unique across the entire ISIP environment, each library is assigned a range of 10000 error codes and each class in a library is assigned one or more blocks of 100 error codes. All of the
error codes have corresponding detailed messages in the same class.

dependencies:

public constants:

error codes:

protected data:

required public methods:

class-specific public methods:

private methods:

examples:

notes: