/* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
/* camel-execpetion.c : exception utils */
/*
*
* Author :
* Bertrand Guiheneuf <bertrand@helixcode.com>
*
* Copyright 1999, 2000 Ximian, Inc. (www.ximian.com)
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or (at your option) any later version.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
* USA
*/
#ifdef HAVE_CONFIG_H
#include <config.h>
#endif
#include <glib.h>
#include "camel-exception.h"
/* i dont know why gthread_mutex stuff even exists, this is easier */
/* also, i'm not convinced mutexes are needed here. But it
doesn't really hurt either */
#ifdef ENABLE_THREADS
#include <pthread.h>
static pthread_mutex_t exception_mutex = PTHREAD_MUTEX_INITIALIZER;
#define CAMEL_EXCEPTION_LOCK(e) (pthread_mutex_lock(&exception_mutex))
#define CAMEL_EXCEPTION_UNLOCK(e) (pthread_mutex_unlock(&exception_mutex))
#else
#define CAMEL_EXCEPTION_LOCK(e)
#define CAMEL_EXCEPTION_UNLOCK(e)
#endif
/**
* camel_exception_new: allocate a new exception object.
*
* Create and returns a new exception object.
*
*
* Return value: The newly allocated exception object.
**/
CamelException *
camel_exception_new (void)
{
CamelException *ex;
ex = g_new (CamelException, 1);
ex->desc = NULL;
/* set the Exception Id to NULL */
ex->id = CAMEL_EXCEPTION_NONE;
return ex;
}
/**
* camel_exception_init: init a (statically allocated) exception.
*
* Init an exception. This routine is mainly
* useful when using a statically allocated
* exception.
*
*
**/
void
camel_exception_init (CamelException *ex)
{
ex->desc = NULL;
/* set the Exception Id to NULL */
ex->id = CAMEL_EXCEPTION_NONE;
}
/**
* camel_exception_clear: Clear an exception
* @exception: the exception object
*
* Clear an exception, that is, set the
* exception ID to CAMEL_EXCEPTION_NONE and
* free the description text.
* If the exception is NULL, this funtion just
* returns.
**/
void
camel_exception_clear (CamelException *exception)
{
if (!exception)
return;
CAMEL_EXCEPTION_LOCK(exception);
if (exception->desc)
g_free (exception->desc);
exception->desc = NULL;
exception->id = CAMEL_EXCEPTION_NONE;
CAMEL_EXCEPTION_UNLOCK(exception);
}
/**
* camel_exception_free: Free an exception
* @exception: The exception object to free
*
* Free an exception object. If the exception
* is NULL, nothing is done, the routine simply
* returns.
**/
void
camel_exception_free (CamelException *exception)
{
if (!exception)
return;
if (exception->desc)
g_free (exception->desc);
g_free (exception);
}
/**
* camel_exception_set: set an exception
* @ex: exception object
* @id: exception id
* @desc: textual description of the exception
*
* Set the value of an exception. The exception id is
* a unique number representing the exception. The
* textual description is a small text explaining
* what happened and provoked the exception.
*
* When @ex is NULL, nothing is done, this routine
* simply returns.
*
**/
void
camel_exception_set (CamelException *ex,
ExceptionId id,
const char *desc)
{
if (!ex)
return;
CAMEL_EXCEPTION_LOCK(exception);
ex->id = id;
if (ex->desc)
g_free(ex->desc);
ex->desc = g_strdup(desc);
CAMEL_EXCEPTION_UNLOCK(exception);
}
/**
* camel_exception_setv: set an exception
* @ex: exception object
* @id: exception id
* @format: format of the description string. The format string is
* used as in printf().
*
* Set the value of an exception. The exception id is
* a unique number representing the exception. The
* textual description is a small text explaining
* what happened and provoked the exception.
* In this version, the string is created from the format
* string and the variable argument list.
*
* It is safe to say:
* camel_exception_setv (ex, ..., camel_exception_get_description (ex), ...);
*
* When @ex is NULL, nothing is done, this routine
* simply returns.
*
**/
void
camel_exception_setv (CamelException *ex,
ExceptionId id,
const char *format,
...)
{
va_list args;
if (!ex)
return;
CAMEL_EXCEPTION_LOCK(exception);
if (ex->desc)
g_free (ex->desc);
va_start(args, format);
ex->desc = g_strdup_vprintf (format, args);
va_end (args);
ex->id = id;
CAMEL_EXCEPTION_UNLOCK(exception);
}
/**
* camel_exception_xfer: transfer an exception
* @ex_dst: Destination exception object
* @ex_src: Source exception object
*
* Transfer the content of an exception from
* an exception object to another.
* The destination exception receives the id and
* the description text of the source exception.
**/
void
camel_exception_xfer (CamelException *ex_dst,
CamelException *ex_src)
{
CAMEL_EXCEPTION_LOCK(exception);
if (ex_dst->desc)
g_free (ex_dst->desc);
ex_dst->id = ex_src->id;
ex_dst->desc = ex_src->desc;
ex_src->desc = NULL;
ex_src->id = CAMEL_EXCEPTION_NONE;
CAMEL_EXCEPTION_UNLOCK(exception);
}
/**
* camel_exception_get_id: get the exception id
* @ex: The exception object
*
* Return the id of an exception.
* If @ex is NULL, return CAMEL_EXCEPTION_NONE;
*
* Return value: Exception ID.
**/
ExceptionId
camel_exception_get_id (CamelException *ex)
{
if (ex)
return ex->id;
else
return CAMEL_EXCEPTION_NONE;
}
/**
* camel_exception_get_description: get the description of an exception.
* @ex: The exception object
*
* Return the exception description text.
* If @ex is NULL, return NULL;
*
*
* Return value: Exception description text.
**/
const gchar *
camel_exception_get_description (CamelException *ex)
{
char *ret = NULL;
if (ex)
ret = ex->desc;
return ret;
}
e='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/~lantw44/cgit/cgit.cgi/freebsd-ports-gnome/log/?id=fb5d9ded0b3ce35e065b1d9793640ea45e921d93'>root</a>/<a href='/~lantw44/cgit/cgit.cgi/freebsd-ports-gnome/log/devel?id=fb5d9ded0b3ce35e065b1d9793640ea45e921d93'>devel</a>/<a href='/~lantw44/cgit/cgit.cgi/freebsd-ports-gnome/log/devel/libpff?id=fb5d9ded0b3ce35e065b1d9793640ea45e921d93'>libpff</a></div><div class='content'><table class='list nowrap'><tr class='nohover'><th></th><th class='left'>Commit message (<a href='/~lantw44/cgit/cgit.cgi/freebsd-ports-gnome/log/devel/libpff?id=fb5d9ded0b3ce35e065b1d9793640ea45e921d93&showmsg=1'>Expand</a>)</th><th class='left'>Author</th><th class='left'>Age</th><th class='left'>Files</th><th class='left'>Lines</th></tr>
<tr><td class='commitgraph'>* </td><td><a href='/~lantw44/cgit/cgit.cgi/freebsd-ports-gnome/commit/devel/libpff?id=868b667f05205683f62d6aea623c546ca931ca9f'>Convert to STAGEDIR</a></td><td>antoine</td><td><span title='2013-10-03 02:25:44 +0800'>2013-10-03</span></td><td>2</td><td><span class='deletions'>-12</span>/<span class='insertions'>+11</span></td></tr>
<tr><td class='commitgraph'>* </td><td><a href='/~lantw44/cgit/cgit.cgi/freebsd-ports-gnome/commit/devel/libpff?id=3ff0383d3a2fb21cdb1e80822419f4aac7fd522f'>Add NO_STAGE all over the place in preparation for the staging support (cat: ...</a></td><td>bapt</td><td><span title='2013-09-21 01:13:42 +0800'>2013-09-21</span></td><td>1</td><td><span class='deletions'>-0</span>/<span class='insertions'>+1</span></td></tr>
<tr><td class='commitgraph'>* </td><td><a href='/~lantw44/cgit/cgit.cgi/freebsd-ports-gnome/commit/devel/libpff?id=58997ddd1c49a14c1433651964a8dba0918fc3ec'>Make libpff fetchable again</a></td><td>antoine</td><td><span title='2013-07-30 06:08:48 +0800'>2013-07-30</span></td><td>1</td><td><span class='deletions'>-5</span>/<span class='insertions'>+6</span></td></tr>
<tr><td class='commitgraph'>* </td><td><a href='/~lantw44/cgit/cgit.cgi/freebsd-ports-gnome/commit/devel/libpff?id=79452c6dc80b634c3ef9c985a517d911cf038f4a'>- Convert USE_ICONV=yes to USES=iconv</a></td><td>mva</td><td><span title='2013-04-27 16:50:46 +0800'>2013-04-27</span></td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+1</span></td></tr>
<tr><td class='commitgraph'>* </td><td><a href='/~lantw44/cgit/cgit.cgi/freebsd-ports-gnome/commit/devel/libpff?id=be0532aa1927751208f2697351ec6365d64f46e3'>- Convert USE_GETTEXT to USES (part 4)</a></td><td>ak</td><td><span title='2013-04-26 18:44:28 +0800'>2013-04-26</span></td><td>1</td><td><span class='deletions'>-2</span>/<span class='insertions'>+1</span></td></tr>