PK_ERROR_sf_t   

struct PK_ERROR_sf
    {
    char function[PK_max_token_size];      --- name of PK function in which
                                           --- error occurred
    PK_ERROR_code_t code;                  --- error code
    char code_token[PK_max_token_size];    --- name of error code
    PK_ERROR_severity_t severity;          --- none, mild, serious or fatal
    int argument_number;                   --- number of invalid argument or 0
    char argument_name[PK_max_token_size]; --- argument name if arg no != 0
    int argument_index;                    --- if arg no != 0 and argument
                                           --- is an array, the array index
                                           --- where the checking failed
    PK_ENTITY_t entity;                    --- entity to which error applies or
                                           --- PK_ENTITY_null
    };
typedef struct PK_ERROR_sf PK_ERROR_sf_t;


This data structure is the standard form for an error record used for reporting
errors to application code.

Used in:

PK_ERROR_ask_last
PK_ERROR_frustrum_t
PK_ERROR_raise
PK_THREAD_ask_last_error


This is used to pass information to the application supplied error handler
and from PK_ERROR_ask_last and PK_THREAD_ask_last_error.

If there have been no errors, or the last error has been cleared, 'function'
will be the name of the PK function that asked for the last error, 'code' will
be PK_ERROR_no_errors and 'severity' will be PK_ERROR_none.