error.c File Reference

Display error message. More...

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <stdarg.h>
#include <gtk/gtk.h>
#include "rox.h"
#include "error.h"
#include "rox-clib.h"

Functions

void rox_error_init (void)
void rox_error (const char *fmt,...)
void rox_error_report_gerror (GError *err, int del)
void rox_error_queue (GError *err)
gboolean rox_error_queue_empty (void)
GError * rox_error_queue_peek (void)
GError * rox_error_queue_fetch (void)
GError * rox_error_queue_peek_last (void)
GError * rox_error_queue_fetch_last (void)
void rox_error_queue_flush (void)
void rox_error_queue_report (void)

Variables

GQuark rox_error_quark = 0


Detailed Description

Display error message.


Function Documentation

void rox_error ( const char *  fmt,
  ... 
)

Display an error message in a modal dialogue box.

Parameters:
[in] fmt printf-style format string, followed by the arguments, to generate the message

void rox_error_init ( void   ) 

Initialize error system. This is called by rox_init_with_domain() and should not be called directly.

void rox_error_queue ( GError *  err  ) 

Push an error onto the end of the error queue. ROX-CLib assumes responsibilty for deleting the error.

Parameters:
[in] err error to queue

gboolean rox_error_queue_empty ( void   ) 

Returns:
TRUE if the are no errors in the queue.

GError* rox_error_queue_fetch ( void   ) 

Return the error at the head of the error queue and remove it from the queue. The caller assumes responsibilty for deleting the error.

Returns:
error, or NULL if no errors in queue

GError* rox_error_queue_fetch_last ( void   ) 

Return the error at the end of the error queue and remove it from the queue. The caller assumes responsibilty for deleting the error.

Returns:
error, or NULL if no errors in queue

void rox_error_queue_flush ( void   ) 

Delete all errors from the error queue.

GError* rox_error_queue_peek ( void   ) 

Return the error at the head of the error queue, leaving it on the queue.

Returns:
error, or NULL if no errors in queue

GError* rox_error_queue_peek_last ( void   ) 

Return the error at the end of the error queue, leaving it on the queue.

Returns:
error, or NULL if no errors in queue

void rox_error_queue_report ( void   ) 

Report all errors (using rox_error_report_gerror()) in the queue in the order in which they were queued.

void rox_error_report_gerror ( GError *  err,
int  del 
)

Report an error (via rox_error()) stored in a GError type.

Parameters:
[in,out] err error to report
[in] del if non-zero the error is passed to g_error_free() after reporting.


Variable Documentation

GQuark rox_error_quark = 0

Quark used by ROX-CLib in creating GErrors. This is initialized by rox_error_init().


Generated on Sat Oct 13 17:22:45 2007 for ROX-CLib by  doxygen 1.5.0