GLib是一种底层库,创建GDK和GTK应用程序时该库提供许多有用的定义和函数。
包括基本类型及限制的定义、标准宏、类型转化、字节序、存储分配、警告和断言、消息记录、计时器、字符串工具、hook函数、句法扫描器、动态加载模块和字符串自动补全,同时也提供了许多数据类型及相关操作。
更多函数说明参见:
http://gtk-doc-cn.googlecode.com/svn/docs/glib/glib-Doubly-Linked-Lists.html
二、单向链表
三、存储管理
四、计时器
Example:
五、字符串处理
更多 http://gtk-doc-cn.googlecode.com/svn/docs/glib/glib-String-Utility-Functions.html#g-strdup
包括基本类型及限制的定义、标准宏、类型转化、字节序、存储分配、警告和断言、消息记录、计时器、字符串工具、hook函数、句法扫描器、动态加载模块和字符串自动补全,同时也提供了许多数据类型及相关操作。
包括存储块、双向链表、单向链表、哈希表、动态列表、关系和元组及缓存。最后GLib具有很好的移植性,所以使用GLib作为底层应用支持,那么也保证了应用的可移植性。
一、双向链表
双向链表中每个元素都包含一块数据和指向前后元素的指针。这使得链表的双向移动变的容易。
存储的数据类型是gpointer,在GLib中,gpointer指向实际数据的指针。
不存在用于创建链表的函数,而是简单的创建一个Glist* 变量,并设置它为NULL。
双向链表中提供的Glib函数:
01 | GList *g_list_append(GList *list, gpointer data):将一个新元素加入到链表尾 |
02 | GList *g_list_prepend(GList *list, gpointer data):将一个新元素加入到链表头 |
03 | GList *g_list_insert(GList *list, gpointer data, gint position):插入一个新元素到链表的指定位置 |
04 | GList *g_list_remove(GList *list, gpointer data):从链表中移除一个具有值data的元素,如果元素不存在,则链表不变 |
05 | GList *g_list_free(GList *list):数释放由GList使用的所有存储区 |
06 | GList *g_list_remove_link(GList *list, GList *link) |
07 | GList *g_list_reverse(GList *list):链表元素位置反转 |
08 | GList *g_list_nth(GList *list, gint n):获取指定位置元素 |
09 | GList *g_list_find(GList *list, gpointer data):在链表中查找一个含有指定值的元素,没有则返回NULL |
10 | GList *g_list_last(GList *list):获取链表中最后一个元素 |
11 | GList *g_list_first(GList *list):获取链表中第一个元素 |
12 | gint g_list_length(GList *list):返回链表元素个数 |
13 | void g_list_foreach(GList *list, GFunc func, gpointer data):遍历链表 |
14 | gint g_list_index(GList *list, gconstpointer data):返回指定元素在链表中的位置,没有找到匹配的元素,则返回-1。元素位置从0开始计算。 |
Example:
01 | void each_callback(gpointer data, gpointer user_data) |
02 | { |
03 | g_print( "element:%s, user param:%s\n" , (gchar*)data, (gchar*)user_data); |
04 | } |
05 |
06 | int main( int argc, |
07 | char *argv[] ) |
08 | { |
09 | GList *list = NULL; |
10 | list = g_list_append(list, "second" ); |
11 | list = g_list_prepend(list, "first" ); |
12 |
13 | g_list_foreach(list, each_callback, "user_data" ); |
14 |
15 | GList *second = g_list_find(list, "second" ); |
16 | g_print( "findElement:%s\n" , (gchar*)second->data); |
17 |
18 | list = g_list_remove(list, "second" ); |
19 |
20 | g_list_foreach(list, each_callback, "user_data" ); |
21 |
22 | return 0; |
23 | } |
二、单向链表
01 | GSList *g_slist_append(GSList *list, gpointer data):链表最后新增一个元素 |
02 | GSList *g_slist_prepend(GSList *list, gpointer data):链表最前面新增一个元素 |
03 | GSList *g_slist_insert(GSList *list, gpointer data, gint position):指定链表位置插入新元素 |
04 | GSList *g_slist_remove(GSList *list, gpointer data):链表中删除具有值data的元素 |
05 | GSList *g_slist_reverse(GSList *list):反转元素位置 |
06 | GSList *g_slist_nth(GSList *list, gint n):返回链表中下一个元素 |
07 | GSList *g_slist_find(GSList *list, gpointer data):查找指定data的元素,没有则返回NULL |
08 | GSList *g_slist_last(GSList *list):查找链表的最后一个元素 |
09 | gint g_slist_length(GSList *list):返回链表元素个数 |
10 | void g_slist_foreach(GSList *list, GFunc func, gpointer data):遍历链表 |
三、存储管理
1 | gpointer g_malloc(gulong size):这是 malloc 的替代函数,不需要检查返回值。如果存储分配因任何原因失败,则应用程序终止。 |
2 | gpointer g_malloc0(gulong size):和g_malloc具有相同功能,但在返回指向分配存储块的指针前,将该存储块清0。 |
3 | gpointer g_realloc(gpointer mem, gulong size):重新分配由mem开始的指针,并设置大小为size字节。 |
4 | void g_free(gpointer mem):释放分配的存储块。如果mem为NULL,则直接返回。 |
四、计时器
计时器函数可用于记录操作记时,也可以记录程序的间断运行时间。
1 | GTimer *g_timer_new( void ):创建一个新计时器 |
2 | void g_timer_destroy(GTimer *timer):注销计时器 |
3 | void g_timer_start(GTimer *timer):计时器开始 |
4 | void g_timer_stop(GTimer *timer):停止计时 |
5 | void g_timer_reset(GTimer *timer):重置计时器 |
6 | void g_timer_continue(GTimer *timer):继续计时 |
7 | gdobule g_timer_elapsed(GTimer *timer, gulong *microseconds):决定所耗时间 |
Example:
01 | GTimer *timer; |
02 |
03 | void each_callback(gpointer data, gpointer user_data) |
04 | { |
05 | g_print( "element:%s, user param:%s\n" , (gchar*)data, (gchar*)user_data); |
06 | } |
07 |
08 | int main( int argc, |
09 | char *argv[] ) |
10 | { |
11 | GList *list = NULL; |
12 | gulong seconds; |
13 | int i=0; |
14 | timer = g_timer_new(); |
15 |
16 | list = g_list_append(list, "second" ); |
17 | list = g_list_prepend(list, "first" ); |
18 |
19 | g_timer_start(timer); |
20 | g_list_foreach(list, each_callback, "user_data" ); |
21 | g_timer_stop(timer); |
22 |
23 | g_timer_elapsed(timer, &seconds); |
24 |
25 | g_print( "use seconds:%ld\n" , seconds); |
26 |
27 | g_timer_continue(timer); |
28 |
29 | for (i; i<=1000; i++) |
30 | { |
31 | g_print( "%d" , i); |
32 | } |
33 | g_timer_elapsed(timer, &seconds); |
34 | g_print( "use seconds:%ld\n" , seconds); |
35 | return 0; |
36 | } |
五、字符串处理
编程中经常需要对字符串进行拼接、截取、大小写转换,原本在C中这些操作是非常繁琐的。现在GLib定义了一个叫做GString的新类型,它可以自动增长,并且提供了
一系列方便的操作函数。
struct GString{
gchar *str;/*指向当前以\0结尾的字符串*/
gint len;/*当前字符长度*/
}
01 | GString *g_string_new(gchar *init):创建GList类型 |
02 | GString *g_string_truncate(GString *string, gint len):截取指定长度的字符串 |
03 | GString *g_string_append(GString *string, gchar *val):末尾追加字符串 |
04 | GString *g_string_append_c(GString *string, gchar c):末尾最加单个字符 |
05 | GString *g_string_prepend(GString *string, gchar *val):开头插入字符串 |
06 | GString *g_string_prepend_c(GString *string, gchar c):开头插入单个字符 |
07 | void g_string_sprintf(GString *string, gchar *fmt, ...):格式化字符串 |
08 | gchar *g_strdup ( const gchar *str):复制字符串,返回一个新分配的字符串。 |
09 | gchar *g_strndup( const gchar *str, gsize n):复制指定个数的字符串,返回新分配的字符串 |
10 | gchar *g_strstr_len( const gchar *haystack, gssize haystack_len, const gchar *needle):在限定长度内,第一次出现指定字符的指针 |
11 | gchar *g_strrstr( const gchar *haystrack, const gchar *needle):搜索字符串haystack中最后一次出现的串针。 |
12 | gchar *g_strrstr_len( const gchar *haystrack, gssize haystrack_len, const gchar *needle) |
13 | gboolean g_str_hash_prefix( const gchar *str, const gchar *prefix):返回字符串是否以某个前缀开头 |
14 | int g_strcmp0( const char *str1, const char *str2):对比两个字符串 |
15 | gchar **g_strsplit( const gchar *string, const gchar *delimiter, gint max_tokens):分割字符串,保存为数组 |
16 | gchar *g_strconcat( const gchar *string1, ...):字符串拼接 |
17 | gchar *g_strjoin( const gchar *separator, ...):以某个字符串隔离并拼接 |
更多 http://gtk-doc-cn.googlecode.com/svn/docs/glib/glib-String-Utility-Functions.html#g-strdup
六、错误处理
1 | gchar *g_strdup( const gchar *str ):替代strdup函数。把原字符串内容复制到新分配的存储块中,返回指向它的指针。 |
2 | gchar *g_strerror( gint errnum ); |
3 | void g_error( gchar *format, ... );错误提示:“ ** ERROR ** ”并且退出程序。仅用在致命错误上。 |
4 | void g_warning( gchar *format, ... ):错误提示:“ ** WARNING ** ” |
5 | void g_message( gchar *format, ... ):在传递字符串前打印 "message" |
6 | void g_print( gchar *format, ... ):替代 printf 函数 |
除了上述之外,GLib还提供了很多功能,包括编码转换、正则、XMP解析、Test框架等等。
可以参看http://gtk-doc-cn.googlecode.com/svn/docs/glib/index.html