Initializer

init(objects:forKeys:count:)

Initializes a newly allocated dictionary with the specified number of key-value pairs constructed from the provided C arrays of keys and objects.

Declaration

init(objects: UnsafePointer<AnyObject>?, forKeys keys: UnsafePointer<NSCopying>?, count cnt: Int)

Parameters

objects

A C array of values for the new dictionary.

keys

A C array of keys for the new dictionary. Each key is copied (using copy(with:); keys must conform to the NSCopying protocol), and the copy is added to the new dictionary.

count

The number of elements to use from the keys and objects arrays. count must not exceed the number of elements in objects or keys.

Discussion

This method steps through the objects and keys arrays, creating entries in the new dictionary as it goes. An NSInvalidArgumentException is raised if a key or value object is nil.

This method is a designated initializer of NSDictionary.

See Also

Creating a Dictionary from Objects and Keys

init(objects: [Any], forKeys: [NSCopying])

Initializes a newly allocated dictionary with key-value pairs constructed from the provided arrays of keys and objects.

init(object: Any, forKey: NSCopying)

Creates a dictionary containing a given key and value.