Initializer

init(contentsOf:error:)

Initializes a newly allocated dictionary using the keys and values found at a given URL.

Declaration

convenience init(contentsOf url: URL, error: ()) throws

Parameters

url

A URL that identifies a resource containing a string representation of a property list whose root object is a dictionary.

error

On failure, a reference to the error that occurred.

Return Value

An initialized dictionary that contains the dictionary at url, or nil if there is an error or if the contents of the resource are an invalid representation of a dictionary.

Discussion

The dictionary representation in the file identified by url must contain only property list objects (NSString, NSData, NSDate, NSNumber, NSArray, or NSDictionary objects). For more details, see Property List Programming Guide. The objects contained by this dictionary are immutable, even if the dictionary is mutable.

This initializer throws if there is an error loading the URL, or if the contents of the resource are an invalid representation of a dictionary.

See Also

Creating a Dictionary from an External Source

init?(contentsOf: URL)

Initializes a newly allocated dictionary using the keys and values found at a given URL.

Deprecated
init?(contentsOfFile: String)

Initializes a newly allocated dictionary using the keys and values found in a file at a given path.

Deprecated