PropertyList Service

The PropertyList service allows you to read and write property list files in all formats supported by the Core Foundation API: XML, binary, JSON, and OpenStep (read-only).

This service is only available on Darwin platforms such as iOS, macOS, tvOS, and watchOS.

Available operations

Constructor

PropertyList()

Allocates and returns a new PropertyList object.

clear

clear(): void

Voids the property list by deleting its internal object reference.

isEmpty

isEmpty(): boolean

Returns true if the property list has no internal object reference set, otherwise false.

format

format(): string

Returns the data format that the property list data was deserialized from. This property is set after calling readFromString or readFromFile. Possible return values include: "binary1", "json", "openstep", and "xml1". If the property list object is empty or the input format could not be determined, returns undefined.

readFromFile

readFromFile(filePath: string): void

Parses the file and stores the result in the property list. Throws an exception if an I/O error occurs or the input is in an invalid format.

readFromObject

readFromObject(obj: any): void

Sets the given object as the property list's internal object. format() will return undefined as this method does not deserialize a storage format.

readFromString

readFromString(input: string): void

Parses input and stores the result in the property list. This is most useful for initializing a property list object from the result of a JSON.stringify call. Throws an exception if the input is in an invalid format.

toObject

toObject(): any

Returns an object representing the property list.

toJSON

toJSON(style: string = "compact"): string

Returns a string representation of the property list in JSON format. Possible values for style include "pretty" and "compact". The default is compact.

toString

toString(format: string): string

Returns a string representation of the property list in the specified format. Possible values for format include: "json" (compact), "json-compact", "json-pretty", and "xml1". Currently, the OpenStep format is not supported. Throws an exception if the object cannot be written in the given format.

toXMLString

toXMLString(): string

Returns a string representation of the property list in XML format. This function is a synonym for toString("xml1").

writeToFile

writeToFile(filePath: string, format: string): void

Writes the property list to the file in the given format. Possible values for format include: "binary1", "json" (compact), "json-compact", "json-pretty", and "xml1". Currently, the OpenStep format is not supported for writing. Throws an exception if an I/O error occurs or the object cannot be written in the given format.

© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.