|PathEngine home||previous: ||next: |
This method is called by PathEngine in the case of an error to perform application side error handling, normally by displaying or logging the error.
tSigned32 handle(const char* type, const char* description, const char *const* attributes);
|type||A C string specifying the type of error.|
|description||A C string containing a human readable description of the error.|
A set of context dependant attributes relating to the error.
The 'type' parameter indicates the severity of the error.
Some values to expect are:
Execution cannot continue following this error.
After the handler returns, pathengine may abort execution or trigger a crash.
An error has occurred but execution can continue in the code immediately after the handler returns.
The error reporting code will then usually return an error condition (such as a zero pointer) to calling code, however, and it is possible that this then triggers another error report (perhaps with a 'Fatal' error).
In some cases continuing after a 'NonFatal' error may result in execution returning from API interface methods but return a 0 pointer "NonFatal" or otherwise fail to perform the requested operation.
|"Warning"||This error is for information only, and execution can continue after the handler returns.|
A runtime assertion.
The action taken after the handler returns depends on the action code returned by the handler.
int handle(string type, string description, string attributes);
int handle(String type, String description, String attributes);
|Documentation for PathEngine release 5.35 - Copyright © 2002-2014 PathEngine||next: |