lookupMeter Member Function

Creates a Meter object for a Container object or Event object of the Listener. This function will create a Meter object only when that object does not already exist. If the object already exists, the existing object is returned.

CAUTION The application should not call delete on any objects returned by this function.

Syntax
Meter *lookupMeter(const char *meterName);
Meter *lookupMeter(const wchar_t *meterName);
Parameters
meterName - [in] Required pointer to a string, which provides the name of the Meter object. The string should consist of UTF-8 or Unicode characters, which may contain any printable characters excluding the newline character.
Example
Listener *listener = new Listener("sampleApp", "4.0", NULL, false);
Meter *cacheSize = listener->lookupMeter("cache size");
   - or -
Container *store = listener->lookupContainer("storeName");
Meter *cacheSize = store->lookupMeter("cache size");
   - or -
Event *creations = listener->lookupEvent(USER, "document creations");
Meter *creationSize = creations->lookupMeter("creation size");
...
See Also
Container Class
Event Class
Listener Class
Meter Class