GLib介紹與使用

GLib是一種底層庫，創建GDK和GTK應用程序時該庫提供許多有用的定義和函數。
包括基本類型及限制的定義、標準宏、類型轉化、字節序、存儲分配、警告和斷言、消息記錄、計時器、字符串工具、hook函數、句法掃描器、動態加載模塊和字符串自動補全，同時也提供了許多數據類型及相關操作。

包括存儲塊、雙向鏈表、單向鏈表、哈希表、動態列表、關系和元組及緩存。最后GLib具有很好的移植性，所以使用GLib作為底層應用支持，那么也保證了應用的可移植性。

一、雙向鏈表
雙向鏈表中每個元素都包含一塊數據和指向前后元素的指針。這使得鏈表的雙向移動變的容易。
存儲的數據類型是gpointer，在GLib中，gpointer指向實際數據的指針。
不存在用于創建鏈表的函數，而是簡單的創建一個Glist* 變量，并設置它為NULL。

雙向鏈表中提供的Glib函數：

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)：從鏈表中移除一個具有值data的元素，如果元素不存在，則鏈表不變
GList *g_list_free(GList *list)：數釋放由GList使用的所有存儲區
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)：在鏈表中查找一個含有指定值的元素，沒有則返回NULL
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 data)：遍歷鏈表
gint g_list_index(GList *list, gconstpointer data)：返回指定元素在鏈表中的位置，沒有找到匹配的元素，則返回－1。元素位置從0開始計算。

Example:

void each_callback(gpointer data, gpointer user_data)
{
    g_print("element:%s, user param:%s\n", (gchar*)data, (gchar*)user_data);
}

int main( int argc,
          char *argv[] )
{
  GList *list = NULL;
  list = g_list_append(list, "second");
  list = g_list_prepend(list, "first");

  g_list_foreach(list, each_callback, "user_data");

  GList *second = g_list_find(list, "second");
  g_print("findElement:%s\n", (gchar*)second->data);

  list = g_list_remove(list, "second");

  g_list_foreach(list, each_callback, "user_data");

  return 0;
}

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)：鏈表中刪除具有值data的元素
GSList *g_slist_reverse(GSList *list)：反轉元素位置
GSList *g_slist_nth(GSList *list, gint n)：返回鏈表中下一個元素
GSList *g_slist_find(GSList *list, gpointer data)：查找指定data的元素，沒有則返回NULL
GSList *g_slist_last(GSList *list)：查找鏈表的最后一個元素
gint g_slist_length(GSList *list)：返回鏈表元素個數
void g_slist_foreach(GSList *list, GFunc func, gpointer data)：遍歷鏈表

gpointer g_malloc(gulong size)：這是malloc的替代函數，不需要檢查返回值。如果存儲分配因任何原因失敗，則應用程序終止。
gpointer g_malloc0(gulong size)：和g_malloc具有相同功能，但在返回指向分配存儲塊的指針前，將該存儲塊清0。
gpointer g_realloc(gpointer mem, gulong size)：重新分配由mem開始的指針，并設置大小為size字節。
void g_free(gpointer mem)：釋放分配的存儲塊。如果mem為NULL，則直接返回。

計時器函數可用于記錄操作記時，也可以記錄程序的間斷運行時間。

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)：重置計時器
void g_timer_continue（GTimer *timer)：繼續計時
gdobule g_timer_elapsed(GTimer *timer, gulong *microseconds)：決定所耗時間

GTimer *timer;

void each_callback(gpointer data, gpointer user_data)
{
    g_print("element:%s, user param:%s\n", (gchar*)data, (gchar*)user_data);
}

int main( int argc,
          char *argv[] )
{
  GList *list = NULL;
  gulong seconds;
  int i=0;
  timer = g_timer_new();

  list = g_list_append(list, "second");
  list = g_list_prepend(list, "first");

  g_timer_start(timer);
  g_list_foreach(list, each_callback, "user_data");
  g_timer_stop(timer);

  g_timer_elapsed(timer, &seconds);

  g_print("use seconds:%ld\n", seconds);

  g_timer_continue(timer);

  for(i; i<=1000; i++)
  {
      g_print("%d", i);
  }
  g_timer_elapsed(timer, &seconds);
  g_print("use seconds:%ld\n", seconds);
  return 0;
}

編程中經常需要對字符串進行拼接、截取、大小寫轉換，原本在C中這些操作是非常繁瑣的。現在GLib定義了一個叫做GString的新類型，它可以自動增長，并且提供了
一系列方便的操作函數。
struct GString{
gchar *str;/*指向當前以\0結尾的字符串*/
gint len;/*當前字符長度*/
}

GString *g_string_new(gchar *init)：創建GList類型
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, ...)：格式化字符串
gchar *g_strdup (const gchar *str)：復制字符串，返回一個新分配的字符串。
gchar *g_strndup(const gchar *str, gsize n)：復制指定個數的字符串，返回新分配的字符串
gchar *g_strstr_len(const gchar *haystack, gssize haystack_len, const gchar *needle)：在限定長度內，第一次出現指定字符的指針
gchar *g_strrstr(const gchar *haystrack, const gchar *needle):搜索字符串haystack中最后一次出現的串針。
gchar *g_strrstr_len(const gchar *haystrack, gssize haystrack_len, const gchar *needle)
gboolean g_str_hash_prefix(const gchar *str, const gchar *prefix)：返回字符串是否以某個前綴開頭
int g_strcmp0(const char *str1, const char *str2)：對比兩個字符串
gchar **g_strsplit(const gchar *string, const gchar *delimiter, gint max_tokens)：分割字符串，保存為數組
gchar *g_strconcat(const gchar *string1, ...)：字符串拼接
gchar *g_strjoin(const gchar *separator, ...)：以某個字符串隔離并拼接

六、錯誤處理

gchar *g_strdup( const gchar *str )：替代strdup函數。把原字符串內容復制到新分配的存儲塊中，返回指向它的指針。
gchar *g_strerror( gint errnum );
void g_error( gchar *format, ... );錯誤提示：“ ** ERROR ** ”并且退出程序。僅用在致命錯誤上。
void g_warning( gchar *format, ... )：錯誤提示：“ ** WARNING ** ”
void g_message( gchar *format, ... )：在傳遞字符串前打印"message"
void g_print( gchar *format, ... )：替代printf函數

除了上述之外，GLib還提供了很多功能，包括編碼轉換、正則、XMP解析、Test框架等等。

可以參看http://gtk-doc-cn.googlecode.com/svn/docs/glib/index.html