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

Add to the category registry of this logger manager a new category having the specified `categoryName` and the specified `recordLevel`, `passLevel`, `triggerLevel`, and `triggerAllLevel` threshold levels, respectively, if (1) `categoryName` is not present in the registry, (2) the number of categories in the registry is less than the registry capacity, and (3) each threshold level is in the range `[0 .. 255]`. Return the address of the new modifiable category on success, and 0 otherwise. The behavior is undefined unless `categoryName` is null‐terminated.

== Synopsis

Declared in `<ball_loggermanager.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/ball/Category.adoc[Category]*
addCategory(
    char const* categoryName,
    int recordLevel,
    int passLevel,
    int triggerLevel,
    int triggerAllLevel);
----


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