文書   >   Foundation   >   Archives and Serialization   >   PropertyListSerialization
クラス
PropertyListSerialization
プロパティリストといくつかのシリアル化された表現の 1 つの間で変換するオブジェクト。
概要
PropertyListSerialization クラスは、プロパティリストを複数のシリアル化された形式との間で変換するメソッドを提供します。プロパティリスト自体は、NSData、NSString、NSArray、NSDictionary、NSDate、および NSNumber オブジェクトのみを含む配列または辞書です。
プロパティリストオブジェクトは、それぞれの Core Foundation 型 (CFData、CFString など) で通話無料でブリッジされています。通話無料のブリッジの詳細については、通話無料のブリッジ を参照してください。
トピックス
プロパティリストのシリアル化
class func data(fromPropertyList: Any, format: PropertyListSerialization.PropertyListFormat, options: PropertyListSerialization.WriteOptions)
指定された形式で与えられたプロパティリストを含む NSData オブジェクトを返します。
class func writePropertyList(Any, to: OutputStream, format: PropertyListSerialization.PropertyListFormat, options: PropertyListSerialization.WriteOptions, error: NSErrorPointer)
指定されたストリームにプロパティリストを書き込みます。
typealias PropertyListSerialization.WriteOptions
プロパティリストの脱シリアル化
class func propertyList(from: Data, options: PropertyListSerialization.ReadOptions = [], format: UnsafeMutablePointer<PropertyListSerialization.PropertyListFormat>?)
指定されたデータからプロパティリストを作成し返します。
class func propertyList(with: InputStream, options: PropertyListSerialization.ReadOptions = [], format: UnsafeMutablePointer<PropertyListSerialization.PropertyListFormat>?)
指定されたストリームから読み込んでプロパティリストを作成して返します。
プロパティリストの検証
class func propertyList(Any, isValidFor: PropertyListSerialization.PropertyListFormat)
指定されたプロパティリストが特定の形式に対して有効かどうかを示すブール値を返します。
旧式のメソッド
- このメソッドは旧式であり、間もなく廃止される予定です。
旧式 |
---|
- このメソッドは廃止されました。代わりに data(fromPropertyList:format:options:) を使用して下さい。
旧式 |
---|
定数
struct PropertyListSerialization.MutabilityOptions
これらの定数は、プロパティリストの可変性オプションを指定します。
enum PropertyListSerialization.PropertyListFormat
これらの定数は、プロパティリストのシリアル化形式を指定します。
typealias PropertyListSerialization.ReadOptions
サポートされている読み取りオプションは PropertyListSerialization.MutabilityOptions のみです。
エラーコード
var NSPropertyListReadCorruptError: Int
プロパティリストの解析中にエラーが発生しました。
var NSPropertyListReadUnknownVersionError: Int
プロパティリストのバージョン番号は判別できません。
var NSPropertyListReadStreamError: Int
プロパティーリストを読み込んでいるときにストリームエラーが発生しました。
var NSPropertyListWriteStreamError: Int
プロパティーリストの書き込み中にストリームエラーが発生しました。
var NSPropertyListWriteInvalidError: Int
var NSPropertyListErrorMinimum: Int
プロパティーリストのエラーのために予約されているエラーコードの範囲の先頭をマークします。
var NSPropertyListErrorMaximum: Int
プロパティーリストのエラーのために予約されているエラーコードの範囲の終わりをマークします。
関連
以下よりの継承
以下への準拠
CVarArg,
Equatable,
Hashable
以下も見よ
プロパティリスト
class PropertyListEncoder
データ型のインスタンスをプロパティリストにコード化するオブジェクト。
class PropertyListDecoder
プロパティリストからデータ型のインスタンスを復号化するオブジェクト。