utils.c

linux下的电话本的最底层

/*	librecord2 - Record Object manipulation and storage library 2
 *
 *	Authors: YE Nan <[e-mail]> 
 *	
 *	This software and associated documentation files (the "Software") 
 *	are copyright (C) 2005 LiPS Linux Phone Standards Forum [FranceTelecom] 
 *	All Rights Reserved. 
 *
 *	A copyright license is hereby granted for redistribution and use of 
 *	the Software in source and binary forms, with or without modification, 
 *	provided that the following conditions are met: 
 *	- Redistributions of source code must retain the above copyright notice, 
 *	this copyright license and the following disclaimer. 
 *  - Redistributions in binary form must reproduce the above copyright 
 * 	notice, this copyright license and the following disclaimer in the 
 *	documentation and/or other materials provided with the distribution. 
 *	- Neither the name of LiPS  nor the names of its Members may be used 
 *	to endorse or promote products derived from the Software without 
 *	specific prior written permission. 
 *
 *	A patent license for any Necessary Claims owned by Members of LiPS Forum 
 *	to make, have made, use, import, offer to sell, lease and sell or otherwise 
 *	distribute any implementation compliant with the any specification adopted 
 *	by the LiPS Forumcan be obtained from the respective Members on reasonable 
 *	and non-discriminatory terms and conditions and under reciprocity, as 
 *	regulated in more detail in the Internal Policy of the LiPS Forum. 
 *
 *	THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER, ITS MEMBERS AND CONTRIBUTORS 
 *	"AS IS", AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 
 *	THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE 
 *	AND NON-INFRINGEMENT ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER, 
 *	ITS MEMBERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
 *	SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
 *	PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
 *	OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
 *	WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
 *	ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
 *	POSSIBILITY OF SUCH DAMAGE. 
 */

#include <stdio.h>

#include <glib.h>

#include <field-desc.h>
#include <utils.h>

void
utils_g_ptr_array_free_generic (GPtrArray	*array)
{
	utils_g_ptr_array_free_custom(array, g_free);
	return;
}

void
utils_g_ptr_array_free_custom (GPtrArray			*array,
															 UtilsFreeFunc	 free_func)
{
	int i, count;

	g_return_if_fail(array);

	count = array->len;
	for (i = 0; i < count; i++)
	{
		gpointer element = NULL;
	
		element = (gpointer)g_ptr_array_remove_index_fast(array, 0);
		
		free_func(element);
	}

	g_ptr_array_free(array, TRUE);

	return;
}

void
utils_g_slist_free_generic (GSList	*list)
{
	utils_g_slist_free_custom(list, g_free);
	
	return;
}

void
utils_g_slist_free_custom (GSList					*list,
													 UtilsFreeFunc	 free_func)
{
	GSList * iter = NULL;
	int i, count;

	g_return_if_fail(list);

	for (i = 0, iter = list; iter; iter = g_slist_next(iter))
	{
		gpointer element = iter->data;
			
		free_func(element);		
	}
		
	g_slist_free(list);

	return;
}

void
utils_g_array_free_generic (GArray *array)
{
	g_return_if_fail(array);
	
	g_array_free(array, TRUE);
	
	return;
}

#define STRING_MAX_LEN	10
gchar *
utils_value_to_string (gconstpointer value,
											 gint					 size)
{
	GString * string = NULL;
	gint i;
	gint len;
	
	g_return_val_if_fail(value, NULL);
	g_return_val_if_fail(size != 0, NULL);
	
	len = (size > STRING_MAX_LEN) ? STRING_MAX_LEN : size;
	
	string = g_string_new("");
	for (i = 0; i < len; i++)
	{
		guint8 byte;
		
		byte = *((guint8 *)value + i);
		g_string_append_printf(string,
													 "%02x",
													 byte);
	}
	if (size > STRING_MAX_LEN)
	{
		g_string_append(string, "...");
	}
	
	return g_string_free(string, FALSE);
}

/*
vi:ts=2:nowrap:ai:expandtab 
*/