IDataOutput - Adobe ActionScript® 3（AS3 ）API リファレンス

パッケージ	flash.utils
インターフェイス	public interface IDataOutput
実装者	ByteArray, FileStream, Socket

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

IDataOutput インターフェイスには、バイナリデータを書き込む一連のメソッドがあります。このインターフェイスは、バイナリデータを読み取る IDataInput インターフェイスと同様に I/O 処理を行います。IDataOutput インターフェイスは、FileStream クラス、Socket クラスおよび ByteArray クラスで実装されています。

IDataInput および IDataOutput 操作のすべては、デフォルトでは "bigEndian"（シーケンスの最上位バイトが最下位または最初の記憶領域アドレスに保存されます）で、ブロッキングは発生しません。

データの書き込み時ではなく、読み取り時にのみ符号拡張が問題となります。したがって、IDataInput.readUnsignedByte() と IDataInput.readUnsignedShort() を処理するために、書き込みメソッドを分割する必要はありません。つまり、次のようになります。

IDataOutput.writeByte() は、IDataInput.readUnsignedByte() および IDataInput.readByte() と共に使用します。
IDataOutput.writeShort() は、IDataInput.readUnsignedShort() および IDataInput.readShort() と共に使用します。

例を表示

パブリックプロパティ

	プロパティ		定義元
		endian : String データのバイト順序（Endian クラスの BIG_ENDIAN 定数または LITTLE_ENDIAN 定数）です。	IDataOutput
		objectEncoding : uint writeObject() メソッドを使用してバイナリデータの書き込みまたは読み取りを行うときに AMF3 と AMF0 のどちらのフォーマットを使用するかを特定するために使用されます。	IDataOutput

パブリックメソッド

	メソッド		定義元
		writeBoolean(value:Boolean):void ブール値を書き込みます。	IDataOutput
		writeByte(value:int):void バイトを書き込みます。	IDataOutput
		writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void 指定したバイト配列（bytes）の offset（0 から始まるインデックス値）バイトから開始される length バイトのシーケンスをファイルストリーム、バイトストリームまたはバイト配列に書き込みます。	IDataOutput
		writeDouble(value:Number):void IEEE 754 倍精度（64 bit）浮動小数点数を書き込みます。	IDataOutput
		writeFloat(value:Number):void IEEE 754 単精度（32 bit）浮動小数点数を書き込みます。	IDataOutput
		writeInt(value:int):void 32 bit 符号付き整数を書き込みます。	IDataOutput
		writeMultiByte(value:String, charSet:String):void 指定した文字セットを使用して、ファイルストリーム、バイトストリームまたはバイト配列にマルチバイトストリングを書き込みます。	IDataOutput
		writeObject(object:*):void ファイルストリーム、バイトストリームまたはバイト配列に、AMF 直列化形式でオブジェクトを書き込みます。	IDataOutput
		writeShort(value:int):void 16 bit 整数を書き込みます。	IDataOutput
		writeUnsignedInt(value:uint):void 32 bit 符号なし整数を書き込みます。	IDataOutput
		writeUTF(value:String):void ファイルストリーム、バイトストリームまたはバイト配列に UTF-8 ストリングを書き込みます。	IDataOutput
		writeUTFBytes(value:String):void UTF-8 ストリングを書き込みます。	IDataOutput

プロパティの詳細

endian

プロパティ

endian:String

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

データのバイト順序（Endian クラスの BIG_ENDIAN 定数または LITTLE_ENDIAN 定数）です。

実装
public function get endian():String
public function set endian(value:String):void

関連する API エレメント

Endian クラス

objectEncoding

プロパティ

objectEncoding:uint

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

writeObject() メソッドを使用してバイナリデータの書き込みまたは読み取りを行うときに AMF3 と AMF0 のどちらのフォーマットを使用するかを特定するために使用されます。この値は、ObjectEncoding クラスの定数です。

実装
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void

メソッドの詳細

writeBoolean

()

メソッド

public function writeBoolean(value:Boolean):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

ブール値を書き込みます。value パラメーターに従って、1 バイトが書き込まれます。true の場合は 1、false の場合は 0 のいずれかが書き込まれます。

パラメーター

value:Boolean — 書き込むバイトを決定するブール値です。このパラメーターが true の場合は 1、false の場合は 0 が書き込まれます。

writeByte

()

メソッド

public function writeByte(value:int):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

バイトを書き込みます。パラメーターの下位 8 bit が使用されます。上位 24 bit は無視されます。

パラメーター

value:int — 整数としてのバイト値です。

writeBytes

()

メソッド

public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

指定したバイト配列（bytes）の offset（0 から始まるインデックス値）バイトから開始される length バイトのシーケンスをファイルストリーム、バイトストリームまたはバイト配列に書き込みます。

length パラメーターを省略すると、デフォルトの長さの 0 が使用され、offset から開始されるバッファー全体が書き込まれます。 offset パラメーターも省略した場合は、バッファー全体が書き込まれます。

offset または length パラメーターが範囲外の場合は、これらは bytes 配列の最初と最後に固定されます。

パラメーター

	`bytes:ByteArray` — 書き込むバイト配列です。

	`offset:uint` (default = `0`) — 書き込みを開始する配列の位置を指定する、0 から始まるインデックスです。

	`length:uint` (default = `0`) — 書き込むバッファーの長さを指定する符号なし整数です。

writeDouble

()

メソッド

public function writeDouble(value:Number):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

IEEE 754 倍精度（64 bit）浮動小数点数を書き込みます。

パラメーター

value:Number — 倍精度（64 bit）浮動小数点数です。

writeFloat

()

メソッド

public function writeFloat(value:Number):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

IEEE 754 単精度（32 bit）浮動小数点数を書き込みます。

パラメーター

value:Number — 単精度（32 bit）浮動小数点数です。

writeInt

()

メソッド

public function writeInt(value:int):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

32 bit 符号付き整数を書き込みます。

パラメーター

value:int — 符号付き整数としてのバイト値です。

writeMultiByte

()

メソッド

public function writeMultiByte(value:String, charSet:String):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

指定した文字セットを使用して、ファイルストリーム、バイトストリームまたはバイト配列にマルチバイトストリングを書き込みます。

パラメーター

	`value:String` — 書き込まれるストリング値です。

	`charSet:String` — 使用する文字セットを表すストリングです。文字セットのストリングには、`"shift-jis"`、`"cn-gb"`、および `"iso-8859-1"` などがあります。完全な一覧については、「サポートされている文字セット」を参照してください。

writeObject

()

メソッド

public function writeObject(object:*):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

ファイルストリーム、バイトストリームまたはバイト配列に、AMF 直列化形式でオブジェクトを書き込みます。

パラメーター

object:* — 直列化されるオブジェクトです。

writeShort

()

メソッド

public function writeShort(value:int):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

16 bit 整数を書き込みます。パラメーターの下位 16 bit が使用されます。上位 16 bit は無視されます。

パラメーター

value:int — 整数としてのバイト値です。

writeUnsignedInt

()

メソッド

public function writeUnsignedInt(value:uint):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

32 bit 符号なし整数を書き込みます。

パラメーター

value:uint — 符号なし整数としてのバイト値です。

writeUTF

()

メソッド

public function writeUTF(value:String):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

ファイルストリーム、バイトストリームまたはバイト配列に UTF-8 ストリングを書き込みます。最初に UTF-8 ストリングの長さがバイト単位で 16 bit 整数として書き込まれ、その後にストリングの文字を表すバイトが続きます。

パラメーター

value:String — 書き込まれるストリング値です。

例外

RangeError — 長さが 65535 よりも大きい場合。

writeUTFBytes

()

メソッド

public function writeUTFBytes(value:String):void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 1.0, Flash Player 9, Flash Lite 4

UTF-8 ストリングを書き込みます。writeUTF() と似ていますが、ストリングに 16 bit 長の接頭辞が付きません。

パラメーター

value:String — 書き込まれるストリング値です。

例この例の使用方法

DataOutputExample.as

次の例では、クラス DataOutputExample を使用して、ブールおよび pi の倍精度の浮動小数表現をバイト配列に書き込みます。ここでは以下の手順を実行します。

新しい ByteArray オブジェクトインスタンス byteArr を宣言します。
バイトと等価のブール値 false および pi の平方根と等価の倍精度の浮動小数を書き込みます。
ブール値および倍精度浮動小数点数を読み出します。

コードセグメントが最後に追加され、ファイルの終端エラーをチェックして、バイトストリームが最後まで読み取られないことを確認します。

package {
    import flash.display.Sprite;
    import flash.utils.ByteArray;
    import flash.errors.EOFError;

    public class DataOutputExample extends Sprite {        
        public function DataOutputExample() {
            var byteArr:ByteArray = new ByteArray();

            byteArr.writeBoolean(false);
            byteArr.writeDouble(Math.PI);
            
            byteArr.position = 0;

            try {
                trace(byteArr.readBoolean()); // false
            } 
            catch(e:EOFError) {
                trace(e);           // EOFError: Error #2030: End of file was encountered.
            }
                        
            try {
                trace(byteArr.readDouble());    // 3.141592653589793
            } 
            catch(e:EOFError) {
                trace(e);           // EOFError: Error #2030: End of file was encountered.
            }
            
            try {
                trace(byteArr.readDouble());
            } 
            catch(e:EOFError) {
                trace(e);        // EOFError: Error #2030: End of file was encountered.
            }
        }
    }
}

法律上の注意 | プライバシーポリシー

IDataOutput - AS3

パッケージx

言語エレメント

付録

パッケージ flash.utils

endian

objectEncoding

writeBoolean

writeByte

writeBytes

writeDouble

writeFloat

writeInt

writeMultiByte

writeObject

writeShort

writeUnsignedInt

writeUTF

writeUTFBytes