glib的头文件glib.h介绍

glib库是Linux平台下最常用的C语言函数库,它具有很好的可移植性和实用性。
glib是Gtk +库和Gnome的基础。glib可以在多个平台下使用,比如Linux、Unix、Windows等。glib为许多标准的、常用的C语言结构提供了相应的替代物。


使用glib库的程序都应该包含glib的头文件glib.h。


########################### glib基本类型定义: ##############################


整数类型:
gint8、guint8、gint16、guint16、gint32、guint32、gint64、guint64。
不是所有的平台都提供64位整型,如果一个平台有这些, glib会定义G_HAVE_GINT64。
类型gshort、glong、gint和short、long、int完全等价。
布尔类型:
gboolean:它可使代码更易读,因为普通C没有布尔类型。
Gboolean可以取两个值:TRUE和FALSE。实际上FALSE定义为0,而TRUE定义为非零值。
字符型:
gchar和char完全一样,只是为了保持一致的命名。
浮点类型:
gfloat、gdouble和float、double完全等价。
指针类型:
gpointer对应于标准C的void *,但是比void *更方便。
指针gconstpointer对应于标准C的const void *(注意,将const void *定义为const gpointer是行不通的


########################### glib的宏 ##############################


一些常用的宏列表
#include <glib.h>
TRUE
FALSE
NULL
MAX(a, b)
MIN(a, b)
ABS ( x )
CLAMP(x, low, high)


TRUE / FALSE / NULL就是1 / 0 / ( ( v o i d * ) 0 )。
MIN ( ) / MAX ( )返回更小或更大的参数。
ABS ( )返回绝对值。
CLAMP(x,low,high )若X在[low,high]范围内,则等于X;如果X小于low,则返回low;如果X大于high,则返
回high。


有些宏只有g l i b拥有,例如在后面要介绍的gpointer-to-gint和gpointer-to-guint。
大多数glib的数据结构都设计成存储一个gpointer。如果想存储指针来动态分配对象,可以这样做。
在某些情况下,需要使用中间类型转换。
//
gint my_int;
gpointer my_pointer;
my_int = 5;
my_pointer = GINT_TO_POINTER(my_int);
printf("We are storing %dn", GPOINTER_TO_INT(my_pointer));
//


这些宏允许在一个指针中存储一个整数,但在一个整数中存储一个指针是不行的。
如果要实现的话,必须在一个长整型中存储指针。
宏列表:
在指针中存储整数的宏
#include <glib.h>
GINT_TO_POINTER ( p )
GPOINTER_TO_INT ( p )
GUINT_TO_POINTER ( p )
GPOINTER_TO_UINT ( p )


调试宏:
定义了G_DISABLE_CHECKS或G_DISABLE_ASSERT之后,编译时它们就会消失.
宏列表:
前提条件检查
#include <glib.h>
g_return_if_fail ( condition )
g_return_val_if_fail(condition, retval)


///
使用这些函数很简单,下面的例子是g l i b中哈希表的实现:
void g_hash_table_foreach (GHashTable *hash_table,GHFunc func,gpointer user_data)
{
    GHashNode *node;
    gint i;
    g_return_if_fail (hash_table != NULL);
    g_return_if_fail (func != NULL);
    for (i = 0; i < hash_table->size; i++)
       for (node = hash_table->nodes[i]; node; node = node->next)
          (* func) (node->key, node->value, user_data);
}
///


宏列表:
断言
#include <glib.h>
g_assert( condition )
g_assert_not_reached ( )
如果执行到这个语句,它会调用abort()退出程序并且(如果环境支持)转储一个可用于调试的core文件。


断言与前提条件检查的区别:
应该断言用来检查函数或库内部的一致性。
g_return_if_fail()确保传递到程序模块的公用接口的值是合法的。
如果断言失败,将返回一条信息,通常应该在包含断言的模块中查找错误;
如果g_return_if_fail()检查失败,通常要在调用这个模块的代码中查找错误。
//
下面glib日历计算模块的代码说明了这种差别:
GDate * g_date_new_dmy (GDateDay day, GDateMonth m, GDateYear y)
{
   GDate *d;
   g_return_val_if_fail (g_date_valid_dmy (day, m, y), NULL);
   d = g_new (GDate, 1);
   d->julian = FALSE;
   d->dmy = TRUE;
   d->month = m;
   d->day = day;
   d->year = y;
   g_assert (g_date_valid (d));
   return d;
}
//
开始的预条件检查确保用户传递合理的年月日值;
结尾的断言确保glib构造一个健全的对象,输出健全的值。


断言函数g_assert_not_reached() 用来标识“不可能”的情况,通常用来检测不能处理的
所有可能枚举值的switch语句:
switch (val)
{
case FOO_ONE:
  break ;
case FOO_TWO:
  break ;
default:
  
    gint len;
} ;


用下面的函数创建新的GString变量:
GString *g_string_new( gchar *init );
这个函数创建一个GString,将字符串值init复制到GString中,返回一个指向它的指针。
如果init参数是NULL,创建一个空GString。


void g_string_free( GString *string,gint free_segment );
这个函数释放string所占据的内存。free_segment参数是一个布尔类型变量。
如果free_segment参数是TRUE,它还释放其中的字符数据。


GString *g_string_assign( GString *lval,const gchar *rval );
这个函数将字符从rval复制到lval,销毁lval的原有内容。
注意,如有必要, lval会被加长以容纳字符串的内容。


下面的函数的意义都是显而易见的。其中以_c结尾的函数接受一个字符,而不是字符串。
截取string字符串,生成一个长度为l e n的子串:
GString *g_string_truncate( GString *string,gint len );
将字符串val追加在string后面,返回一个新字符串:
GString *g_string_append( GString *string,gchar *val );
将字符c追加到string后面,返回一个新的字符串:
GString *g_string_append_c( GString *string,gchar c );
将字符串val插入到string前面,生成一个新字符串:
GString *g_string_prepend( GString *string,gchar *val );
将字符c插入到string前面,生成一个新字符串:
GString *g_string_prepend_c( GString *string,gchar c );
将一个格式化的字符串写到string中,类似于标准的sprintf函数:
void g_string_sprintf( GString *string,gchar *fmt,. . . ) ;
将一个格式化字符串追加到string后面,与上一个函数略有不同:
void g_string_sprintfa ( GString *string,gchar *fmt,... );


################################## 计时器函数 ##################################


创建一个新的计时器:
GTimer *g_timer_new( void );
销毁计时器:
void g_timer_destroy( GTimer *timer );
开始计时:
void g_timer_start( GTimer *timer );
停止计时:
void g_timer_stop( GTimer *timer );
计时重新置零:
void g_timer_reset( GTimer *timer );
获取计时器流逝的时间:
gdouble g_timer_elapsed( GTimer *timer,gulong *microseconds );


################################## 错误处理函数 ##################################


gchar *g_strerror( gint errnum );
返回一条对应于给定错误代码的错误字符串信息,例如“ no such process”等。
使用g_strerror函数:
g_print("hello_world:open:%s:%sn", filename, g_strerror(errno));


void g_error( gchar *format, ... );
打印一条错误信息。
格式与printf函数类似,但是它在信息前面添加“ ** ERROR **: ”,然后退出程序。它只用于致命错误。


void g_warning( gchar *format, ... );
与上面的函数类似,在信息前面添加“ ** WARNING **:”,不退出应用程序。它可以用于不太严重的错误。


void g_message( gchar *format, ... );
在字符串前添加“message: ”,用于显示一条信息。


gchar *g_strsignal( gint signum );
打印给定信号号码的Linux系统信号的名称。在通用信号处理函数中很有用。


################################## 其他实用函数 ##################################


glib还提供了一系列实用函数,可以用于获取程序名称、当前目录、临时目录等。
这些函数都是在glib.h中定义的。
/* 返回应用程序的名称* /
gchar* g_get_prgname (void);
/* 设置应用程序的名称* /
void g_set_prgname (const gchar *prgname);
/* 返回当前用户的名称* /
gchar* g_get_user_name (void);
/* 返回用户的真实名称。该名称来自“passwd”文件。返回当前用户的主目录* /
gchar* g_get_real_name (void);
/* 返回当前使用的临时目录,它按环境变量TMPDIR、TMPandTEMP 的顺序查找。
如果上面的环境变量都没有定义,返回“ / t m p”* /
gchar* g_get_home_dir (void);
gchar* g_get_tmp_dir (void);
/* 返回当前目录。返回的字符串不再需要时应该用g_free ( ) 释放* /
gchar* g_get_current_dir (void);
/ *获得文件名的不带任何前导目录部分的名称。它返回一个指向给定文件名字符串的指针* /
gchar* g_basename (const gchar *file_name);
/* 返回文件名的目录部分。如果文件名不包含目录部分,返回“ .”。
 * 返回的字符串不再使用时应该用g_free() 函数释放* /
gchar* g_dirname (const gchar *file_name);
/* 如果给定的file_name是绝对文件名(包含从根目录开始的完整路径,比如/usr/local),返回TRUE * /
gboolean g_path_is_absolute (const gchar *file_name);
/* 返回一个指向文件名的根部标志(“/”)之后部分的指针。
 * 如果文件名file_name不是一个绝对路径,返回NULL * /
gchar* g_path_skip_root (gchar *file_name);
/ *指定一个在正常程序终止时要执行的函数* /
void g_atexit (GVoidFunc func);


上面介绍的只是glib库中的一小部分, glib的特性远远不止这些。
如果想了解其他内容,参考glib.h文件。这里面的绝大多数函数都是简明易懂的。
另外,http://www.gtk.org上的glib文档也是极好的资源。


如果你需要一些通用的函数,但glib中还没有,考虑写一个glib风格的例程,将它贡献到glib库中!
你自己,以及全世界的glib使用者,都将因为你的出色工作而受益。


 


glib提供许多有用的函数及定义. 我把它们列在这里并做简短的解释. 很多都是与libc重复, 对这些我不再详述. 这些大致上是用来参考, 您知道有什麽东西可以用就好. 




17.1 定义 
为保持资料型态的一致, 这里有一些定义: 




G_MINFLOAT
G_MAXFLOAT
G_MINDOUBLE
G_MAXDOUBLE
G_MINSHORT
G_MAXSHORT
G_MININT
G_MAXINT
G_MINLONG
G_MAXLONG


此外, 以下的typedefs. 没有列出来的是会变的, 要看是在那一种平台上. 如果您想要具有可移植性, 记得避免去使用sizeof(pointer). 例如, 一个指标在Alpha上是8 bytes, 但在Inter上为4 bytes. 




char   gchar;
short  gshort;
long   glong;
int    gint;
char   gboolean;


unsigned char   guchar;
unsigned short  gushort;
unsigned long   gulong;
unsigned int    guint;


float   gfloat;
double  gdouble;
long double gldouble;


void* gpointer;


gint8
guint8
gint16
guint16
gint32
guint32




17.2 双向链结串列 
以下函数用来产生, 管理及销毁双向链结串列. 




GList* g_list_alloc(void);


void  g_list_free(GList *list);


void  g_list_free_1(GList *list);


GList* g_list_append(GList *list, gpointer data);
                           
GList* g_list_prepend(GList *list, gpointer  data);
                        
GList* g_list_insert(GList *list, gpointer data, gint position);


GList* g_list_remove (GList *list,  gpointer   data);
                           
GList* g_list_remove_link (GList *list, GList *link);


GList* g_list_reverse (GList *list);


GList* g_list_nth (GList *list,gint  n);
                           
GList* g_list_find (GList *list, gpointer   data);


GList* g_list_last  (GList  *list);


GList* g_list_first (GList *list);


gint   g_list_length (GList *list);


void   g_list_foreach (GList *list, GFunc func, gpointer user_data);






17.3 单向链结串列 
以下函数是用来管理单向链结串列: 


GSList* g_slist_alloc (void);


void g_slist_free  (GSList   *list);


void    g_slist_free_1  (GSList   *list);


GSList* g_slist_append (GSList   *list, gpointer  data);
                
GSList* g_slist_prepend (GSList   *list,
                             gpointer  data);
                             
GSList* g_slist_insert(GSList   *list, gpointer  data, gint      position);
                             
GSList* g_slist_remove      (GSList   *list, gpointer  data);
                             
GSList* g_slist_remove_link (GSList   *list, GSList   *link);
                             
GSList* g_slist_reverse     (GSList   *list);


GSList* g_slist_nth   (GSList   *list, gint      n);
                             
GSList* g_slist_find        (GSList   *list,gpointer  data);
                             
GSList* g_slist_last        (GSList   *list);


gint    g_slist_length      (GSList   *list);


void    g_slist_foreach     (GSList   *list,GFunc     func, gpointer  user_data);
        




17.4 记忆体管理 


gpointer g_malloc      (gulong    size);


这是替代malloc()用的. 你不需要去检查返回值, 因为它已经帮你做好了, 保证. 




gpointer g_malloc0     (gulong    size);


一样, 不过会在返回之前将记忆体归零. 




gpointer g_realloc     (gpointer  mem, gulong    size);


重定记忆体大小. 




void     g_free        (gpointer  mem);


void     g_mem_profile (void);


将记忆体的使用状况写到一个档案, 不过您必须要在glib/gmem.c里面, 加#define MEM_PROFILE, 然後重新编译. 




void     g_mem_check   (gpointer  mem);


检查记忆体位置是否有效. 您必须要在glib/gmem.c上加#define MEM_CHECK, 然後重新编译. 




17.5 Timers 
Timer函数.. 




GTimer* g_timer_new     (void);


void    g_timer_destroy (GTimer  *timer);


void    g_timer_start   (GTimer  *timer);


void    g_timer_stop    (GTimer  *timer);


void    g_timer_reset   (GTimer  *timer);


gdouble g_timer_elapsed (GTimer  *timer, gulong  *microseconds);




17.6 字串处理 


GString* g_string_new       (gchar   *init);
void     g_string_free      (GString *string, gint     free_segment);
                             
GString* g_string_assign    (GString *lval, gchar   *rval);
                             
GString* g_string_truncate  (GString *string, gint     len);
                             
GString* g_string_append    (GString *string, gchar   *val);
                            
GString* g_string_append_c  (GString *string, gchar    c);
        
GString* g_string_prepend   (GString *string, gchar   *val);
                             
GString* g_string_prepend_c (GString *string, gchar    c);
        
void     g_string_sprintf   (GString *string,
                             gchar   *fmt,
                             ...);
        
void     g_string_sprintfa  (GString *string, gchar   *fmt, ...);




17.7 工具及除错函数 


gchar* g_strdup    (const gchar *str);




gchar* g_strerror  (gint errnum);


我建议您使用这个来做所有错误讯息. 这玩意好多了. 它比perror()来的具有可移植性. 输出为以下形式: 




program name:function that failed:file or further description:strerror


这里是"hello world"用到的一些函数: 




g_print("hello_world:open:%s:%sn", filename, g_strerror(errno));




void g_error   (gchar *format, ...);


显示错误讯息, 其格式与printf一样, 但会加个"** ERROR **: ", 然後离开程式. 只在严重错误时使用. 




void g_warning (gchar *format, ...);


跟上面一样, 但加个"** WARNING **: ", 不离开程式. 




void g_message (gchar *format, ...);


加个"message: ". 




void g_print   (gchar *format, ...);


printf()的替代品. 


最後一个: 




gchar* g_strsignal (gint signum);


列印Unix系统的信号名称, 在信号处理时很有用. 


这些大都从glib.h中而来.
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值