### Method

# GLib Tree insert_node

since: 2.68

#### Declaration [src]

    GTreeNode*
    g_tree_insert_node (
      GTree* tree,
      gpointer key,
      gpointer value
    )

#### Description [src]

Inserts a key/value pair into a `GTree`.

If the given key already exists in the `GTree` its corresponding value is set to the new value. If you supplied a `value_destroy_func` when creating the `GTree`, the old value is freed using that function. If you supplied a `key_destroy_func` when creating the `GTree`, the passed key is freed using that function.

The tree is automatically ‘balanced’ as new key/value pairs are added, so that the distance from the root to every leaf is as small as possible. The cost of maintaining a balanced tree while inserting new key/value result in a O(n log(n)) operation where most of the other operations are O(log(n)).

Available since: 2.68

#### Parameters

`key`

  Type: `gpointer`

  The key to insert.

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

`value`

  Type: `gpointer`

  The value corresponding to the key.

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

#### Return value

Type: `GTreeNode`

The inserted (or set) node or `NULL` if insertion would overflow the tree node counter.

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