\section{error.c File Reference}
\label{error_8c}\index{error.c@{error.c}}
Display error message. 

{\tt \#include $<$stdio.h$>$}\par
{\tt \#include $<$stdlib.h$>$}\par
{\tt \#include $<$string.h$>$}\par
{\tt \#include $<$stdarg.h$>$}\par
{\tt \#include $<$gtk/gtk.h$>$}\par
{\tt \#include \char`\"{}rox.h\char`\"{}}\par
{\tt \#include \char`\"{}error.h\char`\"{}}\par
{\tt \#include \char`\"{}rox-clib.h\char`\"{}}\par
\subsection*{Functions}
\begin{CompactItemize}
\item 
void {\bf rox\_\-error\_\-init} (void)
\item 
void {\bf rox\_\-error} (const char $\ast$fmt,...)
\item 
void {\bf rox\_\-error\_\-report\_\-gerror} (GError $\ast$err, int del)
\item 
void {\bf rox\_\-error\_\-queue} (GError $\ast$err)
\item 
gboolean {\bf rox\_\-error\_\-queue\_\-empty} (void)
\item 
GError $\ast$ {\bf rox\_\-error\_\-queue\_\-peek} (void)
\item 
GError $\ast$ {\bf rox\_\-error\_\-queue\_\-fetch} (void)
\item 
GError $\ast$ {\bf rox\_\-error\_\-queue\_\-peek\_\-last} (void)
\item 
GError $\ast$ {\bf rox\_\-error\_\-queue\_\-fetch\_\-last} (void)
\item 
void {\bf rox\_\-error\_\-queue\_\-flush} (void)
\item 
void {\bf rox\_\-error\_\-queue\_\-report} (void)
\end{CompactItemize}
\subsection*{Variables}
\begin{CompactItemize}
\item 
GQuark {\bf rox\_\-error\_\-quark} = 0
\end{CompactItemize}


\subsection{Detailed Description}
Display error message. 



\subsection{Function Documentation}
\index{error.c@{error.c}!rox_error@{rox\_\-error}}
\index{rox_error@{rox\_\-error}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void rox\_\-error (const char $\ast$ {\em fmt},  {\em ...})}\label{error_8c_4b67caeec87318bef270017ac11caa7f}


Display an error message in a modal dialogue box.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[\mbox{$\leftarrow$} {\em fmt}]printf-style format string, followed by the arguments, to generate the message \end{description}
\end{Desc}
\index{error.c@{error.c}!rox_error_init@{rox\_\-error\_\-init}}
\index{rox_error_init@{rox\_\-error\_\-init}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void rox\_\-error\_\-init (void)}\label{error_8c_ad86d1ed982fb31c592b56c8aa419358}


Initialize error system. This is called by \doxyref{rox\_\-init\_\-with\_\-domain()}{p.}{rox_8c_74e2d8a486c8aedc955851dc7b71b660} and should not be called directly. \index{error.c@{error.c}!rox_error_queue@{rox\_\-error\_\-queue}}
\index{rox_error_queue@{rox\_\-error\_\-queue}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void rox\_\-error\_\-queue (GError $\ast$ {\em err})}\label{error_8c_09c3ab8b9517ae9db8fca3a5a36abe77}


Push an error onto the end of the error queue. ROX-CLib assumes responsibilty for deleting the error. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[\mbox{$\leftarrow$} {\em err}]error to queue \end{description}
\end{Desc}
\index{error.c@{error.c}!rox_error_queue_empty@{rox\_\-error\_\-queue\_\-empty}}
\index{rox_error_queue_empty@{rox\_\-error\_\-queue\_\-empty}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}gboolean rox\_\-error\_\-queue\_\-empty (void)}\label{error_8c_ef4de4dcd4d1d0db7a0c3e3211d22e78}


\begin{Desc}
\item[Returns:]{\tt TRUE} if the are no errors in the queue. \end{Desc}
\index{error.c@{error.c}!rox_error_queue_fetch@{rox\_\-error\_\-queue\_\-fetch}}
\index{rox_error_queue_fetch@{rox\_\-error\_\-queue\_\-fetch}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}GError$\ast$ rox\_\-error\_\-queue\_\-fetch (void)}\label{error_8c_7b3398cb928056d538e83862cc93b8d0}


Return the error at the head of the error queue and remove it from the queue. The caller assumes responsibilty for deleting the error. \begin{Desc}
\item[Returns:]error, or {\tt NULL} if no errors in queue \end{Desc}
\index{error.c@{error.c}!rox_error_queue_fetch_last@{rox\_\-error\_\-queue\_\-fetch\_\-last}}
\index{rox_error_queue_fetch_last@{rox\_\-error\_\-queue\_\-fetch\_\-last}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}GError$\ast$ rox\_\-error\_\-queue\_\-fetch\_\-last (void)}\label{error_8c_cc3e5f6c2c862cecdc7e0c105787b670}


Return the error at the end of the error queue and remove it from the queue. The caller assumes responsibilty for deleting the error. \begin{Desc}
\item[Returns:]error, or {\tt NULL} if no errors in queue \end{Desc}
\index{error.c@{error.c}!rox_error_queue_flush@{rox\_\-error\_\-queue\_\-flush}}
\index{rox_error_queue_flush@{rox\_\-error\_\-queue\_\-flush}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void rox\_\-error\_\-queue\_\-flush (void)}\label{error_8c_ab97b7230e9447838764592eaa23d6c3}


Delete all errors from the error queue. \index{error.c@{error.c}!rox_error_queue_peek@{rox\_\-error\_\-queue\_\-peek}}
\index{rox_error_queue_peek@{rox\_\-error\_\-queue\_\-peek}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}GError$\ast$ rox\_\-error\_\-queue\_\-peek (void)}\label{error_8c_d9df9f7bf90666a4d69cb19fa5b200ba}


Return the error at the head of the error queue, leaving it on the queue. \begin{Desc}
\item[Returns:]error, or {\tt NULL} if no errors in queue \end{Desc}
\index{error.c@{error.c}!rox_error_queue_peek_last@{rox\_\-error\_\-queue\_\-peek\_\-last}}
\index{rox_error_queue_peek_last@{rox\_\-error\_\-queue\_\-peek\_\-last}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}GError$\ast$ rox\_\-error\_\-queue\_\-peek\_\-last (void)}\label{error_8c_707a7cb2c1f724732e21e8f73aabef0c}


Return the error at the end of the error queue, leaving it on the queue. \begin{Desc}
\item[Returns:]error, or {\tt NULL} if no errors in queue \end{Desc}
\index{error.c@{error.c}!rox_error_queue_report@{rox\_\-error\_\-queue\_\-report}}
\index{rox_error_queue_report@{rox\_\-error\_\-queue\_\-report}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void rox\_\-error\_\-queue\_\-report (void)}\label{error_8c_de3c66c8388b8a7f9247233c14bb31a0}


Report all errors (using \doxyref{rox\_\-error\_\-report\_\-gerror()}{p.}{error_8c_8ff7f8b2e99912eede3c53f8f20d31ca}) in the queue in the order in which they were queued. \index{error.c@{error.c}!rox_error_report_gerror@{rox\_\-error\_\-report\_\-gerror}}
\index{rox_error_report_gerror@{rox\_\-error\_\-report\_\-gerror}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void rox\_\-error\_\-report\_\-gerror (GError $\ast$ {\em err}, int {\em del})}\label{error_8c_8ff7f8b2e99912eede3c53f8f20d31ca}


Report an error (via \doxyref{rox\_\-error()}{p.}{error_8c_4b67caeec87318bef270017ac11caa7f}) stored in a GError type.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[\mbox{$\leftrightarrow$} {\em err}]error to report \item[\mbox{$\leftarrow$} {\em del}]if non-zero the error is passed to g\_\-error\_\-free() after reporting. \end{description}
\end{Desc}


\subsection{Variable Documentation}
\index{error.c@{error.c}!rox_error_quark@{rox\_\-error\_\-quark}}
\index{rox_error_quark@{rox\_\-error\_\-quark}!error.c@{error.c}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}GQuark {\bf rox\_\-error\_\-quark} = 0}\label{error_8c_144ff2d1ff2e53a94ff8e4131ad3e7c6}


Quark used by ROX-CLib in creating GErrors. This is initialized by \doxyref{rox\_\-error\_\-init()}{p.}{error_8c_ad86d1ed982fb31c592b56c8aa419358}. 