[#BloombergLP-ball-CategoryManager-setCategory-0d]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/ball.adoc[ball]::xref:BloombergLP/ball/CategoryManager.adoc[CategoryManager]::setCategory
:relfileprefix: ../../../
:mrdocs:

Add to this category registry a new category having the specified `categoryName`, possibly changed by the registered category name filter callback, and default threshold levels if (the possibly filtered) `categoryName` is not present in the registry and the number of categories in the registry is less than the registry capacity. Return the address of the (possibly newly‐created) non‐modifiable category having (the possibly filtered) `categoryName`, if such a category exists, and the address of the non‐modifiable _Default_ _Category_ otherwise. The behavior is undefined unless `categoryName` is null‐terminated. Note that a valid category address is _always_ returned.

== Synopsis

Declared in `<ball_categorymanager.h>`

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


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