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비트 부동 소수점 숫자를 씁니다.	IDataOutput
		writeFloat(value:Number):void IEEE 754 단정밀도 32비트 부동 소수점 숫자를 씁니다.	IDataOutput
		writeInt(value:int):void 부호 있는 32비트 정수를 씁니다.	IDataOutput
		writeMultiByte(value:String, charSet:String):void 지정된 문자 세트를 사용하여 파일 스트림, 바이트 스트림 또는 바이트 배열에 멀티바이트 문자열을 씁니다.	IDataOutput
		writeObject(object:*):void 파일 스트림, 바이트 스트림 또는 바이트 배열에 AMF 직렬 형식으로 객체를 씁니다.	IDataOutput
		writeShort(value:int):void 16비트 정수를 씁니다.	IDataOutput
		writeUnsignedInt(value:uint):void 부호 없는 32비트 정수를 씁니다.	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 매개 변수에 따라 단일 바이트를 씁니다. 값이 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비트가 사용되고, 상위 24비트는 무시됩니다.

매개 변수

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비트 부동 소수점 숫자를 씁니다.

매개 변수

value:Number — 배정밀도 64비트 부동 소수점 숫자입니다.

writeFloat

()

메서드

public function writeFloat(value:Number):void

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

IEEE 754 단정밀도 32비트 부동 소수점 숫자를 씁니다.

매개 변수

value:Number — 단정밀도 32비트 부동 소수점 숫자입니다.

writeInt

()

메서드

public function writeInt(value:int):void

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

부호 있는 32비트 정수를 씁니다.

매개 변수

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비트 정수를 씁니다. 매개 변수의 하위 16비트가 사용되고, 상위 16비트는 무시됩니다.

매개 변수

value:int — 정수로 바이트 값입니다.

writeUnsignedInt

()

메서드

public function writeUnsignedInt(value:uint):void

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 1.0, Flash Player 9, Flash Lite 4

부호 없는 32비트 정수를 씁니다.

매개 변수

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비트 정수로 먼저 쓰고 문자열의 문자를 나타내는 바이트를 씁니다.

매개 변수

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비트 길이 워드를 추가하지 않습니다.

매개 변수

value:String — 쓸 문자열 값입니다.

예제 예제 사용 방법

DataOutputExample.as

다음 예제에서는 DataOutputExample 클래스를 사용하여 부울 값과 원주율의 배정밀도 부동 소수점 표현을 바이트 배열에 씁니다. 이는 다음 단계로 이루어집니다.

새 ByteArray 객체 인스턴스인 byteArr을 선언합니다.
부울 값 false에 해당하는 바이트 값과 원주율의 수학적 값에 해당하는 배정밀도 부동 소수점 값을 씁니다.
부울 값 및 배정밀도 부동 소수점 숫자를 다시 읽습니다.

코드 끝에 파일 끝 오류를 검사하는 코드 조각이 추가되어 있습니다. 이렇게 하면 바이트 스트림의 끝에 도달할 때 읽기를 멈출 수 있습니다.

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

endian

objectEncoding

writeBoolean

writeByte

writeBytes

writeDouble

writeFloat

writeInt

writeMultiByte

writeObject

writeShort

writeUnsignedInt

writeUTF

writeUTFBytes