方法

GioMenuAttributeIterget_next

自:2.32

声明 [src]

gboolean
g_menu_attribute_iter_get_next (
  GMenuAttributeIter* iter,
  const gchar** out_name,
  GVariant** value
)

描述 [src]

此函数结合了 g_menu_attribute_iter_next()g_menu_attribute_iter_get_name() 和 g_menu_attribute_iter_get_value()。

首先将迭代器前进到下一个(可能的第一个)属性。如果失败,则返回 FALSE 而且没有其他效果。

如果成功,则将 namevalue 设置为刚刚前进到的属性的名称和值。在此点,g_menu_attribute_iter_get_name()g_menu_attribute_iter_get_value() 将再次返回相同的值。

name 中返回的值在迭代器保持当前位置时保持有效。在 value 中返回的值在不再使用时必须使用 g_variant_unref() 进行取消引用。

自:2.32

参数

out_name

类型: const gchar**

属性的类型。

该参数将由函数设置。
该参数可以是 NULL
返回的数据由该实例拥有。
值是一个以空字符终止的 UTF-8 字符串。
value

类型: GVariant

属性值。

该参数将由函数设置。
该参数可以是 NULL
方法的调用者将拥有的返回数据,并负责释放它。

返回值

类型: gboolean

成功时返回 TRUE,如果没有任何额外的属性则返回 FALSE