Module error

enum box_error_code¶: For a complete list of errors, refer to the Tarantool error code header file.

type box_error_t¶: Error – contains information about error.

const char *box_error_type(const box_error_t *error)¶

Return the error type, e.g. “ClientError”, “SocketError”, etc.

Parameters:	error (box_error_t*) – error
Returns:	not-null string

uint32_t box_error_code(const box_error_t *error)

Return IPROTO error code

Parameters:	error (box_error_t*) – error
Returns:	box_error_code

const char *box_error_message(const box_error_t *error)¶

Return the error message

Parameters:	error (box_error_t*) – error
Returns:	not-null string

box_error_t *box_error_last(void)¶

Get the information about the last API call error.

The Tarantool error handling works most like libc’s errno. All API calls return -1 or NULL in the event of error. An internal pointer to box_error_t type is set by API functions to indicate what went wrong. This value is only significant if API call failed (returned -1 or NULL).

Successful function can also touch the last error in some cases. You don’t have to clear the last error before calling API functions. The returned object is valid only until next call to any API function.

You must set the last error using box_error_set() in your stored C procedures if you want to return a custom error message. You can re-throw the last API error to IPROTO client by keeping the current value and returning -1 to Tarantool from your stored procedure.

Returns:	last error

void box_error_clear(void)¶: Clear the last error.

int box_error_set(const char *file, unsigned line, uint32_t code, const char *format, ...)¶

Set the last error.

Parameters:	file (const char) – line* (unsigned) – code (uint32_t) – IPROTO error code format (const char) – ...* – format arguments

Version:

Module error