函数

GLibVariantnew_array

since: 2.24

声明 [src]

GVariant*
g_variant_new_array (
  const GVariantType* child_type,
  GVariant* const* children,
  gsize n_children
)

描述 [src]

从 children 创建一个新的 GVariant 数组。

如果 n_children 为零，则 child_type 必须为非 NULL。否则，子类型将通过检查 children 数组的第一个元素来决定。如果 child_type 非空，则它必须是一个明确的类型。

数组中的项目来自 children 数组。在 children 数组中不允许有任何条目为 NULL。

数组中的所有项目都必须具有相同的类型，如果提供了，则必须与 child_type 相同。

如果 children 是浮动引用（见 g_variant_ref_sink()），新实例将像通过 g_variant_ref_sink() 一样获取它们的所有权。

Available since: 2.24

参数

child_type

类型： GVariantType

新数组的元素类型。

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

类型： 一个由 GVariant* 组成的数组

一个 GVariant 指针数组，子元素。

参数可以是 NULL。
数组的长度由 n_children 参数指定。
数据由函数的调用者拥有。
n_children

类型： gsize

children 的长度。

返回值

类型： GVariant

一个到新的 GVariant 数组的浮动引用。

数据由被调用函数拥有。