Adobe® Flash® Platform için ActionScript® 3.0 Başvurusu
Ana Sayfa  |  Paket ve Sınıf Listesini Gizle |  Paketler  |  Sınıflar  |  Yenilikler  |  Dizin  |  Ekler  |  Niçin İngilizce?
Filtreler: Sunucudan Veri Alınıyor...
Sunucudan Veri Alınıyor...
flash.utils 

IDataInput  - AS3

Paketflash.utils
Arabirimpublic 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



Genel Özellikler
 ÖzellikTanı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öntemTanımlayan:
  
Dosya akışından, bayt akışından veya bayt dizisinden bir Boolean değeri okur.
IDataInput
  
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
  
Dosya akışından, bayt akışından veya bayt dizisinden bir IEEE 754 çift kesinlikli kayar nokta sayısı okur.
IDataInput
  
Dosya akışından, bayt akışından veya bayt dizisinden bir IEEE 754 tek kesinlikli kayar nokta sayısı okur.
IDataInput
  
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
  
Dosya akışından, bayt akışından veya bayt dizisinden AMF serileştirilmiş biçimde bir nesne okur.
IDataInput
  
Dosya akışından, bayt akışından veya bayt dizisinden işaretli bir 16 bit tam sayı okur.
IDataInput
  
Dosya akışından, bayt akışından veya bayt dizisinden tek bir işaretsiz baytı okur.
IDataInput
  
Dosya akışından, bayt akışından veya bayt dizisinden işaretsiz bir 32 bit tam sayı okur.
IDataInput
  
Dosya akışından, bayt akışından veya bayt dizisinden işaretsiz bir 16 bit tam sayı okur.
IDataInput
  
Dosya akışından, bayt akışından veya bayt dizisinden bir UTF-8 dizesi okur.
IDataInput
  
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

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

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

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.
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:
  1. Yeni bir ByteArray nesne örneği byteArr bildirin.
  2. Boolean false değerinin bayt eşdeğerini ve pi'nin matematiksel değerinin çift kesinlikli kayar nokta eşdeğerini yazın.
  3. 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.
            }
        }
    }
}




[ X ]Niçin İngilizce?
ActionScript 3.0 Başvurusu'ndaki içerik İngilizce görünür

ActionScript 3.0 Başvurusu'nun tüm bölümleri tüm dillere çevrilmemiştir. Bir dil öğesi çevrilmediğinde İngilizce görünür. Örneğin, ga.controls.HelpBox sınıfı hiçbir dile çevrilmez. Bu nedenle, başvurunun Türkçe versiyonunda ga.controls.HelpBox sınıfı İngilizce görünür.