GTK Gossip: GArray、GPtrArray、GByteArray

在處理C的陣列時，您必須處理陣列長度的問題，您可以使用GLib的GArray，並搭配各個所提供的函式，在使用陣列上會更為方便，GArray的定義如下：

typedef struct {
  gchar *data;
  guint len;
} GArray;

您有兩種建立GArray的方式：

GArray* g_array_sized_new(gboolean zero_terminated,
                         gboolean clear_,
                         guint element_size,
                         guint reserved_size);

GArray* g_array_new(gboolean zero_terminated,
                    gbooleanclear_,
                   guint element_size);

g_array_sized_new()的第一個參數zero_terminated設定為TRUE的話，會加入最後一個額外元素，全部的位元都設定為0，clear_設定為TRUE的話，陣列的全部元素會設定為0，element_size則是用來設定每個元素的長度，reserved_size則是用以設定陣列的長度，g_array_new()則是巨集定義的簡化版本，預設長度為0，若加入新的元素，則自動增加陣列長度。

要加入新的元素，可以使用g_array_append_val()函式，要依索引取出元素，則可以使用g_array_index()函式，下面這個程式是個簡單的示範：

• garray_demo.c

#include <glib.h>

int main(int argc, char *argv[]) {
    GArray *garray;
    gint i;

    garray = g_array_new(FALSE, FALSE, sizeof(gint));
      
    for (i = 0; i < 5; i++) {
        g_array_append_val(garray, i);
    }

    for (i = 0; i < 5; i++) {
        g_printf("%d/n", g_array_index(garray, gint, i));
    }

    g_array_free (garray, TRUE);
     
    return 0;
}

執行結果如下：

0
1
2
3
4

搭配GArray的函式還有g_array_remove_index()、g_array_sort()等，您可以參考 Arrays 的說明。

與GArray類似的是GPtrArray，只不過GArray儲存的是數值（若是structs，則會複製至GArray中），而GPtrArray儲存的是指標，GPtrArray的定義如下：

typedef struct {
  gpointer *pdata;
  guint        len;
} GPtrArray;

舉個例子來說，若要儲存GString的指標，則可以如下所示：

• gptrarray_demo.c

#include <glib.h>

int main(int argc, char *argv[]) {
    GPtrArray *array;
    gint i;
    GString *text;
    
    array = g_ptr_array_new();
    for (i = 0; i < 5; i++) {
        text = g_string_sized_new(5);
        g_string_printf(text, "TEST %d", i);
        g_ptr_array_add(array, text);
    }

    for (i = 0; i < 5; i++) {
        text = g_ptr_array_index(array, i);
        g_printf("%s/n", text->str);
    }
    
    g_ptr_array_free(array, TRUE);
    
    return 0;
}

執行結果如下所示：

TEST 0
TEST 1
TEST 2
TEST 3
TEST 4

GByteArray則允許您儲存guint8的資料，用於儲存位元組資料，為GArray的一個簡化形式，其定義如下：

typedef struct {
  guint8 *data;
  guint len;
} GByteArray;