函数

GLibPtrArraynew_full

since: 2.30

声明 [src]

GPtrArray*
g_ptr_array_new_full (
  guint reserved_size,
  GDestroyNotify element_free_func
)

描述 [src]

创建一个具有预分配 reserved_size 个指针和引用计数为 1 的新 GPtrArray。如果要将许多指针添加到数组中,这可以避免频繁的重新分配。请注意,数组的尺寸仍然是 0。它还设置 element_free_func,以便在通过 g_ptr_array_unref() 销毁数组,或者当调用 g_ptr_array_free() 且 free_segment 设置为 TRUE,或者删除元素时释放每个元素。

Available since: 2.30

此函数对语言绑定不可直接访问。

参数

reserved_size

类型: guint

预分配指针的数量。

element_free_func

类型: GDestroyNotify

用于释放具有销毁 arrayNULL 的元素的函数。

返回值

类型:一个 gpointer 数组

一个新的 GPtrArray

函数的调用者拥有数据,并负责释放它。