属性列表服务

PropertyList 服务允许您以 Core Foundation API 支持的所有格式读取和写入属性列表文件：XML、二进制、JSON 和 OpenStep（只读）。

此服务仅在 Darwin 平台上可用，例如 iOS、macOS、tvOS 和 watchOS。

可用操作

PropertyList()

分配并返回一个新的 PropertyList 对象。

clear(): void

通过删除其内部对象引用来清空属性列表。

isEmpty(): boolean

如果属性列表没有设置内部对象引用，则返回 true，否则返回 false。

format(): string

返回属性列表数据反序列化时所使用的数据格式。此属性在调用 readFromString 或 readFromFile 后设置。可能的返回值包括："binary1"、"json"、"openstep" 和 "xml1"。如果属性列表对象为空或无法确定输入格式，则返回 "undefined"。

readFromFile(filePath: string): void

解析文件并将结果存储在属性列表中。如果发生 I/O 错误或输入格式无效，则抛出异常。

readFromObject(obj: any): void

将给定对象设置为属性列表的内部对象。 format() 会返回 "undefined"，因为此方法不会反序列化存储格式。

readFromString(input: string): void

解析 input 并将结果存储在属性列表中。这对于从 JSON.stringify 调用的结果初始化属性列表对象非常有用。如果输入格式无效，则抛出异常。

toObject(): any

返回表示属性列表的对象。

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

返回以 JSON 格式表示的属性列表的字符串表示形式。style 的可能值包括 "pretty" 和 "compact"。默认值为紧凑。

toString(format: string): string

返回属性列表在指定格式下的字符串表示形式。对于 format 的可能值包括："json"（紧凑）、"json-compact"、"json-pretty" 和 "xml1"。目前不支持 OpenStep 格式。如果对象无法使用给定格式写入，则抛出异常。

toXMLString(): string

返回以 XML 格式表示的属性列表的字符串表示形式。此函数是 toString("xml1") 的同义词。

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

将属性列表以给定格式写入文件。format的有效值包括："binary1"、"json"（紧凑格式）、"json-compact"、"json-pretty"和"xml1"。目前不支持写入OpenStep格式。如果发生I/O错误或对象无法以指定格式写入，将抛出异常。