gobj_create_pure_child()

gobj_create_pure_child()#

Creates a new gobj as a pure child of the specified parent. A pure child sends events directly to its parent instead of publishing them.

Prototype

hgobj gobj_create_pure_child(
    const char      *gobj_name,
    gclass_name_t   gclass_name,
    json_t          *kw,    // owned
    hgobj           parent
);

Parameters

Key

Type

Description

gobj_name

const char *

The name of the new gobj.

gclass_name

gclass_name_t

The gclass type of the new gobj.

kw

json_t *

A JSON object containing the configuration attributes for the new gobj. This parameter is owned and will be consumed by the function.

parent

hgobj

The parent gobj to which the new gobj will be attached.


Return Value

Returns a handle to the newly created gobj, or NULL if creation fails.

Notes

A pure child does not publish events but instead sends them directly to its parent. This function internally calls gobj_create2() with the gobj_flag_pure_child flag.

Prototype

// Not applicable in JS

Prototype

# Not applicable in Python
Examples
// TODO C examples
// TODO JS examples
# TODO Python examples