GdaError

GdaError — Management of errors

Synopsis




                    GdaErrorPrivate;
GdaError*           gda_error_new                       (void);
void                gda_error_free                      (GdaError *error);
GList*              gda_error_list_copy                 (const GList *errors);
void                gda_error_list_free                 (GList *errors);
const gchar*        gda_error_get_description           (GdaError *error);
void                gda_error_set_description           (GdaError *error,
                                                         const gchar *description);
glong               gda_error_get_number                (GdaError *error);
void                gda_error_set_number                (GdaError *error,
                                                         glong number);
const gchar*        gda_error_get_source                (GdaError *error);
void                gda_error_set_source                (GdaError *error,
                                                         const gchar *source);
const gchar*        gda_error_get_sqlstate              (GdaError *error);
void                gda_error_set_sqlstate              (GdaError *error,
                                                         const gchar *sqlstate);

Description

Details

GdaErrorPrivate

typedef struct _GdaErrorPrivate GdaErrorPrivate;


gda_error_new ()

GdaError*           gda_error_new                       (void);

Returns :

gda_error_free ()

void                gda_error_free                      (GdaError *error);

Frees the memory allocated by the error object.

error : the error object.

gda_error_list_copy ()

GList*              gda_error_list_copy                 (const GList *errors);

Creates a new list which contains the same errors as errors and adds a reference for each error in the list.

You must free the list using gda_error_list_free.

errors : a GList holding error objects.
Returns : a list of errors.

gda_error_list_free ()

void                gda_error_list_free                 (GList *errors);

Frees all error objects in the list and the list itself. After this function has been called, the errors parameter doesn't point to valid storage any more.

errors : a GList holding error objects.

gda_error_get_description ()

const gchar*        gda_error_get_description           (GdaError *error);

error : a GdaError.
Returns : error's description.

gda_error_set_description ()

void                gda_error_set_description           (GdaError *error,
                                                         const gchar *description);

Sets error's description.

error : a GdaError.
description : a description.

gda_error_get_number ()

glong               gda_error_get_number                (GdaError *error);

error : a GdaError.
Returns : error's number.

gda_error_set_number ()

void                gda_error_set_number                (GdaError *error,
                                                         glong number);

Sets error's number.

error : a GdaError.
number : a number.

gda_error_get_source ()

const gchar*        gda_error_get_source                (GdaError *error);

error : a GdaError.
Returns : error's source.

gda_error_set_source ()

void                gda_error_set_source                (GdaError *error,
                                                         const gchar *source);

Sets error's source.

error : a GdaError.
source : a source.

gda_error_get_sqlstate ()

const gchar*        gda_error_get_sqlstate              (GdaError *error);

error : a GdaError.
Returns : error's SQL state.

gda_error_set_sqlstate ()

void                gda_error_set_sqlstate              (GdaError *error,
                                                         const gchar *sqlstate);

Sets error's SQL state.

error : a GdaError.
sqlstate : SQL state.