Contents

initWithObjects(const OSObject *, const OSSymbol *, unsigned int, unsigned int)

Initializes a new OSDictionary with keys and objects provided.

Declaration

virtual bool initWithObjects( 
 const OSObject *objects[], 
 const OSSymbol *keys[], 
 unsigned int count, 
 unsigned int capacity = 0);

Parameters

  • objects:

    A C array of OSMetaClassBase-derived objects.

  • keys:

    A C array of OSSymbol keys for the corresponding objects in objects.

  • count:

    The number of keys and objects to be placed into the dictionary.

  • capacity:

    The initial storage capacity of the new dictionary object. If 0, count is used; otherwise this value must be greater than or equal to count.

Return Value

true on success, false on failure.

Overview

Not for general use. Use the static instance creation method withObjects instead.

objects and keys must be non-NULL, and count must be nonzero. If capacity is nonzero, it must be greater than or equal to count. The new dictionary will grow as neede to accommodate more key/object pairs (unlikeCFMutableDictionary, for which the initial capacity is a hard limit).

See Also

Miscellaneous