方法

since: 2.24

声明 [src]

gconstpointer
g_variant_get_fixed_array (
  GVariant* value,
  gsize* n_elements,
  gsize element_size
)

描述 [src]

提供对固定大小项数组的序列化数据的访问。

value 必须是具有固定大小元素数组的值。数值类型和仅包含其他固定大小类型的元组都是固定大小的。

element_size 必须是数组中单个元素的大小,大小通过 序列化数据内存 章节给出。

特别是,这些固定大小类型的数组可以解释为给定 C 类型数组的数组,其中 element_size 设置适当类型的大小:- G_VARIANT_TYPE_INT16 (等):#gint16 (等) - G_VARIANT_TYPE_BOOLEAN:#guchar (不是 #gboolean!) - G_VARIANT_TYPE_BYTE:#guint8 - G_VARIANT_TYPE_HANDLE:#guint32 - G_VARIANT_TYPE_DOUBLE:#gdouble

例如,如果为 32 位整数数组调用此函数,可能说 sizeof(gint32)。此值不用于除用于验证序列化数据的形式与调用者的期望匹配之外的目的。

n_elements,必须是 NULL,设置为数组中物品的数量。

自 2.24 版本以来可用:

此方法对于语言绑定不可直接访问。

参数

n_elements

类型: gsize*

存储项目数量的位置的指针。

该参数将由函数设置。
element_size

类型: gsize

每个元素的长度。

返回值

类型: 一个 gconstpointer 的数组

固定数组的指针。

数组的长度在 n_elements 参数中。