gobj_remove_trace_filter()

gobj_remove_trace_filter()#

Removes a trace filter from the specified hgclass. If attr is empty, all filters are removed. If value is empty, all values for the given attribute are removed.

Prototype

int gobj_remove_trace_filter(
    hgclass gclass, 
    const char *attr, 
    const char *value
);

Parameters

Key

Type

Description

gclass

hgclass

The hgclass from which the trace filter should be removed.

attr

const char *

The attribute name whose filter should be removed. If empty, all filters are removed.

value

const char *

The specific value to remove from the filter. If empty, all values for the given attribute are removed.


Return Value

Returns 0 on success, or -1 if the attribute or value is not found.

Notes

If the last value of an attribute is removed, the attribute itself is also removed from the trace filter.

Prototype

// Not applicable in JS

Prototype

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