ByteArray  - AS3

Bayt dizisindeki geçerli konumdan dizinin sonuna kadar okunabilir verilerin bayt sayısı.

Geçerli veri okuduğunuzdan emin olmak için, bir ByteArray nesnesine eriştiğiniz her seferde, okuma yöntemleriyle birlikte bytesAvailable özelliğini kullanın.

ByteArray sınıfının Varsayılan nesne kodlamasını, yeni bir ByteArray örneğinde kullanmak üzere belirtir. Yeni bir ByteArray örneği oluşturduğunuzda, söz konusu örnekteki kodlama defaultObjectEncoding değeriyle başlar. defaultObjectEncoding özelliği ObjectEncoding.AMF3'e başlatılır.

Bir nesne ikili veriye yazıldığında veya veriden okunduğunda; ActionScript 3.0, ActionScript 2.0, ve ActionScript 1.0 biçimlerinden hangisinin kullanılacağını belirlemek için objectEncoding değeri kullanılır. Değer bir ObjectEncoding sınıfı sabitidir.

İlgili API Öğeleri

Veriye yönelik bayt sırasını değiştirir veya okur (Endian.BIG_ENDIAN veya Endian.LITTLE_ENDIAN). Varsayılan değer BIG_ENDIAN şeklindedir.

İlgili API Öğeleri

ByteArray nesnesinin bayt olarak uzunluğu.

Uzunluk geçerli uzunluktan daha büyük bir değere ayarlanırsa, bayt dizisinin sağ tarafı sıfırlarla doldurulur.

Uzunluk geçerli uzunluktan daha küçük bir değere ayarlanırsa bayt dizisi kesilir.

Bir ByteArray örneğine yazarken veya ByteArray örneğini okurken ActionScript 3.0, ActionScript 2.0 veya ActionScript 1.0 biçimlerinden hangisinin kullanılacağını belirlemek için kullanılır. Değer bir ObjectEncoding sınıfı sabitidir.

İlgili API Öğeleri

Dosya işaretçisinin geçerli konumunu bayt olarak ByteArray nesnesine taşır veya döndürür. Bu, okuma yöntemine gelen bir sonraki çağrının okumayı başlattığı veya yazma yöntemine gelen bir sonraki çağrının yazmayı başlattığı noktadır.

Bayt dizisinin temel belleğinin paylaşılabilir olup olmadığını belirtir. Paylaşılabilir bir bayt dizisi için, bayt dizisine başvuran tüm worker (işçi) öğelerindeki ByteArray örneklerinin tamamı temel sistem belleğinin aynısını kullanır. Varsayılan değer false olup temel belleğin worker (işçi) öğeleri arasında paylaşılmadığını belirtir.

Ayrıca bu özellik, çalışma zamanının Worker.setSharedProperty() yöntemi veya MessageChannel.send() yöntemi kullanılarak bir worker (işçi) öğesine iletilmesi durumunda bu bayt dizisi ile ne yaptığını etkiler:

• Not shareable: Bu özellik false olursa, bayt dizisi bir worker (işçi) öğesine iletildiğinde çalışma zamanı, yinelenen bayt dizisinin içeriklerinin depolanacağı yeni bir bellek kesiminin ayrılması da dahil, bayt dizisinin tam bir kopyasını oluşturur.
• Shareable: Bu özellik true olursa, bayt dizisi bir worker (işçi) öğesine iletildiğinde çalışma zamanı, hem ikinci worker (işçi) için oluşturulan yeni ByteArray örneğinin hem de orijinal ByteArray örneğinin içerikleri için depolama arabelleği olarak aynı temel belleği kullanır. Temelde her iki ByteArray örneği de aynı temel bayt dizisine referans içerir.

Eşzamanlı olarak birden çok worker (işçi) öğesinden paylaşılan bir bayt dizisine erişme yeteneği, her iki worker (işçi) öğesinin aynı anda bayt dizisinin temel belleğini işlediği istenmeyen bir durumla sonuçlanabilir. Paylaşılan belleğe erişimi kontrol etmek için birkaç mekanizma kullanabilirsiniz:

• ByteArray sınıfının atomicCompareAndSwapIntAt() ve atomicCompareAndSwapLength() yöntemleri tarafından sağlanan karşılaştırma ve takas mekanizmaları
• Mutex ve Condition sınıfları tarafından sağlanan özel mekanizmalar (flash.concurrent paketinde)

Bu özelliğin true olarak ayarlanması yalnızca bu bayt dizisini bir worker (işçi) öğesine ileten sonraki kodu etkiler. Önceden bir worker (işçi) öğesine iletilen bu bayt dizisinin herhangi bir kopyası, ayrı bir kopya olarak var olmaya devam eder.

Bu özelliği true değerinden false değerine değiştirirseniz, bayt dizisi için temel bellek hemen sistem belleğinin yeni bir kesimine kopyalanır. Bu ByteArray örneği, bu noktadan itibaren yeni temel belleği kullanır. Sonuç olarak bu bayt dizisinin temel belleği önceden paylaşılmış olsa da artık diğer worker (işçi) öğeleriyle paylaşılmaz. Sonradan bu bayt dizisini bir worker (işçi) öğesine iletirseniz, bunun temel belleği, shareable özelliği false olan herhangi bir ByteArray nesnesinde olduğu gibi kopyalanır.

Varsayılan değer şudur false.

İlgili API Öğeleri

Veri saklama ve akışınızı bir ByteArray sınıfının yöntemleri ile en iyileştirilmesi için paketlenmiş bir bayt dizisini temsil eden bir ByteArray örneği oluşturur.

Tek bir atomik işlemde, bu bayt dizisindeki bir tamsayı değerini başka bir tamsayı değeriyle karşılaştırır, bunlar eşleşirse, bu baytları başka bir değerle takas eder.

Bu yöntem, temel belleği birden çok worker (işçi) öğesi arasında paylaşılan bir bayt dizisi ile kullanılmak üzere tasarlanmıştır (ByteArray örneğinin shareable özelliği true'dur). Şu adım sırasını gerçekleştirir:

1. byteIndex argümanında belirtilen dizinden (bayt olarak ölçülür) başlayarak bu bayt dizisinden bir tamsayı değerini okur
2. Bu bayt dizisindeki gerçek değeri, expectedValue argümanında iletilen değerle karşılaştırır
3. İki değer eşitse, newValue argümanındaki değeri, byteIndex parametresi tarafından belirtilen konumdaki bayt dizisine yazar ve önceden bu bayt'larda bulunan değeri (1. adımda okunan değer) döndürür.
4. Aksi takdirde, bayt dizisinin içerikleri değiştirilmez ve yöntem, bayt dizisinden okunan gerçek değeri döndürür.

Tüm bu adımlar, tek bir atomik donanım işleminde gerçekleştirilir. Bu, diğer worker (işçi) öğelerindeki işlemlerin, karşılaştırma ve takas işlemi sırasında bayt dizisi içerikleri üzerinde bir değişiklik yapmamasını garanti eder.

Parametreler

İlgili API Öğeleri

Tek bir atomik işlemde, bu bayt dizisinin uzunluğunu, sağlanan bir değerle karşılaştırır ve bunlar eşleşirse, bu bayt dizisinin uzunluğunu değiştirir.

Bu yöntem, temel belleği birden çok worker (işçi) öğesi arasında paylaşılan bir bayt dizisi ile kullanılmak üzere tasarlanmıştır (ByteArray örneğinin shareable özelliği true'dur). Aşağıdakileri yapar:

1. ByteArray örneğinin tamsayı length özelliğini okur
2. Uzunluğu, expectedLength argümanında iletilen değerle karşılaştırır
3. İki değer eşitse, bayt dizisinin boyutunu büyüterek veya azaltarak, bayt dizisinin uzunluğunu, newLength parametresi olarak iletilen değerle değiştirir.
4. Aksi takdirde bayt dizisi değiştirilmez.

Tüm bu adımlar, tek bir atomik donanım işleminde gerçekleştirilir. Bu, diğer worker (işçi) öğelerindeki işlemlerin, karşılaştırma ve yeniden boyutlandırma işlemi sırasında bayt dizisi içerikleri üzerinde bir değişiklik yapmamasını garanti eder.

Parametreler

İlgili API Öğeleri

Bayt dizisinin içeriklerini temizler ve length ve position özelliklerini 0 değerine getirir. Bu yöntemin çağrılması, ByteArray örneği tarafından kullanılan bellekte açıkça yer açar.

Bayt dizisini sıkıştırır. Bayt dizisinin tamamı sıkıştırılır. Çağrıdan sonra, ByteArray öğesinin length özelliği yeni uzunluğa ayarlanır. position özelliği bayt dizisinin sonuna ayarlanır.

Bir değeri (CompressionAlgorithm sınıfında tanımlanan) algorithm parametresi şeklinde ileterek bir sıkıştırma algoritmasını belirtirsiniz. Desteklenen algoritmalar arasında aşağıdakiler bulunur:

Zlib sıkıştırılmış veri biçimi açıklaması için, bkz. http://www.ietf.org/rfc/rfc1950.txt

Deflate sıkıştırma algoritması açıklaması için, bkz. http://www.ietf.org/rfc/rfc1951.txt.

lzma sıkıştırma algoritması açıklaması için bkz. http://www.7-zip.org/7z.html.

Deflate sıkıştırma algoritması zlib, gzip ve bazı zip uygulamaları ve diğerleri gibi çeşitli sıkıştırma biçimlerinde kullanılır. Veri söz konusu sıkıştırma biçimlerinden biri kullanılarak sıkıştırıldığında, orijinal verinin sıkıştırılmış versiyonunun saklanmasının yanı sıra sıkıştırma biçimi verisi (örneğin, .zip dosyası) meta veri bilgisini de içerir. Çeşitli dosya biçimlerine dahil edilen meta veri türlerinden bazıları dosya adı, dosyanın değiştirilme tarihi/saati, orijinal dosya boyutu, isteğe bağlı yorumlar, sağlama toplamı verisi ve daha fazlasıdır.

Örneğin, bir ByteArray zlib algoritması kullanılarak sıkıştırıldığında, ortaya çıkan ByteArray belirli bir biçimde yapılandırılır. Belirli baytlar sıkıştırılan veri hakkında meta verisi içerirken, diğer baytlar orijinal ByteArray verisinin gerçek sıkıştırılmış versiyonunu içerir. Zlib sıkıştırılmış veri biçimi belirtimi tarafından tanımlandığı gibi, söz konusu baytlar (orijinal verinin sıkıştırılmış versiyonunu içeren bölüm) deflate algoritması kullanılarak sıkıştırılır. Sonuç olarak bu baytlar, orijinal ByteArray üzerinde compress(air.CompressionAlgorithm.DEFLATE) yöntemine yapılan çağrının sonucuyla aynıdır. Ancak, compress(air. CompressionAlgorithm.ZLIB) sonucu ekstra meta verisi içerirken, compress(CompressionAlgorithm.DEFLATE) sonucu yalnızca orijinal bir ByteArray verisinin sıkıştırılmış versiyonunu içerir.

Bir ByteArray örneği verisini gzip veya zip gibi belirli bir biçimde sıkıştırmak üzere deflate biçimini kullanmak için compress(CompressionAlgorithm.DEFLATE) yöntemini çağırmanız yeterli olmaz. Deflate biçimi kullanılarak elde edilen sıkıştırılmış verinin yanında uygun meta veri de dahil olmak üzere, biçimin belirtimine uygun şekilde yapılandırılmış bir ByteArray oluşturmanız gerekir. Aynı şekilde, gzip veya zip gibi bir biçimde sıkıştırılmış veri kodunu çözmek için, söz konusu verinin üzerine uncompress(CompressionAlgorithm.DEFLATE) çağırmanız yeterli olmaz. İlk olarak, meta verisini sıkıştırılmış veriden ayırmanız gerekir, bunun ardından sıkıştırılmış verinin sıkıştırmasını açmak için deflate biçimini kullanabilirsiniz.

Parametreler

İlgili API Öğeleri

Deflate sıkıştırma algoritmasını kullanarak bayt dizisini sıkıştırır. Bayt dizisinin tamamı sıkıştırılır.

Çağrıdan sonra, ByteArray öğesinin length özelliği yeni uzunluğa ayarlanır. position özelliği bayt dizisinin sonuna ayarlanır.

Deflate sıkıştırma algoritması açıklaması için, bkz. http://www.ietf.org/rfc/rfc1951.txt.

Bir ByteArray örneği verisini gzip veya zip gibi belirli bir biçimde sıkıştırmak üzere deflate biçimini kullanmak için deflate() yöntemini çağırmanız yeterli olmaz. Deflate biçimi kullanılarak elde edilen sıkıştırılmış verinin yanında uygun meta veri de dahil olmak üzere, biçimin belirtimine uygun şekilde yapılandırılmış bir ByteArray oluşturmanız gerekir. Aynı şekilde, gzip veya zip gibi bir biçimde sıkıştırılmış veri kodunu çözmek için, söz konusu verinin üzerine inflate() yöntemini çağırmanız yeterli olmaz. İlk olarak, meta verisini sıkıştırılmış veriden ayırmanız gerekir, bunun ardından sıkıştırılmış verinin sıkıştırmasını açmak için deflate biçimini kullanabilirsiniz.

İlgili API Öğeleri

Deflate sıkıştırma algoritmasını kullanarak bayt dizisinin sıkıştırmasını açar. Bayt dizisi aynı algoritma kullanılarak sıkıştırılmış olmalıdır.

Çağrıdan sonra, ByteArray öğesinin length özelliği yeni uzunluğa ayarlanır. position özelliği 0 olarak ayarlanır.

Deflate sıkıştırma algoritması açıklaması için, bkz. http://www.ietf.org/rfc/rfc1951.txt.

gzip veya zip biçimindeki veriler gibi deflate sıkıştırma algoritması kullanan bir biçimde sıkıştırılmış verinin kodunu çözmek için, sıkıştırma formasyonu verisini içeren bir ByteArray üzerinde inflate() yönteminin çağrılması işe yaramayacaktır. Öncelikle sıkıştırılmış veri biçiminin bir parçası olarak dahil edilen meta verisini gerçek sıkıştırılmış veriden ayırmanız gerekir. Daha fazla bilgi için, compress() yöntemi açıklamasına bakın.

İlgili API Öğeleri

Bayt akışından bir Boolean değeri okur. Tek bir bayt okunur, bayt sıfır olmayansa true, aksi halde false döndürülür.

Bayt akışından işaretli bir bayt okur.

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

Bayt akışından length parametresinde belirtilen sayıda veri baytı okur. Baytlar bytes parametresi tarafından belirtilen ByteArray nesnesine okunur ve offset tarafından belirtilen konumdan başlayarak hedef ByteArray içine yazılır.

Parametreler

Bayt akışından bir IEEE 754 çift kesinlikli (64 bit) kayar nokta sayısı okur.

Bayt akışından bir IEEE 754 tek kesinlikli (32 bit) kayar nokta sayısı okur.

Bayt akışından işaretli bir 32 bit tam sayı okur.

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

Bayt akışından, belirtilen karakter kümesini kullanarak belirtilen uzunlukta çok baytlı bir dize okur.

Parametreler

Bayt dizisinden AMF serileştirilmiş biçimde kodlanmış bir nesne okur.

İlgili API Öğeleri

Bayt akışından işaretli bir 16 bit tam sayı okur.

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

Bayt akışından işaretsiz bir bayt okur.

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

Bayt akışından işaretsiz bir 32 bit tam sayı okur.

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

Bayt akışından işaretsiz bir 16 bit tam sayı okur.

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

Bayt akışından 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.

İlgili API Öğeleri

Bayt akışından length parametresi tarafından belirtilen bir sıra UTF-8 baytı okur ve bir dize döndürür.

Parametreler

Bir ByteArray nesnesindeki değerlerin JSON kodlamasını özelleştirmek için geçersiz kılınabilir bir yöntem sağlar.

JSON.stringify() yöntemi, geçtiği her nesnede bir toJSON() yöntemi arar. toJSON() yöntemi bulunursa JSON.stringify() yöntemi, karşılaştığı her bir değer için onu çağırır ve değerle eşleşen tuşu iletir.

ByteArray, toJSON() öğesinin yalnızca sınıf adını döndüren bir varsayılan uygulamasını sağlar. Herhangi bir ByteArray öğesinin içeriği yorumlama gerektirdiğinden, ByteArray nesnelerini JSON kodlamasına dışa aktarmak isteyen istemcilerin kendi uygulamalarını sağlamaları gereklidir. toJSON() yöntemini sınıf prototipinde yeniden tanımlayarak bunu gerçekleştirebilirsiniz.

toJSON() yöntemi herhangi bir türde değer döndürebilir. Bir nesne döndürürse, stringify() o nesne içinde kendi kendini yineler. toJSON() bir dize döndürürse, stringify() kendi kendini yinelemez ve geçişine devam eder.

Parametreler

İlgili API Öğeleri

Bayt dizisini bir dizeye dönüştürür. Dizideki veri bir Unicode bayt sırası işaretiyle başlıyorsa, uygulama dizeye dönüştürürken söz konusu işareti dikkate alır. System.useCodePage true olarak ayarlanırsa, uygulama dönüştürme sırasında dizideki veriye geçerli sistem kodu sayfasındaymış gibi davranır.

Bayt dizisinin sıkıştırmasını açar. Çağrıdan sonra, ByteArray öğesinin length özelliği yeni uzunluğa ayarlanır. position özelliği 0 olarak ayarlanır.

Bayt dizisi sıkıştırmayı kaldırma ile aynı algoritma kullanılarak sıkıştırılmış olmalıdır. Bir değeri (CompressionAlgorithm sınıfında tanımlanan) algorithm parametresi şeklinde ileterek bir sıkıştırmayı kaldırma algoritmasını belirtirsiniz. Desteklenen algoritmalar arasında aşağıdakiler bulunur:

Zlib sıkıştırılmış veri biçimi açıklaması için, bkz. http://www.ietf.org/rfc/rfc1950.txt

Deflate sıkıştırma algoritması açıklaması için, bkz. http://www.ietf.org/rfc/rfc1951.txt.

lzma sıkıştırma algoritması açıklaması için bkz. http://www.7-zip.org/7z.html.

Gzip veya zip biçimli veriler gibi deflate sıkıştırma algoritması kullanan bir biçimde sıkıştırılmış verinin kodunu çözmek için, sıkıştırma formasyonu verisini içeren bir ByteArray üzerine uncompress(CompressionAlgorithm.DEFLATE) çağırmak işe yaramayacaktır. Öncelikle sıkıştırılmış veri biçiminin bir parçası olarak dahil edilen meta verisini gerçek sıkıştırılmış veriden ayırmanız gerekir. Daha fazla bilgi için, compress() yöntemi açıklamasına bakın.

Parametreler

İlgili API Öğeleri

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

Bayt akışına bayt yazar.

Parametrenin düşük 8 biti kullanılır. Yüksek 24 bit göz ardı edilir.

Parametreler

Belirtilen bayt dizisinden, bytes öğesinden ve başlangıç offset (sıfır temelli dizin) baytlarından, bayt akışına bir length baytları sırası yazar.

length parametresi atlanırsa, varsayılan uzunluk değeri olan 0 kullanılır ve yöntem, offset öğesinden başlayarak arabelleğin tamamını yazar. Offset parametresi de atlanırsa, arabelleğin tamamı yazılır.

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

Parametreler

Bayt akışına IEEE 754 çift kesinlikli (64 bit) kayar nokta sayısı yazar.

Parametreler

Bayt akışına IEEE 754 tek keskinlikli (32 bit) kayar nokta sayısı yazar.

Parametreler

Bayt akışına 32 bit işaretli tam sayı yazar.

Parametreler

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

Parametreler

Bayt dizisine AMF serileştirilmiş biçimde bir nesne yazar.

Parametreler

İlgili API Öğeleri

Bayt akışına 16 bit tam sayı yazar. Parametrenin düşük 16 biti kullanılır. Yüksek 16 bit göz ardı edilir.

Parametreler

Bayt akışına 32 bit işaretsiz tam sayı yazar.

Parametreler

Bayt akışına 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

Bayt akışına UTF-8 dizesi yazar. writeUTF() yöntemine benzer, ancak writeUTFBytes() dizeye 16 bit uzunluğunda bir kelimeyi önek olarak eklemez.

Parametreler

1. Yeni bir ByteArray nesne örneği byteArr bildirin.
2. Boolean false değerinin bayt eşdeğerini yazın ve uzunluğu kontrol edip yeniden okuyun.
3. Pi'nin matematiksel değerinin çift kesinlikli kayar nokta değerini yazın.
4. Bayt dizisine yazılan dokuz baytın her birini yeniden okuyun.

Not: trace() bir bayt üzerine çağrıldığında, bayt dizisinde saklanan baytların ondalık eşdeğerini yazdırır.

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 ByteArrayExample extends Sprite {        
        public function ByteArrayExample() {
            var byteArr:ByteArray = new ByteArray();

            byteArr.writeBoolean(false);
            trace(byteArr.length);            // 1
            trace(byteArr[0]);            // 0

            byteArr.writeDouble(Math.PI);
            trace(byteArr.length);            // 9
            trace(byteArr[0]);            // 0
            trace(byteArr[1]);            // 64
            trace(byteArr[2]);            // 9
            trace(byteArr[3]);            // 33
            trace(byteArr[4]);            // 251
            trace(byteArr[5]);            // 84
            trace(byteArr[6]);            // 68
            trace(byteArr[7]);            // 45
            trace(byteArr[8]);            // 24
            
            byteArr.position = 0;

            try {
                trace(byteArr.readBoolean() == false); // true
            } 
            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.
            }
        }
    }
}