函数

GLibListappend

声明 [src]

GList*
g_list_append (
  GList* list,
  gpointer data
)

描述 [src]

在列表末尾添加一个新元素。

请注意,返回值是列表的新起始位置,如果 list 为空;请确保存储新值。

g_list_append() 必须遍历整个列表以找到末尾,这在添加多个元素时效率低下。一个常见的避免低效的做法是在全部添加元素后,使用 g_list_prepend() 并将列表使用 g_list_reverse() 反转。

// Notice that these are initialized to the empty list.
GList *string_list = NULL, *number_list = NULL;

// This is a list of strings.
string_list = g_list_append (string_list, "first");
string_list = g_list_append (string_list, "second");

// This is a list of integers.
number_list = g_list_append (number_list, GINT_TO_POINTER (27));
number_list = g_list_append (number_list, GINT_TO_POINTER (14));

此功能不直接提供给语言绑定。

参数

list

类型: gpointer 列表

GList 的指针。

数据由函数的调用者拥有。
data

类型: gpointer

新元素的数据。

参数可以 NULL
数据由函数的调用者拥有。

返回值

类型: gpointer 列表

要么是 list,要么是如果 listNULL 的新 GList 的起始位置。

数据由被调用的函数拥有。