Contents

initWithDictionary

Initializes a new OSDictionary with the contents of another dictionary.

Declaration

virtual bool initWithDictionary( 
 const OSDictionary *dict, 
 unsigned int capacity = 0);

Parameters

  • dict:

    A dictionary whose contents will be placed in the new instance.

  • capacity:

    The initial storage capacity of the new dictionary object. If 0, the capacity is set to the number of key/value pairs in dict; otherwise capacity must be greater than or equal to the number of key/value pairs in dict.

Return Value

true on success, false on failure.

Overview

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

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

The keys and objects in dict are retained for storage in the new OSDictionary, not copied.

See Also

Miscellaneous