方法

GLibVariantDictlookup_value

since: 2.40

声明 [src]

GVariant*
g_variant_dict_lookup_value (
  GVariantDict* dict,
  const gchar* key,
  const GVariantType* expected_type
)

描述 [src]

在 GVariantDict 中查找值。

如果 key 在 dictionary 中找不到，则返回 NULL。

expected_type 字符串指定期望的值的类型。如果与 key 关联的值的类型不同，则返回 NULL。

如果找到了密钥且值类型正确，则返回。如果指定了 expected_type，则任何非 NULL 的返回值都将具有此类型。

since: 2.40

参数

key

类型： const gchar*

在字典中查找的密钥。

数据由方法调用者所有。
该值是 NUL 终止的 UTF-8 字符串。
expected_type

类型： GVariantType

一个 GVariantType，或 NULL。

参数可以是 NULL。
数据由方法调用者所有。

返回值

类型： GVariant

字典键的值，或 NULL。

方法调用者拥有返回的数据，并负责释放它。
返回值可以是 NULL。