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

Load into the specified `*levels` the threshold levels that would be set for a newly created category, irrespective of whether a category with the specified `categoryName` is already in the registry. Return 0 on success and a non‐zero value otherwise. If the client has configured a default threshold levels callback (see `ball::LoggerManager::DefaultThresholdLevelsCallback` in the component doc), the `categoryName` will be supplied to that callback which will set `*levels`. Otherwise, if no default threshold levels callback has been provided, the default threshold levels are used. Note that this function will report an error if the callback returns invalid levels. Also note that if a category named `categoryName` is already in the registry, the levels returned by this method may differ from the levels of that category.

== Synopsis

Declared in `<ball_loggermanager.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
thresholdLevelsForNewCategory(
    xref:BloombergLP/ball/ThresholdAggregate.adoc[ThresholdAggregate]* levels,
    char const* categoryName) const;
----


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