Return the address of the modifiable category named categoryName.

Synopsis

Declared in <ball_categorymanager.h>

Category*
lookupCategory(
    CategoryHolder* categoryHolder,
    char const* categoryName);

Description

Return the address of the modifiable category having the specified categoryName in the registry of this category manager, or 0 if no such category exists. If a category is returned and 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. Note that the category name is possibly changed by the registered category name filter callback before the lookup.

Return Value

address of the modifiable category, or 0 if none exists

Parameters

Name

Description

categoryHolder

optional holder to load with the category

categoryName

name of the category to look up

Created with MrDocs