Writes a property list representation of the contents of the dictionary to a given URL.
- iOS 2.0–11.0Deprecated
- macOS 10.0–10.13Deprecated
- Mac Catalyst 13.0–13.0Deprecated
- tvOS 9.0–11.0Deprecated
- watchOS 2.0–4.0Deprecated
The URL to which to write the dictionary.
A flag that specifies whether the output should be written atomically.
YES, the dictionary is written to an auxiliary location, and then the auxiliary location is renamed to
NO, the dictionary is written directly to
YESoption guarantees that
a, if it exists at all, won’t be corrupted even if the system should crash during writing.
flagis ignored if
ais of a type that cannot be written atomically.
YES if the location is written successfully, otherwise
This method recursively validates that all the contained objects are property list objects (instances of
NSDictionary) before writing out the file, and returns
NO if all the objects are not property list objects, since the resultant output would not be a valid property list.
If the dictionary’s contents are all property list objects, the location written by this method can be used to initialize a new dictionary with the class method
dictionary or the instance method
If you need greater control over the property list representation, use
For more information about property lists, see Property List Programming Guide.