IDataOutput - Adobe ActionScript® 3 (AS3 ) API Başvurusu

Paket	flash.utils
Arabirim	public interface IDataOutput
Uygulayıcılar	ByteArray, FileStream, Socket

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

IDataOutput arabirimi ikili verileri yazmak için bir yöntemler kümesi sağlar. Bu arabirim, IDataInput arabiriminin ikili verileri okuyan G/Ç karşılığıdır. IDataOutput arabirimi FileStream, Socket ve ByteArray sınıfları tarafından uygulanır.

Bütün IDataInput ve IDataOutput işlemleri varsayılan olarak "bigEndian" olur (sıradaki en yüksek değerli bayt en düşük değerli veya ilk saklama adresinde saklanır) ve tıkanmasızdır.

İşaret uzantısı veri yazarken değil yalnızca veri okurken önem taşır. Bu yüzden, IDataInput.readUnsignedByte() ve IDataInput.readUnsignedShort() öğeleri için ayrı yazma yöntemlerine ihtiyacınız yoktur. Diğer bir değişle:

IDataOutput.writeByte() öğesini IDataInput.readUnsignedByte() ve IDataInput.readByte() ile birlikte kullanın.
IDataOutput.writeShort() öğesini IDataInput.readUnsignedShort() ve IDataInput.readShort() ile birlikte kullanın.

Örnekleri görüntüle

İlgili API Öğeleri

IDataInput arabirimi
endian
FileStream sınıfı
Socket sınıfı
URLStream sınıfı
ByteArray sınıfı

Genel Özellikler

	Özellik		Tanımlayan:
		endian : String Veriler için bayt sırası; Endian sınıfından BIG_ENDIAN veya LITTLE_ENDIAN sabiti.	IDataOutput
		objectEncoding : uint writeObject() yöntemini kullanarak ikili veri yazarken veya okurken, AMF3 ve AMF0 biçimlerinden hangisinin kullanıldığını belirlemek için kullanılır.	IDataOutput

Genel Yöntemler

	Yöntem		Tanımlayan:
		writeBoolean(value:Boolean):void Boolean değeri yazar.	IDataOutput
		writeByte(value:int):void Bayt yazar.	IDataOutput
		writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Length ile belirtilen uzunluğa sahip offset (sıfır temelli dizin kullanan) tarafından belirtilen bayttan başlayarak, belirtilen bytes bayt dizisinden bir dizi baytı dosya akışına, bayt akışına veya bayt dizisine yazar.	IDataOutput
		writeDouble(value:Number):void IEEE 754 çift kesinlikli (64 bit) kayan nokta sayısı yazar.	IDataOutput
		writeFloat(value:Number):void IEEE 754 tek keskinlikli (32 bit) kayar nokta sayısı yazar.	IDataOutput
		writeInt(value:int):void 32 bit işaretli tam sayı yazar.	IDataOutput
		writeMultiByte(value:String, charSet:String):void Belirtilen karakter kümesini kullanarak dosya akışına, bayt akışına veya bayt dizisine çok baytlı dize yazar.	IDataOutput
		writeObject(object:*):void AMF serileştirilmiş biçimde dosya akışına, bayt akışına veya bayt dizisine nesne yazar.	IDataOutput
		writeShort(value:int):void 16 bit tam sayı yazar.	IDataOutput
		writeUnsignedInt(value:uint):void 32 bit işaretsiz tam sayı yazar.	IDataOutput
		writeUTF(value:String):void Dosya akışına, bayt akışına veya bayt dizisine bir UTF-8 dizesi yazar.	IDataOutput
		writeUTFBytes(value:String):void UTF-8 dizesi yazar.	IDataOutput

Özellik Ayrıntısı

endian

özellik

endian:String

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Veriler için bayt sırası; Endian sınıfından BIG_ENDIAN veya LITTLE_ENDIAN sabiti.

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

İlgili API Öğeleri

Endian sınıfı

objectEncoding

özellik

objectEncoding:uint

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

writeObject() yöntemini kullanarak ikili veri yazarken veya okurken, AMF3 ve AMF0 biçimlerinden hangisinin kullanıldığını belirlemek için kullanılır. Değer bir ObjectEncoding sınıfı sabitidir.

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

İlgili API Öğeleri

IDataInput.readObject()
writeObject()
ObjectEncoding sınıfı

Yöntem Ayrıntısı

writeBoolean

()

yöntem

public function writeBoolean(value:Boolean):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Boolean değeri yazar. Tek bir bayt value parametresine göre, true olması durumunda 1 ve false olması durumunda 0 olarak yazılır.

Parametreler

value:Boolean — Hangi baytın yazıldığını belirleyen Boolean değeri. Parametre true olursa 1 yazılır, parametre false olursa 0 yazılır.

writeByte

()

yöntem

public function writeByte(value:int):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Bayt yazar. Parametrenin düşük 8 biti kullanılır; yüksek 24 bit yok sayılır.

Parametreler

value:int — Tam sayı olarak bayt değeri.

writeBytes

()

yöntem

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

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Length ile belirtilen uzunluğa sahip offset (sıfır temelli dizin kullanan) tarafından belirtilen bayttan başlayarak, belirtilen bytes bayt dizisinden ve baytlardan bir dizi baytı dosya akışına, bayt akışına veya bayt dizisine yazar.

Length parametresi atlanırsa, varsayılan uzunluk değeri olan 0 kullanır ve offset öğesinden başlayan arabelleğin tamamı yazılır. Offset parametresi de atlanırsa, arabelleğin tamamı yazılır.

offset veya length parametreleri aralık dışındaysa, bu parametreler başlangıca ve bytes dizisinin sonuna kelepçelenir.

Parametreler

	`bytes:ByteArray` — Yazılacak bayt dizisi.

	`offset:uint` (default = `0`) — Dizi içinde yazmanın başlatılacağı konumu belirtilen sıfır temelli bir dizin.

	`length:uint` (default = `0`) — Arabellekte nereye kadar yazılacağını belirten işaretsiz bir tam sayı.

writeDouble

()

yöntem

public function writeDouble(value:Number):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

IEEE 754 çift kesinlikli (64 bit) kayan nokta sayısı yazar.

Parametreler

value:Number — Çift kesinlikli (64 bit) kayar nokta sayısı.

writeFloat

()

yöntem

public function writeFloat(value:Number):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

IEEE 754 tek keskinlikli (32 bit) kayar nokta sayısı yazar.

Parametreler

value:Number — Tek kesinlikli (32 bit) kayar nokta sayısı.

writeInt

()

yöntem

public function writeInt(value:int):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

32 bit işaretli tam sayı yazar.

Parametreler

value:int — İşaretli tam sayı olarak bayt değeri.

writeMultiByte

()

yöntem

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

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Belirtilen karakter kümesini kullanarak dosya akışına, bayt akışına veya bayt dizisine çok baytlı dize yazar.

Parametreler

	`value:String` — Yazılacak dize değeri.

	`charSet:String` — Kullanılacak karakter kümesini belirten dize. Olası karakter kümesi dizeleri `"shift-jis"`, `"cn-gb"`, `"iso-8859-1"` ve diğerlerini içerir. Tam liste için, bkz. Desteklenen Karakter Kümeleri.

writeObject

()

yöntem

public function writeObject(object:*):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

AMF serileştirilmiş biçimde dosya akışına, bayt akışına veya bayt dizisine nesne yazar.

Parametreler

object:* — Serileştirilecek nesne.

İlgili API Öğeleri

objectEncoding
flash.net.registerClassAlias()

writeShort

()

yöntem

public function writeShort(value:int):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

16 bit tam sayı yazar. Parametrenin düşük 16 biti kullanılır; yüksek 16 bit yok sayılır.

Parametreler

value:int — Tam sayı olarak bayt değeri.

writeUnsignedInt

()

yöntem

public function writeUnsignedInt(value:uint):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

32 bit işaretsiz tam sayı yazar.

Parametreler

value:uint — İşaretsiz tam sayı olarak bayt değeri.

writeUTF

()

yöntem

public function writeUTF(value:String):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışına, bayt akışına veya bayt dizisine bir UTF-8 dizesi yazar. Önce UTF-8 dizisinin bayt cinsinden uzunluğu 16 bit tam sayı olarak yazılır, dizenin karakterlerini temsil eden baytlar takip eder.

Parametreler

value:String — Yazılacak dize değeri.

Atar

RangeError — Uzunluk 65535'ten büyükse.

writeUTFBytes

()

yöntem

public function writeUTFBytes(value:String):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

UTF-8 dizesi yazar. writeUTF() öğesine benzer, ancak dizeye 16 bit uzunluğunda bir kelimeyi önek olarak eklemez.

Parametreler

value:String — Yazılacak dize değeri.

Örnekler Bu örnek nasıl kullanılır?

DataOutputExample.as

Aşağıdaki örnek, bir bayt dizisine bir boolean ve pi'nin çift kesinlikli kayar nokta temsilini yazmak için DataOutputExample sınıfını kullanır. Bu işlem, şu adımlar kullanılarak gerçekleştirilir:

Yeni bir ByteArray nesne örneği byteArr bildirin.
Boolean false değerinin bayt eşdeğerini ve pi'nin matematiksel değerinin çift kesinlikli kayar nokta eşdeğerini yazın.
Boolean ve çift kesinlikli kayar nokta sayısını geri okuyun.

Bayt akışının kendi sonundan ötesinin okunmadığından emin olmak için, dosya sonu hatalarını denetlemek üzere en sona bir kod parçasının eklendiğine dikkat edin.

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

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

IDataOutput - AS3

Paketlerx

Dil Öğeleri

Ekler

Paket flash.utils

endian

objectEncoding

writeBoolean

writeByte

writeBytes

writeDouble

writeFloat

writeInt

writeMultiByte

writeObject

writeShort

writeUnsignedInt

writeUTF

writeUTFBytes