FileStream  - AS3

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.

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

readObject() veya writeObject() yöntemini kullanarak ikili veri yazarken veya okurken, AMF3 ve AMF0 biçimlerinden hangisinin kullanıldığını belirtir.

Değer bir ObjectEncoding sınıfı sabitidir. Varsayılan olarak, AMF3 biçimi kullanılır.

İlgili API Öğeleri

Dosyadaki geçerli konum.

Değer, şu yöntemlerden biriyle değiştirilir:

• Özelliği açıkça ayarladığınızda
• FileStream nesnesinden okurken (okuma yöntemlerinden birini kullanarak)
• FileStream nesnesine yazarken

Konum, 2³² bayttan daha uzun dosyaları desteklemek üzere bir Number (uint yerine) olarak tanımlanır. Bu özelliğin değeri, her zaman 2⁵³'ten küçük bir tam sayıdır. Bu değeri, kesirli bir bileşene sahip bir sayıya ayarlarsanız değer, en yakın tam sayıya yuvarlanır.

Bir dosyayı eşzamansız olarak okurken, position özelliğini ayarlarsanız uygulama, okuma arabelleğini belirtilen konumda başlatılan verilerle doldurmaya başlar ve bytesAvailable özelliği 0 olarak ayarlanabilir. Verileri okumak için bir okuma yöntemi kullanmadan önce complete olayını bekleyin veya bir progress olayını bekleyin ve bir okuma yöntemi kullanmadan önce bytesAvailable özelliğini kontrol edin.

import flash.fileSystem.*;
import flash.utils.ByteArray;
import flash.events.Event;

var sourceFile:File = File.documentsDirectory.resolvePath("Apollo Test/test.txt");
var stream:FileStream = new FileStream();
stream.addEventListener(Event.COMPLETE, readBytes);
stream.openAsync(sourceFile, FileMode.READ);

function readBytes(e:Event):void {
    var bytes:ByteArray = new ByteArray();
    trace("position 0:", stream.position); // 0
    bytes[0] = stream.readByte();
    trace("position 1:", stream.position); // 1
    fileStream.readBytes(bytes, stream.position, 4); 
    trace("position 2:", stream.position); // 5
    stream.close();
}

Eşzamansız olarak dosya okunurken diskten okunacak minimum veri miktarı.

Bu özellik, eşzamansız bir akışın geçerli konumun ötesinde okumaya çalıştığı veri miktarını belirtir. Veriler, dosya sistemi sayfa boyutuna göre bloklar halinde okunur. Bu yüzden, 8KB (8192 bayt) sayfa boyutuna sahip bir bilgisayar sisteminde readAhead öğesini 9.000 olarak ayarlarsanız, çalışma zamanı bir kerede 2 blok veya 16384 bayt ileriye okur. Bu özelliğin varsayılan değeri sonsuzdur: varsayılan olarak, eşzamansız olarak okumak üzere açılan bir dosya, dosyanın sonuna kadar okur.

Okuma arabelleğinden veri okunması, readAhead özelliğinin değerini değiştirmez. Arabellekten veri okuduğunuzda yeni veriler, okuma arabelleğini yeniden doldurmak için içeri okunur.

readAhead özelliğinin eşzamanlı olarak açılan bir dosya üzerinde hiçbir etkisi yoktur.

Veriler eşzamansız olarak okunurken, FileStream nesnesi progress olayları gönderir. progress yöntemine ait olay işleyicisinde, gerekli bayt sayısının bulunup bulunmadığını kontrol edin (bytesAvailable özelliğini kontrol ederek ve ardından bir okuma yöntemi kullanarak verileri veri arabelleğinden okuyun.

import flash.filesystem.*;

var file:File = File.desktopDirectory.resolvePath("test.txt");
var fileStream:FileStream = new FileStream();
fileStream.readAhead = 100;
fileStream.addEventListener(ProgressEvent.PROGRESS, readProgressHandler)
fileStream.openAsync(file, FileMode.READ);
var results:ByteArray;

function readProgressHandler(event:ProgressEvent):void {
    if (fileStream.bytesAvailable >= 100) {
        fileStream.readBytes(results, 0, 100);
    }
}

Bir FileStream nesnesi oluşturur. Bir dosyayı açmak için open() veya openAsync() yöntemini kullanın.

İlgili API Öğeleri

FileStream nesnesini kapatır.

close() yöntemini çağırdıktan sonra veri okuyamaz veya yazamazsınız. Dosya eşzamansız olarak açılmışsa (FileStream nesnesi, dosyayı açmak için openAsync() yöntemini kullanmışsa), close() yönteminin çağrılması, nesnenin close olayını göndermesine neden olur.

Uygulamanın kapatılması, uygulamadaki FileStream nesneleriyle ilişkili tüm dosyaları otomatik olarak kapatır. Ancak, uygulamayı kapatmadan önce (verilerin yazıldığından emin olmak için), yazılacak bekleyen verilere sahip, eşzamansız olarak açılan tüm FileStream nesnelerinde bir closed olayı için kaydetmek en iyisidir.

open() veya openAsync() yöntemini çağırarak FileStream nesnesini yeniden kullanabilirsiniz. Bu işlem, FileStream nesnesiyle ilişkili tüm dosyaları kapatır, ancak close olayını göndermez.

Eşzamansız olarak açılan (openAsync() yöntemi kullanılarak) bir FileStream nesnesi için, bir FileStream nesnesi için close() yöntemini çağırsanız ve o nesneye başvuru olan özellikleri ve değişkenleri silseniz bile FileStream nesnesi, tamamlanmaları için kaydedilen bekleyen işlemler ve olay işleyicileri olduğu sürece çöpte toplanmaz. Özellikle, zıt şekilde başvuru yapılmamış FileStream nesnesi, şunlardan herhangi biri mümkün oldukça devam eder:

• Dosya okuma işlemleri için, dosyanın sonuna ulaşılmamıştır (ve complete olayı gönderilmemiştir).
• Çıktı verileri hala yazılabilir ve çıktıyla ilgili olaylar (outputProgress olayı veya ioError olayı), olay dinleyicilerini kaydetmiştir.

İlgili API Öğeleri

import flash.filesystem.*;
import flash.events.Event;
            
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.openAsync(file, FileMode.WRITE);
fileStream.writeUTFBytes("Hello");
fileStream.addEventListener(Event.CLOSE, fileClosed);
fileStream.close();

function fileClosed(event:Event):void {
    trace("closed");
}            

import flash.filesystem.*;
            
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.WRITE);
fileStream.writeUTF("Hello");
fileStream.close();

file parametresi tarafından belirtilen dosyayı işaret ederek FileStream nesnesini eşzamansız olarak açar.

FileStream nesnesi zaten açıksa yöntemin çağrılması, açılmadan önce dosyayı kapatır ve daha önce açılan dosya için başka bir olay (close dahil) teslim edilmez.

Dosya kilitlemeyi destekleyen sistemlerde "okuma" veya "yazma" modunda (FileMode.WRITE veya FileMode.UPDATE) açılan bir dosya kapatılana kadar okunabilir durumdadır.

Dosyada uygulayacağınız işlemler bittikten sonra, FileStream nesnesinin close() yöntemini çağırın. Bazı işletim sistemleri, aynı anda açık olan dosya sayısını sınırlar.

Parametreler

İlgili API Öğeleri

import flash.filesystem.*;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.READ);
var str:String = fileStream.readMultiByte(file.size, File.systemCharset);
trace(str);
fileStream.close();

file parametresi tarafından belirtilen dosyayı işaret ederek FileStream nesnesini eşzamansız olarak açar.

FileStream nesnesi zaten açıksa yöntemin çağrılması, açılmadan önce dosyayı kapatır ve daha önce açılan dosya için başka bir olay (close dahil) teslim edilmez.

fileMode parametresi FileMode.READ veya FileMode.UPDATE olarak ayarlanırsa AIR, dosya açılır açılmaz verileri girdi arabelleğine okur ve progress ve open olayları, veriler girdi arabelleğine okundukça gönderilir.

Dosya kilitlemeyi destekleyen sistemlerde "okuma" veya "yazma" modunda (FileMode.WRITE veya FileMode.UPDATE) açılan bir dosya kapatılana kadar okunabilir durumdadır.

Dosyada uygulayacağınız işlemler bittikten sonra, FileStream nesnesinin close() yöntemini çağırın. Bazı işletim sistemleri, aynı anda açık olan dosya sayısını sınırlar.

Parametreler

İlgili API Öğeleri

import flash.filesystem.*;
import flash.events.Event;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.addEventListener(Event.COMPLETE, fileCompleteHandler)
fileStream.openAsync(file, FileMode.READ);

function fileCompleteHandler(event:Event):void {
    var str:String = fileStream.readMultiByte(fileStream.bytesAvailable, File.systemCharset);
    trace(str);
    fileStream.close();
}

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.

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

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

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

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

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

Belirtilen karakter kümesini kullanarak dosya akışından, bayt akışından veya bayt dizisinden belirtilen uzunluğun bir çok baytlı dizesini okur.

Parametreler

İlgili API Öğeleri

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

İlgili API Öğeleri

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

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

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

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

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.

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

Parametreler

Dosyayı, FileStream nesnesinin position özelliği tarafından konumda kırpar.

Dosyanın sonundaki position özelliği tarafından belirtilen konumdaki baytlar silinir. Dosyanın yazmaya açık olması gerekir.

İlgili API Öğeleri

import flash.filesystem.*;

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.UPDATE);
if (file.size > 100) {
    fileStream.position = 100;
    fileStream.truncate();
}
fileStream.close();

var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.openAsync(file, FileMode.UPDATE);
trace("start", file.size)
if (file.size > 100) {
    fileStream.position = 100;
    fileStream.truncate();
}
fileStream.addEventListener(Event.CLOSE, fileClosed);
fileStream.close();
function fileClosed(event:Event):void {
    trace("closed", file.size); 
}

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 yazar. Parametrenin düşük 8 biti kullanılır; yüksek 24 bit yok sayılır.

Parametreler

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

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

Parametreler

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

Parametreler

32 bit işaretli tam sayı yazar.

Parametreler

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

Parametreler

İlgili API Öğeleri

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

Parametreler

İlgili API Öğeleri

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

Parametreler

32 bit işaretsiz tam sayı yazar.

Parametreler

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

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

Parametreler

Akışın close() yöntemine yapılan açık bir çağrı tarafından kapatıldığını gösterir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Ulaşılan akış sonunu gösterir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Eşzamansız bir G/Ç işlemi sırasında hata oluştuğunu gösterir.

Bu olay şu özelliklere sahiptir:

Önbelleğe alınan verilerin dosyaya yazıldığını gösterir.

Bu olay şu özelliklere sahiptir:

Akıştaki yeni verilerin kullanılabilirliğini gösterir.

Bu olay şu özelliklere sahiptir: