GLib.Variant.lookup

### Method

# GLib Variantlookup

since: 2.28

#### Declaration [src]

    gboolean
    g_variant_lookup (
      GVariant* dictionary,
      const gchar* key,
      const gchar* format_string,
      ...
    )

#### Description [src]

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.

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.

#### Return value

Type: `gboolean`

`TRUE` if a value was unpacked.