1 /* gerror.h - Error reporting system
3 * Copyright 2000 Red Hat, Inc.
5 * The Gnome Library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public License as
7 * published by the Free Software Foundation; either version 2 of the
8 * License, or (at your option) any later version.
10 * The Gnome Library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with the Gnome Library; see the file COPYING.LIB. If not,
17 * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 * Boston, MA 02111-1307, USA.
21 #if defined(G_DISABLE_SINGLE_INCLUDES) && !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
22 #error "Only <glib.h> can be included directly."
28 #include <glib/gquark.h>
32 typedef struct _GError GError;
41 GError* g_error_new (GQuark domain,
44 ...) G_GNUC_PRINTF (3, 4);
46 GError* g_error_new_literal (GQuark domain,
48 const gchar *message);
50 void g_error_free (GError *error);
51 GError* g_error_copy (const GError *error);
53 gboolean g_error_matches (const GError *error,
57 /* if (err) *err = g_error_new(domain, code, format, ...), also has
60 void g_set_error (GError **err,
64 ...) G_GNUC_PRINTF (4, 5);
66 /* if (dest) *dest = src; also has some sanity checks.
68 void g_propagate_error (GError **dest,
71 /* if (err && *err) { g_error_free(*err); *err = NULL; } */
72 void g_clear_error (GError **err);
74 /* if (err) prefix the formatted string to the ->message */
75 void g_prefix_error (GError **err,
77 ...) G_GNUC_PRINTF (2, 3);
79 /* g_propagate_error then g_error_prefix on dest */
80 void g_propagate_prefixed_error (GError **dest,
83 ...) G_GNUC_PRINTF (3, 4);
87 #endif /* __G_ERROR_H__ */