IDataOutput - API-referens för Adobe ActionScript® 3 (AS3 )

Paket	flash.utils
Gränssnitt	public interface IDataOutput
Implementorer	ByteArray, FileStream, Socket

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

IDataOutput-gränssnittet innehåller en uppsättning metoder för skrivning av binära data. Gränssnittet är I/O-motsvarigheten till IDataInput-gränssnittet som läser binära data. Gränssnittet IDataOutput implementeras av FileStream-, Socket- och ByteArray-klasserna.

Alla IDataInput- och IDataOutput-åtgärder är som standard "bigEndian" (den viktigaste byten i sekvensen lagras på den lägsta eller första lagringsadressen), och är inte blockerande.

Teckenförlängning gäller bara när du läser data, inte när du skriver dem. Därför behöver du inte olika skrivmetoder när du arbetar med IDataInput.readUnsignedByte() och IDataInput.readUnsignedShort(). Med andra ord:

Använd IDataOutput.writeByte()med IDataInput.readUnsignedByte() och IDataInput.readByte().
Använd IDataOutput.writeShort() med IDataInput.readUnsignedShort() och IDataInput.readShort().

Visa exemplen

Relaterade API-element

IDataInput-gränssnitt
endian
Klassen FileStream
Klassen Socket
Klassen URLStream
Klassen ByteArray

Publika egenskaper

	Egenskap		Definieras med
		endian : String Byteordning för data, antingen konstanten BIG_ENDIAN eller LITTLE_ENDIAN från klassen Endian.	IDataOutput
		objectEncoding : uint Används för att avgöra om formatet AMF3 eller AMF0 används vid skrivning till eller läsning av binärdata med writeObject()-metoden.	IDataOutput

Publika metoder

	Metod		Definieras med
		writeBoolean(value:Boolean):void Skriver ett booleskt värde.	IDataOutput
		writeByte(value:int):void Skriver en byte.	IDataOutput
		writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Skriver en sekvens av byte från den angivna bytearrayen, byte, med början på den byte som specificeras i offset (med ett nollbaserat index) med en längd specificerad i length, till filflödet, byteflödet eller bytearrayen.	IDataOutput
		writeDouble(value:Number):void Skriver ett IEEE 754-flyttal med dubbel precision (64 bitar).	IDataOutput
		writeFloat(value:Number):void Skriver ett IEEE 754-flyttal med enkel precision (32 bitar).	IDataOutput
		writeInt(value:int):void Skriver ett 32-bitars heltal med tecken.	IDataOutput
		writeMultiByte(value:String, charSet:String):void Skriver en flerbytesträng till filflödet, byteflödet eller bytearrayen med den angivna teckenuppsättningen.	IDataOutput
		writeObject(object:*):void Skriver ett objekt till filflödet, byteflödet eller bytearrayen i serialiserat AMF-format.	IDataOutput
		writeShort(value:int):void Skriver ett 16-bitars heltal.	IDataOutput
		writeUnsignedInt(value:uint):void Skriver ett 32-bitars heltal utan tecken.	IDataOutput
		writeUTF(value:String):void Skriver en UTF-8-sträng från filflödet, byteflödet eller bytearrayen.	IDataOutput
		writeUTFBytes(value:String):void Skriver en UTF-8-sträng.	IDataOutput

Egenskapsdetaljer

endian

egenskap

endian:String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Byteordning för data, antingen konstanten BIG_ENDIAN eller LITTLE_ENDIAN från klassen Endian.

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

Relaterade API-element

Klassen Endian

objectEncoding

egenskap

objectEncoding:uint

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Används för att avgöra om formatet AMF3 eller AMF0 används vid skrivning till eller läsning av binärdata med writeObject()-metoden. Det här värdet är en konstant från ObjectEncoding-klassen.

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

Relaterade API-element

IDataInput.readObject()
writeObject()
Klassen ObjectEncoding

Metoddetaljer

writeBoolean

()

metod

public function writeBoolean(value:Boolean):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver ett booleskt värde. En enkel byte skrivs i enlighet med parametern value, antingen 1 om värdet är true eller 0 om värdet är false.

Parametrar

value:Boolean — Ett booleskt värde, som fastställer vilken byte som skrivs. Om parametern är true skrivs 1. Om den är false skrivs 0.

writeByte

()

metod

public function writeByte(value:int):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver en byte. De första 8 bitarna i parametern används, de övre 24 bitarna ignoreras.

Parametrar

value:int — Ett bytevärde som heltal.

writeBytes

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver en bytesekvens från den angivna bytearrayen, bytes, med början på den byte som anges av offset (med ett nollbaserat index) och med den längd som anges av length, till filströmmen, byteströmmen eller bytearrayen.

Om parametern length utelämnas används standardlängden 0 och hela bufferten med början på offset skrivs. Om parametern offset också utelämnas skrivs hela bufferten.

Om parametern offset eller parameternlength är utanför intervallet kläms de ihop i början och slutet av bytes-arrayen

Parametrar

	`bytes:ByteArray` — Den bytearray som ska skrivas.

	`offset:uint` (default = `0`) — Ett nollbaserat indexvärde som anger positionen i den array där skrivningen ska börja.

	`length:uint` (default = `0`) — Ett heltal utan tecken som anger hur långt in i bufferten som det ska skrivas.

writeDouble

()

metod

public function writeDouble(value:Number):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver ett IEEE 754-flyttal med dubbel precision (64 bitar).

Parametrar

value:Number — Ett flyttal med dubbel precision (64 bitar).

writeFloat

()

metod

public function writeFloat(value:Number):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver ett IEEE 754-flyttal med enkel precision (32 bitar).

Parametrar

value:Number — Ett flyttal med enkel precision (32 bitar).

writeInt

()

metod

public function writeInt(value:int):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver ett 32-bitars heltal med tecken.

Parametrar

value:int — Ett bytevärde som heltal med tecken.

writeMultiByte

()

metod

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver en flerbytesträng till filflödet, byteflödet eller bytearrayen med den angivna teckenuppsättningen.

Parametrar

	`value:String` — Det strängvärde som ska skrivas.

	`charSet:String` — Strängen som anger den teckenuppsättning som ska användas. Möjliga teckenuppsättningsträngar är `"shift-jis"`, `"cn-gb"`, `"iso-8859-1"` med flera. En fullständig lista finns i Teckenuppsättningar som stöds.

writeObject

()

metod

public function writeObject(object:*):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver ett objekt till filflödet, byteflödet eller bytearrayen i serialiserat AMF-format.

Parametrar

object:* — Objektet som ska serialiseras.

Relaterade API-element

objectEncoding
flash.net.registerClassAlias()

writeShort

()

metod

public function writeShort(value:int):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver ett 16-bitars heltal. De första 16 bitarna i parametern används, de övre 16 bitarna ignoreras.

Parametrar

value:int — Ett bytevärde som heltal.

writeUnsignedInt

()

metod

public function writeUnsignedInt(value:uint):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver ett 32-bitars heltal utan tecken.

Parametrar

value:uint — Ett bytevärde som heltal utan tecken.

writeUTF

()

metod

public function writeUTF(value:String):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver en UTF-8-sträng från filflödet, byteflödet eller bytearrayen. Först skrivs längden på en UTF-8-sträng i byte, som ett 16-bitars heltal, följt av de byte som representerar strängens tecken.

Parametrar

value:String — Det strängvärde som ska skrivas.

Utlöser

RangeError — Om längden är större än 65535.

writeUTFBytes

()

metod

public function writeUTFBytes(value:String):void

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0, Flash Player 9, Flash Lite 4

Skriver en UTF-8-sträng. Liknar writeUTF() men använder inte ett ord på 16-bitar som prefix i strängen.

Parametrar

value:String — Det strängvärde som ska skrivas.

Exempel Så här använder du exemplet

DataOutputExample.as

I följande exempel används DataOutputExample-klassen för att skriva ett booleskt värde och motsvarigheten i flyttal med dubbelprecision av pi till en bytearray. Detta visas i följande steg:

Deklarera en ny ByteArray-objektinstans byteArr.
Skriv motsvarigheten i byte av det booleska värdet false och motsvarigheten i flyttal med dubbel precision av det matematiska värdet av pi.
Läs tillbaka det booleska värdet och flyttalet med dubbel precision.

Lägg märke till att ett kodsegment läggs till i slutet för att bevaka fel vid filslut och se till att byteflödet inte läses förbi slutet av filen.

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

Juridiska meddelanden | Onlinesekretesspolicy

IDataOutput - AS3

Klasser x

endian

objectEncoding

writeBoolean

writeByte

writeBytes

writeDouble

writeFloat

writeInt

writeMultiByte

writeObject

writeShort

writeUnsignedInt

writeUTF

writeUTFBytes