3.3.4 Obtaining Information about Errors

char * xsb_get_init_error_message()

Used to find error messages if xsb_init_string() or xsb_init() returns XSB_ERROR. Any errors returned by these functions have type init_error. Because initialization errors occur before XSB or any of its threads have been initialized, initialization errors do not require a thread context for input.

char * xsb_get_error_type(th_context *th)

If a function called for th returned XSB_ERROR this function provides a pointer to a string representing the type of the error. Types are as in Volume 1 Exception Handling with the addition of init_error for errors that occur during initialization of XSB, and unrecoverable_error for errors from which no recovery is possible for XSB (e.g. inability to allocate new memory).

char *xsb_get_error_message(th_context *th)

If a function called for th returned XSB_ERROR this function provides a pointer to a string representing a message associated with the error. For errors raised within the Prolog portion of execution, messages are as in Volume 1 Exception Handling.