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

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

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

IDataInput arabirimi ikili verileri okumak için bir yöntemler kümesi sağlar. Bu arabirim, IDataInput arabiriminin ikili verileri yazan G/Ç karşılığıdı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. Yetersiz veri mevcutsa, bir EOFError istisnası atılır. Okunmak için ne kadar verinin mevcut olduğunu belirlemek için IDataInput.bytesAvailable özelliğini kullanın.

İş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

IDataOutput arabirimi
endian
FileStream sınıfı
Socket sınıfı
URLStream sınıfı
ByteArray sınıfı
EOFError sınıfı

Genel Özellikler

	Özellik		Tanımlayan:
		bytesAvailable : uint [salt okunur] Girdi arabelleğindeki okunmak için bekleyen bayt sayısını döndürür.	IDataInput
		endian : String Veriler için bayt sırası; Endian sınıfından BIG_ENDIAN veya LITTLE_ENDIAN sabiti.	IDataInput
		objectEncoding : uint readObject() yöntemini kullanarak ikili veri yazarken veya okurken, AMF3 ve AMF0 biçimlerinden hangisinin kullanıldığını belirlemek için kullanılır.	IDataInput

Genel Yöntemler

	Yöntem		Tanımlayan:
		readBoolean():Boolean Dosya akışından, bayt akışından veya bayt dizisinden bir Boolean değeri okur.	IDataInput
		readByte():int Dosya akışından, bayt akışından veya bayt dizisinden tek bir işaretli baytı okur.	IDataInput
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Dosya akışından, bayt akışından veya bayt dizisinden length parametresinde belirtilen sayıda veri baytı okur.	IDataInput
		readDouble():Number Dosya akışından, bayt akışından veya bayt dizisinden bir IEEE 754 çift kesinlikli kayar nokta sayısı okur.	IDataInput
		readFloat():Number Dosya akışından, bayt akışından veya bayt dizisinden bir IEEE 754 tek kesinlikli kayar nokta sayısı okur.	IDataInput
		readInt():int Dosya akışından, bayt akışından veya bayt dizisinden işaretli bir 32 bit tam sayı okur.	IDataInput
		readMultiByte(length:uint, charSet:String):String Belirtilen karakter kümesini kullanarak dosya akışından, bayt akışından veya bayt dizisinden belirtilen uzunluğun bir çok baytlı dizesini okur.	IDataInput
		readObject():* Dosya akışından, bayt akışından veya bayt dizisinden AMF serileştirilmiş biçimde bir nesne okur.	IDataInput
		readShort():int Dosya akışından, bayt akışından veya bayt dizisinden işaretli bir 16 bit tam sayı okur.	IDataInput
		readUnsignedByte():uint Dosya akışından, bayt akışından veya bayt dizisinden tek bir işaretsiz baytı okur.	IDataInput
		readUnsignedInt():uint Dosya akışından, bayt akışından veya bayt dizisinden işaretsiz bir 32 bit tam sayı okur.	IDataInput
		readUnsignedShort():uint Dosya akışından, bayt akışından veya bayt dizisinden işaretsiz bir 16 bit tam sayı okur.	IDataInput
		readUTF():String Dosya akışından, bayt akışından veya bayt dizisinden bir UTF-8 dizesi okur.	IDataInput
		readUTFBytes(length:uint):String Bayt akışından veya bayt dizisinden bir sıra UTF-8 baytı okur ve bir dize döndürür.	IDataInput

Özellik Ayrıntısı

bytesAvailable

özellik

bytesAvailable:uint [salt okunur]

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Girdi arabelleğindeki okunmak için bekleyen bayt sayısını döndürür. Kullanıcı kodu, okumayı denemeden önce yeterli verinin bulunduğundan emin olmak için bytesAvailable öğesini çağırmalıdır.

Uygulama
public function get bytesAvailable():uint

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

readObject() 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

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

Yöntem Ayrıntısı

readBoolean

()

yöntem

public function readBoolean():Boolean

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışından, bayt akışından veya bayt dizisinden bir Boolean değeri okur. Tek bir bayt okunur ve bu bayt sıfır değilse true değeri; aksi halde false değeri döndürülür.

Döndürür

Boolean — Bir Boolean değeri; bayt sıfır olmayansa true aksi halde false olur.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readByte

()

yöntem

public function readByte():int

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışından, bayt akışından veya bayt dizisinden tek bir işaretli baytı okur.

Döndürür

int — Döndürülen değer -128 ile 127 aralığındadır.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readBytes

()

yöntem

public function readBytes(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

Dosya akışından, bayt akışından veya bayt dizisinden length parametresinde belirtilen sayıda veri baytı okur. Baytlar, offset öğesi tarafından belirtilen konumdan başlayarak, bytes parametresi tarafından belirtilen ByteArray nesnesinin içine okunur.

Parametreler

	`bytes:ByteArray` — Verinin içine okunacağı `ByteArray` nesnesi.

	`offset:uint` (default = `0`) — Veri okumasının başlaması gereken `bytes` parametresi içine uzaklık.

	`length:uint` (default = `0`) — Okunacak bayt sayısı. Varsayılan 0 değeri mevcut tüm verilerin okunmasına neden olur.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readDouble

()

yöntem

public function readDouble():Number

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışından, bayt akışından veya bayt dizisinden bir IEEE 754 çift kesinlikli kayar nokta sayısı okur.

Döndürür

Number — Bir IEEE 754 çift kesinlikli kayar nokta sayısı.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readFloat

()

yöntem

public function readFloat():Number

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışından, bayt akışından veya bayt dizisinden bir IEEE 754 tek kesinlikli kayar nokta sayısı okur.

Döndürür

Number — Bir IEEE 754 tek keskinlikli kayar nokta sayısı yazar.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readInt

()

yöntem

public function readInt():int

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışından, bayt akışından veya bayt dizisinden işaretli bir 32 bit tam sayı okur.

Döndürür

int — Döndürülen değer -2147483648 ile 2147483647 aralığındadır.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readMultiByte

()

yöntem

public function readMultiByte(length:uint, charSet:String):String

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ışından, bayt akışından veya bayt dizisinden belirtilen uzunluğun bir çok baytlı dizesini okur.

Parametreler

	`length:uint` — Okunacak bayt akışından gelen bayt sayısı.

	`charSet:String` — Baytları yorumlamak için kullanılacak karakter kümesini gösteren 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. Not: `charSet` parametresinin değeri geçerli sistem tarafından tanınmazsa, Adobe^® Flash^® Player veya Adobe^® AIR^®, karakter kümesi olarak sistemin varsayılan kod sayfasını kullanır. Örneğin, `myTest.readMultiByte(22, "iso-8859-01")` içinde olduğu gibi `1` yerine `01` kullanan bir `charSet` parametresi değeri, geliştirme sisteminizde çalışabilir ancak başka bir sistemde çalışmaz. Diğer sistemde, Flash Player veya AIR çalışma zamanı, sistemin varsayılan kod sayfasını kullanacaktır.

Döndürür

String — UTF-8 kodlanmış dize.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readObject

()

yöntem

public function readObject():*

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışından, bayt akışından veya bayt dizisinden AMF serileştirilmiş biçimde bir nesne okur.

Döndürür

* — Serileştirilmemiş nesne.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

İlgili API Öğeleri

objectEncoding
flash.net.registerClassAlias()

readShort

()

yöntem

public function readShort():int

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışından, bayt akışından veya bayt dizisinden işaretli bir 16 bit tam sayı okur.

Döndürür

int — Döndürülen değer -32768 ile 32767 aralığındadır.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readUnsignedByte

()

yöntem

public function readUnsignedByte():uint

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışından, bayt akışından veya bayt dizisinden tek bir işaretsiz baytı okur.

Döndürür

uint — Döndürülen değer 0 ile 255 aralığındadır.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readUnsignedInt

()

yöntem

public function readUnsignedInt():uint

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışından, bayt akışından veya bayt dizisinden işaretsiz bir 32 bit tam sayı okur.

Döndürür

uint — Döndürülen değer 0 ile 4294967295 aralığındadır.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readUnsignedShort

()

yöntem

public function readUnsignedShort():uint

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışından, bayt akışından veya bayt dizisinden işaretsiz bir 16 bit tam sayı okur.

Döndürür

uint — Döndürülen değer 0 ile 65535 aralığındadır.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readUTF

()

yöntem

public function readUTF():String

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Dosya akışından, bayt akışından veya bayt dizisinden bir UTF-8 dizesi okur. Uzunluğu bayt olarak gösteren işaretsiz bir kısa değişkenin dizeye önek yapıldığı varsayılır.

Yöntem, Java^® IDataInput arabirimindeki readUTF() yöntemine benzer.

Döndürür

String — Karakterlerin bayt temsiliyle üretilen bir UTF-8 dizesi.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

readUTFBytes

()

yöntem

public function readUTFBytes(length:uint):String

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0, Flash Player 9, Flash Lite 4

Bayt akışından veya bayt dizisinden bir sıra UTF-8 baytı okur ve bir dize döndürür.

Parametreler

length:uint — Okunacak bayt sayısı.

Döndürür

String — Belirtilen uzunluktaki karakterlerin bayt temsiliyle üretilen bir UTF-8 dizesi.

Atar

EOFError — Okunacak yeterli veri mevcut değil.

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

DataInputExample.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 DataInputExample extends Sprite {        
        public function DataInputExample() {
            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

IDataInput - AS3

Paketlerx

Dil Öğeleri

Ekler

Paket flash.utils

bytesAvailable

endian

objectEncoding

readBoolean

readByte

readBytes

readDouble

readFloat

readInt

readMultiByte

readObject

readShort

readUnsignedByte

readUnsignedInt

readUnsignedShort

readUTF

readUTFBytes