IDataOutput - Adobe ActionScript® 3 (AS3 ) — dokumentacja interfejsu API

Pakiet	flash.utils
Interfejs	public interface IDataOutput
Implementory	ByteArray, FileStream, Socket

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Interfejs IDataOutput zapewnia zestaw metod do zapisywania danych binarnych. Interfejs jest odpowiednikiem we/wy interfejsu IDataInput, który odczytuje dane binarne. Interfejs IDataOutput jest implementowany przez klasy FileStream, Socket i ByteArray.

Wszystkie operacje IDataInput i IDataOutput są domyślnie operacjami „bigEndian” (najważniejszy bajt w sekwencji jest zapisywany na najniższej lub pierwszej pozycji adresu) i nie powodują blokowania.

Rozszerzenie znakowe ma znaczenie tylko podczas odczytu danych, a nie zapisu. Dlatego nie są wymagane osobne metody zapisu współpracujące z metodami IDataInput.readUnsignedByte() i IDataInput.readUnsignedShort(). Innymi słowy:

Należy używać metody IDataOutput.writeByte() z metodami IDataInput.readUnsignedByte() i IDataInput.readByte().
Należy używać metody IDataOutput.writeShort() z metodami IDataInput.readUnsignedShort() i IDataInput.readShort().

Wyświetl przykłady

Powiązane elementy interfejsu API

Interfejs IDataInput
endian
Klasa FileStream
Klasa Socket
Klasa URLStream
Klasa ByteArray

Właściwości publiczne

	Właściwość		Zdefiniowane przez
		endian : String Porządek bajtów, określony za pomocą stałej BIG_ENDIAN lub LITTLE_ENDIAN z klasy Endian.	IDataOutput
		objectEncoding : uint Używana do określania, który z formatów (AMF3 lub AMF0) zostanie użyty podczas zapisywania lub odczytywania danych binarnych za pomocą metody writeObject().	IDataOutput

Metody publiczne

	Metoda		Zdefiniowane przez
		writeBoolean(value:Boolean):void Zapisuje wartość typu Boolean.	IDataOutput
		writeByte(value:int):void Zapisuje bajt.	IDataOutput
		writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Zapisuje sekwencję bajtów z określonej tablicy bajtowej bytes, rozpoczynając od bajta określanego przez parametr offset (indeksowanego od zera) o długości określonej w parametrze length do strumienia pliku, strumienia bajtów lub tablicy bajtowej.	IDataOutput
		writeDouble(value:Number):void Zapisuje liczbę zmiennoprzecinkową o podwójnej precyzji (64 bity, IEEE 754).	IDataOutput
		writeFloat(value:Number):void Zapisuje liczbę zmiennoprzecinkową o pojedynczej precyzji (32 bity, IEEE 754).	IDataOutput
		writeInt(value:int):void Zapisuje 32-bitową liczbę całkowitą ze znakiem.	IDataOutput
		writeMultiByte(value:String, charSet:String):void Zapisuje wielobajtowy ciąg znaków do strumienia pliku, strumienia bajtów lub tablicy bajtowej, przy użyciu określonego zestawu znaków.	IDataOutput
		writeObject(object:*):void Zapisuje w strumieniu pliku, strumieniu bajtów lub w tablicy bajtów obiekt zakodowany w formacie serializowanym AMF.	IDataOutput
		writeShort(value:int):void Zapisuje 16-bitową liczbę całkowitą.	IDataOutput
		writeUnsignedInt(value:uint):void Zapisuje 32-bitową liczbę całkowitą bez znaku.	IDataOutput
		writeUTF(value:String):void Zapisuje do strumienia pliku, strumienia bajtów lub tablicy bajtów ciąg znaków UTF-8.	IDataOutput
		writeUTFBytes(value:String):void Zapisuje ciąg znaków UTF-8.	IDataOutput

Szczegół właściwości

endian

właściwość

endian:String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Porządek bajtów, określony za pomocą stałej BIG_ENDIAN lub LITTLE_ENDIAN z klasy Endian.

Implementacja
public function get endian():String
public function set endian(value:String):void

Powiązane elementy interfejsu API

Klasa Endian

objectEncoding

właściwość

objectEncoding:uint

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Używana do określania, który z formatów (AMF3 lub AMF0) zostanie użyty podczas zapisywania lub odczytywania danych binarnych za pomocą metody writeObject(). Wartość jest stałą z klasy ObjectEncoding.

Implementacja
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void

Powiązane elementy interfejsu API

IDataInput.readObject()
writeObject()
Klasa ObjectEncoding

Szczegół metody

writeBoolean

()

metoda

public function writeBoolean(value:Boolean):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje wartość typu Boolean. Zapisany zostanie pojedynczy bajt zgodnie z parametrem value — 1 dla true lub 0 dla false.

Parametry

value:Boolean — Wartość typu Boolean, która określa zapisywany bajt. Jeśli parametr ma wartość true, zapisywana jest wartość 1; jeśli ma wartość false — zapisywana jest wartość 0.

writeByte

()

metoda

public function writeByte(value:int):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje bajt. Używanych jest 8 najmniej znaczących bitów parametru; bardziej znaczące 24 bitów jest ignorowane.

Parametry

value:int — Wartość bajtu jako liczba całkowita.

writeBytes

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje sekwencję bajtów z określonej tablicy bajtowej bytes, rozpoczynając od bajta określanego przez parametr offset (indeksowanego od zera) o długości określonej w parametrze length do strumienia pliku, strumienia bajtów lub tablicy bajtowej.

Jeśli parametr length został pominięty, używana jest domyślna długość 0 i zapisywany jest cały bufor począwszy od miejsca określonego parametrem offset. Jeśli parametr offset również został pominięty, zapisany zostanie cały bufor.

Jeśli wartość parametru offset lub length jest poza zakresem, parametry zostaną ograniczone do początku i końca tablicy bytes.

Parametry

	`bytes:ByteArray` — Tablica bajtów do zapisania.

	`offset:uint` (default = `0`) — Indeks zliczany od zera, który wskazuje pozycję w tablicy, od której rozpocznie się zapisywanie.

	`length:uint` (default = `0`) — Wartość całkowita bez znaku, która wskazuje odległość, do jakiej zostanie zapisany bufor.

writeDouble

()

metoda

public function writeDouble(value:Number):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje liczbę zmiennoprzecinkową o podwójnej precyzji (64 bity) wg normy IEEE 754.

Parametry

value:Number — Liczba zmiennoprzecinkowa o podwójnej precyzji (64-bitowa).

writeFloat

()

metoda

public function writeFloat(value:Number):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje liczbę zmiennoprzecinkową o pojedynczej precyzji (32 bity) wg normy IEEE 754.

Parametry

value:Number — Liczba zmiennoprzecinkowa o pojedynczej precyzji (32-bitowa).

writeInt

()

metoda

public function writeInt(value:int):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje 32-bitową liczbę całkowitą ze znakiem.

Parametry

value:int — Wartość bajtu jako liczba całkowita ze znakiem.

writeMultiByte

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje wielobajtowy ciąg do strumienia pliku, strumienia bajtów lub tablicy bajtowej przy użyciu określonego zestawu znaków.

Parametry

	`value:String` — Wartość ciągu znaków przeznaczona do zapisu.

	`charSet:String` — Ciąg znaków oznaczający zestaw znaków, który ma być używany. Dozwolone zestawy znaków to: `„shift-jis”`, `„cn-gb”`, `„iso-8859-1”` i inne. Pełną listę zawiera sekcja Obsługiwane zestawy znaków.

writeObject

()

metoda

public function writeObject(object:*):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje w strumieniu pliku, strumieniu bajtów lub w tablicy bajtów obiekt zakodowany w formacie serializowanym AMF.

Parametry

object:* — Obiekt, który ma być serializowany.

Powiązane elementy interfejsu API

objectEncoding
flash.net.registerClassAlias()

writeShort

()

metoda

public function writeShort(value:int):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje 16-bitową liczbę całkowitą. Używanych jest 16 najmniej znaczących bitów parametru; bardziej znaczące 16 bitów jest ignorowane.

Parametry

value:int — Wartość bajtu jako liczba całkowita.

writeUnsignedInt

()

metoda

public function writeUnsignedInt(value:uint):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje 32-bitową liczbę całkowitą bez znaku.

Parametry

value:uint — Wartość bajtu jako liczba całkowita bez znaku.

writeUTF

()

metoda

public function writeUTF(value:String):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje do strumienia pliku, strumienia bajtów lub tablicy bajtów ciąg znaków UTF-8. Długość ciągu znaków UTF-8 w bajtach jest zapisywana na początku jako 16-bitowa wartość integer, a po niej następują bajty reprezentujące znaki ciągu znaków.

Parametry

value:String — Wartość ciągu znaków przeznaczona do zapisu.

Zgłasza

RangeError — Jeśli długość jest większa niż 65535.

writeUTFBytes

()

metoda

public function writeUTFBytes(value:String):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zapisuje ciąg znaków UTF-8. Podobnie, jak writeUTF(), ale nie umieszcza przed ciągiem znaków przedrostka w postaci słowa zawierającego 16 bitów.

Parametry

value:String — Wartość ciągu znaków przeznaczona do zapisu.

Przykłady Sposób korzystania z tego przykładu

DataOutputExample.as

W poniższym przykładzie zastosowano klasę DataOutputExample w celu zapisania wartości typu boolean oraz zmiennoprzecinkowej (o podwójnej precyzji) reprezentacji liczby pi w tablicy bajtów. W tym celu należy wykonać następujące czynności:

Zadeklaruj nową instancję obiektu ByteArray: byteArr.
Zapisz wartość (typu Boolean) false w postaci równoważnika bajtowego oraz zmiennoprzecinkowy równoważnik (o podwójnej dokładności) matematycznej wartości liczby pi.
Odczytaj wstecz wartość typu Boolean i zmiennoprzecinkową liczbę o podwójnej precyzji.

Na końcu został dodany segment kodu — sprawdź zakończenie błędów pliku, aby upewnić się, że strumień bajtów nie został odczytany poza koniec.

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.
            }
        }
    }
}

Informacje prawne | Zasady prywatności online

IDataOutput - AS3

Klasy x

endian

objectEncoding

writeBoolean

writeByte

writeBytes

writeDouble

writeFloat

writeInt

writeMultiByte

writeObject

writeShort

writeUnsignedInt

writeUTF

writeUTFBytes