Class

PropertyListSerialization

An object that converts between a property list and one of several serialized representations. あるプロパティリストといくつかのシリアライズされた表現のうちの１つの間で変換をするオブジェクト。

Declaration 宣言

class PropertyListSerialization : NSObject

Overview 概要

The PropertyListSerialization class provides methods that convert a property list to and from several serialized formats. A property list is itself an array or dictionary that contains only NSData, NSString, NSArray, NSDictionary, NSDate, and NSNumber objects. PropertyListSerializationクラスは、プロパティリストをいくつかのシリアライズされたフォーマットへそしてそれから変換するメソッドを提供します。プロパティリストは、それ自身は配列または辞書で、NSData、NSString、NSArray、NSDictionary、NSDate、そしてNSNumberオブジェクトのみを含むものです。

Property list objects are toll-free bridged with their respective Core Foundation types (CFData, CFString, and so on). See Toll-Free Bridging for more information on toll-free bridging. プロパティリストオブジェクトは、それらめいめいのCore Foundation型（CFData、CFString、など）とトールフリーブリッジされます。トールフリーブリッジに関する更なる情報としてToll-Free Bridgingを見てください。

Topics 話題

Serializing a Property List プロパティリストをシリアライズする

class func data(fromPropertyList: Any, format: PropertyListSerialization.PropertyListFormat, options: PropertyListSerialization.WriteOptions) -> Data

Returns an NSData object containing a given property list in a specified format. あるNSDataオブジェクトを返します、与えられたプロパティリストをある指定されたフォーマットで含んでいます。

class func writePropertyList(Any, to: OutputStream, format: PropertyListSerialization.PropertyListFormat, options: PropertyListSerialization.WriteOptions, error: NSErrorPointer) -> Int

Writes a property list to the specified stream. プロパティリストをこの指定されたストリームに書き出します。

typealias PropertyListSerialization.WriteOptions

Deserializing a Property List プロパティリストをデシリアライズする

class func propertyList(from: Data, options: PropertyListSerialization.ReadOptions, format: UnsafeMutablePointer<PropertyListSerialization.PropertyListFormat>?) -> Any

Creates and returns a property list from the specified data. プロパティリストをこの指定されたデータから作成して返します。

class func propertyList(with: InputStream, options: PropertyListSerialization.ReadOptions, format: UnsafeMutablePointer<PropertyListSerialization.PropertyListFormat>?) -> Any

Creates and returns a property list by reading from the specified stream. プロパティリストをこの指定されたストリームから読み出すことによって作成して返します。

Validating a Property List プロパティリストを構文解析する

class func propertyList(Any, isValidFor: PropertyListSerialization.PropertyListFormat) -> Bool

Returns a Boolean value that indicates whether a given property list is valid for a given format. 与えられたプロパティリストがある与えられたフォーマットに対して有効かどうかを指し示すブール値を返します。

Obsolete Methods 旧式メソッド

class func dataFromPropertyList(Any, format: PropertyListSerialization.PropertyListFormat, errorDescription: UnsafeMutablePointer<NSString?>?) -> Data?

This method is obsolete and will be deprecated soon. このメソッドは旧式です、そしてすぐに非推奨にされるでしょう。

Deprecated 非推奨

class func propertyListFromData(Data, mutabilityOption: PropertyListSerialization.MutabilityOptions, format: UnsafeMutablePointer<PropertyListSerialization.PropertyListFormat>?, errorDescription: UnsafeMutablePointer<NSString?>?) -> Any?

This method is deprecated. Use data(fromPropertyList:format:options:) instead. このメソッドは非推奨にされます。data(fromPropertyList:format:options:)を代わりに使ってください。

Deprecated 非推奨

Constants 定数

struct PropertyListSerialization.MutabilityOptions

These constants specify mutability options in property lists. これら定数は、可変性オプションをプロパティリストにおいて指定します。

enum PropertyListSerialization.PropertyListFormat

These constants are used to specify a property list serialization format. これら定数は、プロパティリストシリアライゼーションフォーマットを指定するのに使われます。

typealias PropertyListSerialization.ReadOptions

The only read options supported are described in PropertyListSerialization.MutabilityOptions. サポートされる専用読み出しオプションは、PropertyListSerialization.MutabilityOptionsで記述されます。

Error Codes さまざまなエラーコード

var NSPropertyListReadCorruptError: Int

Parsing of the property list failed. プロパティリストの構文解析が失敗した。

var NSPropertyListReadUnknownVersionError: Int

The version number of the property list cannot be determined. プロパティリストのバージョン番号が特定できなかった。

var NSPropertyListReadStreamError: Int

Reading of the property list failed. プロパティリストの読み出しが失敗した。

var NSPropertyListWriteStreamError: Int

Writing to the property list failed. プロパティリストへの書き込みが失敗した。

var NSPropertyListWriteInvalidError: Int

Writing failed because of an invalid property list object, or an invalid property list type was specified. 無効なプロパティリストオブジェクトのために書き込みが失敗した、または無効なプロパティリストが指定された。

var NSPropertyListErrorMinimum: Int

The start of the range of error codes reserved for property list errors. プロパティリストエラーのために予約されるエラーコードの範囲の始まり。

var NSPropertyListErrorMaximum: Int

The end of the range of error codes reserved for property list errors. プロパティリストエラーのために予約されるエラーコードの範囲の終わり。

Relationships 関係

Inherits From 継承元

NSObject