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

Add to the registry of the logger manager singleton 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 category registry, (2) the number of categories in the registry is less than the registry capacity, and (3) each of the level values is in the range `[0 .. 255]`. Return 0 on success, and a non‐zero value otherwise. The behavior is undefined unless the logger manager singleton has been initialized and is not in the process of being shut down.

== Synopsis

Declared in `<ball_administration.h>`

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


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