BloombergLP::ball::Log::setCategoryHierarchically

Return from the logger manager singleton's category registry the address of the non-modifiable category having the specified categoryName, or, if no such category exists, add a new category having categoryName to the registry if possible (i.e., if the registry has sufficient capacity to accommodate new entries); otherwise, return the address of the non-modifiable Default Category. If the logger manager singleton is not initialized, return 0 with no effect. If a new category is created, it will have the same threshold levels as the category in the logger manager singleton whose name is the longest non-empty prefix of categoryName if such a category exists, and the threshold levels will be set as if setCategory had been called otherwise. If the specified categoryHolder is non-zero, load it with the address of the returned category and the maximum threshold level of that category, and link categoryHolder to the other holders (if any) that currently reference the category. Note that this method has the same effect on the logger manager singleton's category registry as the one-argument setCategoryHierarchically regardless of whether 0 == categoryHolder.