结构体

GLibStrvBuilder

自:2.68

说明 [src]

struct GStrvBuilder {
  /* No available fields */
}

GStrvBuilder 是一个用于构建以 NULL 结尾的字符串数组的帮助对象。

以下示例显示了如何构建一个二元素数组。

  g_autoptr(GStrvBuilder) builder = g_strv_builder_new ();
  g_strv_builder_add (builder, "hello");
  g_strv_builder_add (builder, "world");

  g_auto(GStrv) array = g_strv_builder_end (builder);

  g_assert_true (g_strv_equal (array, (const char *[]) { "hello", "world", NULL }));

自以下版本提供:2.68

构造函数

g_strv_builder_new

创建一个新的 GStrvBuilder,引用计数为 1。不再需要时,对返回值使用 g_strv_builder_unref()

自:2.68

实例方法

g_strv_builder_add

在数组末尾添加一个字符串。

g_strv_builder_add_many

将所有给定的字符串附加到构建器。

g_strv_builder_addv

将给定的矢量中的所有字符串附加到构建器。

g_strv_builder_end

结束构建器进程并返回构建的以 NULL 结尾的字符串数组。不再需要时,应使用 g_strfreev() 释放返回值。

g_strv_builder_ref

原子性地将 builder 的引用计数增加 1。此函数是线程安全的,可以从任何线程调用。

自:2.68

g_strv_builder_take

在数组末尾添加一个字符串。value 之后属于 GStrvBuilder,调用方不能再修改它。

g_strv_builder_unref

减少 builder 的引用计数

自:2.68

g_strv_builder_unref_to_strv

减少字符串矢量构建器的引用计数,并将其内容作为以 NULL 结尾的字符串数组返回。

自:2.82