gobj_create2()

`gobj_create2()`#

Creates a new gobj (generic object) with the specified name, class, attributes, and parent. The function initializes the object, sets its attributes, and registers it if it is a service.

C

Prototype

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

Parameters

Key	Type	Description
`gobj_name`	`const char *`	The name of the `gobj` to be created. It is case-insensitive and converted to lowercase.
`gclass_name`	`gclass_name_t`	The name of the `gclass` to which the `gobj` belongs.
`kw`	`json_t *`	A JSON object containing the attributes and configuration for the `gobj`. The function takes ownership of this parameter.
`parent`	`hgobj`	The parent `gobj` under which the new `gobj` will be created. Must be non-null unless the `gobj` is a Yuno.
`gobj_flag`	`gobj_flag_t`	Flags that define the behavior of the `gobj`, such as whether it is a service, volatile, or a pure child.

Return Value

Returns a handle to the newly created gobj (hgobj). Returns NULL if creation fails due to invalid parameters or memory allocation failure.

Notes

If the gobj is marked as a service, it is registered globally. If the gobj is a Yuno, it is stored as the global Yuno instance.

The function checks for required attributes and applies global configuration variables. If the gobj has a mt_create2 method, it is called with the provided attributes.

If the gobj has a parent, it is added to the parent’s child list.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python

gobj_create2()

gobj_create2()#

`gobj_create2()`#