Return or create the category and optionally link a holder.
Synopsis
Declared in <ball_loggermanager.h>
Category const*
setCategory(
CategoryHolder* categoryHolder,
char const* categoryName);Description
Add to the category registry of this logger manager a new category having the specified categoryName and default threshold levels if 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 categoryName, if such a category exists, and the address of the non‐modifiable Default Category otherwise. If the specified categoryHolder is non‐null, then also load into categoryHolder the returned category and its maximum level and link categoryHolder to the category if it has not yet been linked. The behavior is undefined unless categoryName is null‐terminated. Note that a valid category address is always returned.
Return Value
address of the category named categoryName, or of the Default Category
Parameters
Name |
Description |
categoryHolder |
optional holder to link to the returned category |
categoryName |
name of the category to return or create |
Created with MrDocs