Writes the bytes of a property list serialization out to a stream.
- iOS 2.0–8.0Deprecated
- macOS 10.2–10.10Deprecated
- Mac Catalyst 13.0–13.0Deprecated
- tvOS 9.0–9.0Deprecated
- watchOS 2.0–2.0Deprecated
- Core Foundation
The property list to write out.
The stream to write to. The stream must be opened and configured—this function simply writes bytes to the stream.
A constant that specifies the format used to write
CFPropertyfor possible values.
NULLif the conversion is successful, otherwise a string that describes the nature of the errors. Error messages are not localized, but may be in the future, so they are not currently suitable for comparison.
NULLif you do not wish to receive an error string. Ownership follows the The Create Rule.
The number of bytes written, or
0 if an error occurred. If
0 is returned,
error will contain an error message.
This function leaves the stream open after reading the content. When reading a property list, this function expects the reading stream to end wherever the writing ended, so that the end of the property list data can be identified.