gobj_create_volatil()

gobj_create_volatil()#

Creates a new GObj instance configured as volatile.
Volatile Gobjs are short-lived objects that are automatically destroyed after completing their purpose.

Prototype

#define gobj_create_volatil(name, gclass, kw, parent) \
    gobj_create_gobj(name, gclass, kw, parent, gobj_flag_volatil)

Parameters

Key

Type

Description

name

const char *

The name of the volatile GObj to be created.

gclass

gclass_name_t

The name of the GClass from which the GObj will be instantiated.

kw

json_t *

JSON object containing attributes to initialize the GObj. This parameter is owned by the function.

parent

hgobj

Handle to the parent GObj under which the volatile GObj will be created. If NULL, the GObj is created without a parent.

Return Value

  • Returns the handle (hgobj) to the created volatile GObj.

  • Returns NULL if the creation fails.

Prototype

// Not applicable in JS

Prototype

# Not applicable in Python
Examples
// TODO C examples

// TODO JS examples

# TODO Python examples