gobj_search_path()

`gobj_search_path()`#

Searches for a hgobj instance by traversing the object tree using a path with ‘`’ as a separator.

C

Prototype

hgobj gobj_search_path(
    hgobj gobj_,
    const char *path_
);

Parameters

Key	Type	Description
`gobj_`	`hgobj`	The root object from which the search begins.
`path_`	`const char *`	The path to the target object, using ‘`’ as a separator between hierarchy levels.

Return Value

Returns the hgobj instance found at the specified path, or NULL if no matching object is found.

Notes

The function supports searching by both gclass and gobj names. If a segment contains a ‘^’, it is treated as ‘gclass^gobj_name’.

JS

Prototype

// Not applicable in JS

Python

Prototype

# Not applicable in Python