/* gerror.h - Error reporting system

  *

  *  Copyright 2000 Red Hat, Inc.

  * Portions copyright (c) 2006 Nokia Corporation.  All rights reserved.

  *

  * The Gnome Library is free software; you can redistribute it and/or

  * modify it under the terms of the GNU Lesser General Public License as

  * published by the Free Software Foundation; either version 2 of the

  * License, or (at your option) any later version.

  *

  * The Gnome Library is distributed in the hope that it will be useful,

  * but WITHOUT ANY WARRANTY; without even the implied warranty of

  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

  * Lesser General Public License for more details.

  *

  * You should have received a copy of the GNU Lesser General Public

  * License along with the Gnome Library; see the file COPYING.LIB.  If not,

  * write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,

  *   Boston, MA 02111-1307, USA.

  */

 #ifndef __G_ERROR_H__

 #define __G_ERROR_H__

 #include <_ansi.h>

 #include <glib/gquark.h>

 G_BEGIN_DECLS

 typedef struct _GError GError;

 struct _GError

 {

   GQuark       domain;

   gint         code;

   gchar       *message;

 };

 IMPORT_C GError*  g_error_new           (GQuark         domain,

                                 gint           code,

                                 const gchar   *format,

                                 ...) G_GNUC_PRINTF (3, 4);

 IMPORT_C GError*  g_error_new_literal   (GQuark         domain,

                                 gint           code,

                                 const gchar   *message);

 IMPORT_C void     g_error_free          (GError        *error);

 IMPORT_C GError*  g_error_copy          (const GError  *error);

 IMPORT_C gboolean g_error_matches       (const GError  *error,

                                 GQuark         domain,

                                 gint           code);

 /* if (err) *err = g_error_new(domain, code, format, ...), also has

  * some sanity checks.

  */

 IMPORT_C void     g_set_error           (GError       **err,

                                 GQuark         domain,

                                 gint           code,

                                 const gchar   *format,

                                 ...) G_GNUC_PRINTF (4, 5);

 /* if (dest) *dest = src; also has some sanity checks.

  */

 IMPORT_C void     g_propagate_error     (GError       **dest,

 				GError        *src);

 /* if (err && *err) { g_error_free(*err); *err = NULL; } */

 IMPORT_C void     g_clear_error         (GError       **err);

 G_END_DECLS

 #endif /* __G_ERROR_H__ */