Method
GLibVariantlookup
since: 2.28
Declaration
gboolean
g_variant_lookup (
GVariant* dictionary,
const gchar* key,
const gchar* format_string,
...
)
Description
Looks up a value in a dictionary GVariant.
This function is a wrapper around g_variant_lookup_value() and
g_variant_get(). In the case that NULL would have been returned,
this function returns FALSE. Otherwise, it unpacks the returned
value and returns TRUE.
format_string determines the C types that are used for unpacking
the values and also determines if the values are copied or borrowed,
see the section on
[GVariant format strings][gvariant-format-strings-pointers].
This function is currently implemented with a linear scan. If you
plan to do many lookups then GVariantDict may be more efficient.
Available since: 2.28
This method is not directly available to language bindings.
Parameters
key-
Type:
const gchar*The key to look up in the dictionary.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. format_string-
Type:
const gchar*A GVariant format string.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. ...-
Type:
The arguments to unpack the value into.