Set threshold levels for categories matching a pattern.

Synopsis

Declared in <ball_administration.h>

static
int
setThresholdLevels(
    char const* pattern,
    int recordLevel,
    int passLevel,
    int triggerLevel,
    int triggerAllLevel);

Description

Set the threshold levels of each category currently in the registry of the logger manager singleton whose name matches the specified pattern to the specified recordLevel, passLevel, triggerLevel, and triggerAllLevel values, respectively, if each of the threshold values is in the range [0 .. 255]. Return the number of categories whose threshold levels were set, and a negative value if any of the threshold values were invalid. pattern is assumed to be of the form "X" or "X*" where X is a sequence of 0 or more characters and * matches any string (including the empty string). The behavior is undefined unless the logger manager singleton has been initialized and is not in the process of being shut down. Note that only a * located at the end of pattern is recognized as a special character. Also note that this function has no effect on the threshold levels of categories added to the registry after it is called.

Return Value

number of categories whose levels were set, or a negative value if any threshold was invalid

Parameters

Name

Description

pattern

category‐name pattern of the form "X" or "X*"

recordLevel

record threshold level to set

passLevel

pass threshold level to set

triggerLevel

trigger threshold level to set

triggerAllLevel

trigger‐all threshold level to set

Created with MrDocs