[#BloombergLP-ball-LoggerManager-setThresholdLevelsHierarchically]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/ball.adoc[ball]::xref:BloombergLP/ball/LoggerManager.adoc[LoggerManager]::setThresholdLevelsHierarchically
:relfileprefix: ../../../
:mrdocs:

Set thresholds for categories matching `categoryNamePrefix`.

== Synopsis

Declared in `<ball_loggermanager.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
setThresholdLevelsHierarchically(
    char const* categoryNamePrefix,
    int recordLevel,
    int passLevel,
    int triggerLevel,
    int triggerAllLevel);
----

== Description

In case the specified `categoryNamePrefix` is not empty set the threshold levels of every existing and future category whose name has, as a prefix, `categoryNamePrefix` to the specified threshold values, `recordLevel`, `passLevel`, `triggerLevel`, and `triggerAllLevel`. In case `categoryNamePrefix` is empty set the threshold level of every existing category, and remove all preliminary settings (for future categories). Return the number of categories whose threshold levels were set, or a negative value, with no effect, if any of the specified threshold values is outside the range `[0 .. 255]`. See also `ball::CategoryManager::setThresholdLevelsHierarchically`.

== Return Value

number of categories whose threshold levels were set, or a negative value on error

== Parameters

[cols="1,4"]
|===
| Name| Description
| *categoryNamePrefix*
| category‐name prefix to match
| *recordLevel*
| record threshold level
| *passLevel*
| pass threshold level
| *triggerLevel*
| trigger threshold level
| *triggerAllLevel*
| trigger‐all threshold level
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#