Class

NSCoder

An abstract class that serves as the basis for objects that enable archiving and distribution of other objects. 他のオブジェクトのアーカイブと配布を可能にするオブジェクトの基礎として奉仕する抽象クラス。

Declaration 宣言

@interface NSCoder : NSObject

Overview 概要

NSCoder declares the interface used by concrete subclasses to transfer objects and other values between memory and some other format. This capability provides the basis for archiving (storing objects and data on disk) and distribution (copying objects and data items between different processes or threads). The concrete subclasses provided by Foundation for these purposes are NSArchiver, NSUnarchiver, NSKeyedArchiver, NSKeyedUnarchiver, and NSPortCoder. Concrete subclasses of NSCoder are “coder classes”, and instances of these classes are “coder objects” (or simply “coders”). A coder that can only encode values is an “encoder”, and one that can only decode values is a “decoder”. NSCoderは、オブジェクトおよび他の値をメモリおよび何か他の形式の間で移し替えるために具象サブクラスによって使われるインターフェイスを宣言します。この能力は、アーカイブ(オブジェクトとデータをディスク上に格納する)と分散(オブジェクトとデータ項目を異なるプロセスやスレッドの間でコピーする)の基礎を提供します。これらの目的のためにFoundationによって提供される具象サブクラスは、NSArchiverNSUnarchiverNSKeyedArchiverNSKeyedUnarchiver、そしてNSPortCoderです。NSCoderの具象サブクラスは “コーダークラス” です、そしてそれらのクラスのインスタンスは “コーダーオブジェクト”(または単に “コーダー”)です。値のエンコードだけが可能なコーダーは “エンコーダ” です、そして値のデコードだけが可能なものは “デコーダ” です。

NSCoder operates on objects, scalars, C arrays, structures, strings, and on pointers to these types. It doesn’t handle types whose implementation varies across platforms, such as union, void *, function pointers, and long chains of pointers. A coder stores object type information along with the data, so an object decoded from a stream of bytes is normally of the same class as the object that was originally encoded into the stream. An object can change its class when encoded, however; this is described in Archives and Serializations Programming Guide. NSCoderは、オブジェクト、スカラー、C 配列、構造体、文字列上で、そしてそれらの型へのポインター上で作動します。それは、それの持つ実装がプラットホームを越えて変化する型を取り扱いません、例えば、unionvoid *、関数ポインタ、そしてポインタの長い連鎖など。コーダーは、オブジェクト型情報だけでなくそのデータも格納します、なのでバイトストリームから復号されるオブジェクトは、普通は最初にストリームへと符号化されたオブジェクトと同じクラスのものです。オブジェクトは符号化される時にそれのクラスを変えることができます;これはArchives and Serializations Programming Guideで記述されます。

The AVFoundation framework adds methods to the NSCoder class to make it easier to create archives including Core Media time structures, and extract Core Media time structure from archives. AVFoundationフレームワークは、いくらかのメソッドをNSCoderクラスに加えることで、Core Media時刻構造体を含んでいるアーカイブを作成するのを容易にします。

Subclassing Notes サブクラス作成の注意

For details of how to create a subclass of NSCoder, see Subclassing NSCoder in Archives and Serializations Programming Guide. NSCoderのサブクラスを作成する方法の詳細として、Subclassing NSCoderArchives and Serializations Programming Guideで見てください。

Topics 話題

Inspecting a Coder コーダーを検査する

Encoding General Data 一般的なデータを符号化する

Encoding Geometry-Based Data 幾何学基盤のデータを符号化する

Encoding Core Media Time Structures Core Media時刻構造体を符号化する

Secure Coding 安全なコーディング

Decoding Top-Level Objects トップレベルオブジェクトをデコードする

Decoding General Data 一般的なデータを復号する

Decoding Color Struct Data Color Structデータを復号する

Decoding Geometry-Based Data 幾何学基盤のデータを復号する

Decoding Core Media Time Structures Core Media時刻構造体を復号する

Managing Decode Errors デコードエラーを管理する

Getting Version Information バージョン情報を取得する

Managing Zones ゾーンを管理する

Representing Geometric Types as Strings 幾何学的な型を文字列として表す

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

Relationships 関係

Inherits From 継承元

See Also 参照

Keyed Archivers キー付きアーカイバ