GLib.Tree.search

### Method

# GLib Treesearch

#### Declaration [src]

    gpointer
    g_tree_search (
      GTree* tree,
      GCompareFunc search_func,
      gconstpointer user_data
    )

#### Description [src]

Searches a `GTree` using `search_func`.

The `search_func` is called with a pointer to the key of a key/value pair in the tree, and the passed in `user_data`. If `search_func` returns 0 for a key/value pair, then the corresponding value is returned as the result of g_tree_search(). If `search_func` returns -1, searching will proceed among the key/value pairs that have a smaller key; if `search_func` returns 1, searching will proceed among the key/value pairs that have a larger key.

#### Parameters

`search_func`

  Type: `GCompareFunc`

  A function used to search the `GTree`.

`user_data`

  Type: `gconstpointer`

  The data passed as the second argument to `search_func`.

  The argument can be `NULL`.
  The data is owned by the caller of the method.

#### Return value

Type: `gpointer`

The value corresponding to the found key, or `NULL` if the key was not found.

The returned data is owned by the instance.
The return value can be `NULL`.