gobj_set_gobj_trace()

gobj_set_gobj_trace()#

Sets or resets the trace level for a given hgobj. If gobj is NULL, it modifies the global trace level instead. Calls mt_trace_on() or mt_trace_off() if applicable.

Prototype

int gobj_set_gobj_trace(
    hgobj gobj,
    const char *level,
    BOOL set,
    json_t *kw
);

Parameters

Key

Type

Description

gobj

hgobj

The hgobj whose trace level is being modified. If NULL, modifies the global trace level.

level

const char *

The trace level to set or reset. If NULL, all levels are affected. If an empty string, only user-defined levels are affected.

set

BOOL

If TRUE, enables the specified trace level; if FALSE, disables it.

kw

json_t *

Additional parameters (owned).


Return Value

Returns 0 on success, or -1 if the specified trace level is invalid.

Notes

If gobj is not NULL, this function invokes mt_trace_on() or mt_trace_off() if they are defined in the object’s gclass.

Prototype

// Not applicable in JS

Prototype

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