|  |  |  | libuser Reference Manual |  | 
|---|---|---|---|---|
#define LU_ERROR_CHECK (err_p_p) void lu_error_new (lu_error_t **error, lu_status_t code, const char *fmt, ...); void lu_error_free (lu_error_t **error); gboolean lu_error_is_success (lu_status_t status); gboolean lu_error_is_warning (lu_status_t status); gboolean lu_error_is_error (lu_status_t status); const char* lu_strerror (lu_error_t *error);
error.h includes declarations for allocating and
manipulating lu_error structures.  These structures hold error and status
information passed between libuser, its modules, and applications.
A struct lu_error contains an error code and a human-readable, possibly
translated error string.  The error string is using the encoding specified
by LC_CTYPE locale category.
#define LU_ERROR_CHECK(err_p_p)
Checks that the given pointer to a pointer to a struct does not already point to a valid lu_error structure. This macro is used by many internal functions to check that an error has not already occurred when they are invoked.
| 
 | A pointer to a struct lu_error * which will be checked. If there | 
void                lu_error_new                        (lu_error_t **error,
                                                         lu_status_t code,
                                                         const char *fmt,
                                                         ...);
Creates a new lu_error structure.
void lu_error_free (lu_error_t **error);
Frees an lu_error structure.
| 
 | A pointer to a pointer to the structure to be freed. The pointer is set to NULL after the error is freed. | 
gboolean lu_error_is_success (lu_status_t status);
Check if the error code held by an error structure is a success code.
| 
 | An error code | 
| Returns : | a gboolean indicating whether or not the error is a success code. | 
gboolean lu_error_is_warning (lu_status_t status);
Check if the error code held by an error structure is a warning code.
| 
 | An error code | 
| Returns : | a gboolean indicating whether or not the error is a warning code. | 
gboolean lu_error_is_error (lu_status_t status);
Check if the error code held by an error structure is an error code.
| 
 | An error code | 
| Returns : | a gboolean indicating whether or not the error is an error code. | 
const char* lu_strerror (lu_error_t *error);
Converts an lu_error structure to a string describing the error.
If the error->string is NULL, returns a text representation of
 error->code.
| 
 | An error | 
| Returns : | error string valid at least until erroris freed. |