FileStream  - AS3

Restituisce il numero di byte dei dati disponibili per la lettura nel buffer di input. Il codice utente deve chiamare bytesAvailable per verificare che i dati disponibili siano sufficienti prima di tentare di leggerli mediante uno dei metodi di lettura.

L'ordine dei byte dei dati: costante BIG_ENDIAN o LITTLE_ENDIAN della classe Endian.

Specifica se impiegare il formato AMF3 o AMF0 durante la scrittura o lettura di dati binari mediante il metodo readObject() o writeObject().

Questo valore è una costante della classe ObjectEncoding. Per impostazione predefinita, il formato utilizzato è AMF3.

Elementi API correlati

La posizione corrente nel file.

Questo valore viene modificato in uno dei modi seguenti:

• quando impostate la proprietà in modo esplicito;
• durante la lettura dall'oggetto FileStream (utilizzando uno dei metodi di lettura);
• durante la scrittura sull'oggetto FileStream.

La posizione viene definita come numero (anziché come unità) per poter supportare file di lunghezza superiore a 2³² byte. Il valore di questa proprietà è sempre un numero intero inferiore a 2⁵³. Se impostate questo valore su un numero decimale, il valore viene arrotondato sul numero intero più vicino.

Durante la lettura di un file in modo asincrono, se impostate la proprietà position, l'applicazione inizierà a riempire il buffer di lettura con i dati a partire dalla posizione specificata e la proprietà bytesAvailable può essere impostata su 0. Prima di utilizzare un metodo di lettura per leggere i dati, aspettate di ricevere un evento complete; oppure aspettate un evento progress e verificate la proprietà bytesAvailable prima di usare il metodo di lettura.

Altri esempi

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();
}

La quantità minima di dati da leggere da disco quando i file vengono letti in modalità asincrona.

Questa proprietà specifica la quantità di dati che un flusso asincrono tenta di leggere oltre la posizione corrente. I dati vengono letti a blocchi in base alla dimensione di pagina del file system. Quindi, se impostate readAhead su 9,000 su un computer con dimensione pagina di 8 KB (8192 byte), il runtime legge 2 blocchi (16384 byte) alla volta. Il valore predefinito di questa proprietà è infinito; per impostazione predefinita, un file aperto per la lettura asincrona continua a leggere fino alla fine del file.

La lettura dei dati dal buffer di lettura non modifica il valore della proprietà readAhead. Durante la lettura dei dati dal buffer, i nuovi dati vengono letti all'interno del buffer per riempirlo.

La proprietà readAhead non ha alcun effetto su un file aperto in modo sincrono.

A mano a mano che i dati vengono letti in modo asincrono, l'oggetto FileStream invia eventi progress. Nel metodo del gestore eventi per l'evento progress, controllate che il numero di byte richiesto sia disponibile (verificando la proprietà bytesAvailable), quindi leggete i dati dal buffer di lettura mediante uno dei metodo di lettura.

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);
    }
}

Crea un oggetto FileStream. Utilizzate il metodo open() o openAsync() per aprire un file.

Elementi API correlati

Chiude l'oggetto FileStream.

Non è possibile leggere o scrivere dati dopo aver chiamato il metodo close(). Se il file è stato aperto in modo asincrono (l'oggetto FileStream ha usato il metodo openAsync() per aprire il file), una chiamata al metodo close() provoca l'invio dell'evento close da parte dell'oggetto.

Se l'applicazione viene chiusa, tutti i file associati a oggetti FileStream nell'applicazione vengono automaticamente chiusi. Tuttavia, è consigliabile registrare per un evento closed tutti gli oggetti FileStream aperti in modo asincrono che presentano dati in attesa di scrittura prima di chiudere l'applicazione (per assicurare che i dati vengano scritti).

Potete riutilizzare l'oggetto FileStream chiamando il metodo open() o openAsync(). In questo modo, vengono chiusi tutti i file associati all'oggetto FileStream, ma l'oggetto non invierà l'evento close.

Per un oggetto FileStream aperto in modo asincrono (utilizzando il metodo openAsync()), anche se chiamate l'evento close() per l'oggetto FileStream e vengono cancellate tutte le proprietà e le variabili che fanno riferimento all'oggetto, l'oggetto FileStream non viene sottoposto a garbage collection fintanto che vi sono operazioni in attesa e gestori di eventi registrati per il loro completamento. In particolare, un oggetto FileStream senza alcun riferimento continua a persistere fintanto che sono possibili le seguenti operazioni:

• per operazioni di lettura file, la fine del file non è stata raggiunta (e l'evento complete non è stato inviato);
• sono ancora disponibili dati in uscita da scrivere ed eventi relativi a dati in uscita (quali l'evento outputProgress o l'evento ioError) presentano listener di eventi registrati.

Elementi API correlati

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

Apre l'oggetto FileStream in modo sincrono, puntando al file specificato dal parametro file.

Se l'oggetto FileStream è già aperto, la chiamata di questo metodo chiude il file prima dell'apertura e nessun altro evento (incluso close) viene inviato per il file precedentemente aperto.

In sistemi che supportano il blocco dei file, un file aperto in modalità "write" o "update" (FileMode.WRITE o FileMode.UPDATE) non è leggibile fino a quando non viene chiuso.

Una volta completate tutte le operazioni sul file, chiamate il metodo close() dell'oggetto FileStream. Alcuni sistemi operativi limitano il numero di file aperti contemporaneamente.

Parametri

Altri esempi

Elementi API correlati

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

Apre l'oggetto FileStream in modo asincrono, puntando al file specificato dal parametro file.

Se l'oggetto FileStream è già aperto, la chiamata di questo metodo chiude il file prima dell'apertura e nessun altro evento (incluso close) viene inviato per il file precedentemente aperto.

Se il parametro fileMode è impostato su FileMode.READ o FileMode.UPDATE, AIR legge i dati nel buffer di ingresso non appena il file viene aperto e gli eventi progress e open vengono inviati man mano che i dati vengono letti nel buffer di ingresso.

In sistemi che supportano il blocco dei file, un file aperto in modalità "write" o "update" (FileMode.WRITE o FileMode.UPDATE) non è leggibile fino a quando non viene chiuso.

Una volta completate tutte le operazioni sul file, chiamate il metodo close() dell'oggetto FileStream. Alcuni sistemi operativi limitano il numero di file aperti contemporaneamente.

Parametri

Altri esempi

Elementi API correlati

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();
}

Legge un valore booleano dal flusso di file oppure dal flusso o array di byte. Viene letto un byte singolo e, se è diverso da zero, viene restituito true (false, in caso contrario).

Legge un byte con segno dal flusso di file oppure dal flusso o array di byte.

Legge il numero di byte di dati, specificato dal parametro length, dal flusso di file oppure dal flusso o array di byte. I byte vengono letti nell'oggetto ByteArray specificato dal parametro bytes, a partire dalla posizione specificata da offset.

Parametri

Altri esempi

Legge un numero a virgola mobile IEEE 754 a precisione doppia dal flusso di file oppure dal flusso o array di byte.

Legge un numero a virgola mobile IEEE 754 a precisione singola dal flusso di file oppure dal flusso o array di byte.

Legge un numero intero a 32 bit con segno dal flusso di file oppure dal flusso o array di byte.

Legge una stringa multibyte di lunghezza specificata dal flusso di file oppure dal flusso o array di byte mediante il set di caratteri specificato.

Parametri

Elementi API correlati

Legge un oggetto dal flusso di file oppure dal flusso o array di byte, codificato nel formato serializzato AMF.

Elementi API correlati

Legge un numero intero a 16 bit con segno dal flusso di file oppure dal flusso o array di byte.

Legge un byte senza segno dal flusso di file oppure dal flusso o array di byte.

Legge un numero intero a 32 bit senza segno dal flusso di file oppure dal flusso o array di byte.

Legge un numero intero a 16 bit senza segno dal flusso di file oppure dal flusso o array di byte.

Legge una stringa UTF-8 dal flusso di file oppure dal flusso o array di byte. Si presume che la stringa abbia come prefisso una dichiarazione unsigned short, che indica la lunghezza in byte.

Questo metodo è simile al metodo readUTF() dell'interfaccia Java^® IDataInput.

Legge una sequenza di byte UTF-8 dal flusso o dall'array di byte e restituisce una stringa.

Parametri

Tronca il file nella posizione specificata dalla proprietà position dell'oggetto FileStream.

I byte dalla posizione specificata dalla proprietà position fino alla fine del file vengono eliminati. Il file deve essere aperto per la scrittura.

Elementi API correlati

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); 
}

Scrive un valore booleano. Viene scritto un singolo byte a seconda del parametro value: 1 se true oppure 0 se false.

Parametri

Scrive un byte. Vengono utilizzati i 8 bit inferiori del parametro; i 24 bit superiori vengono ignorati.

Parametri

Scrive una sequenza di byte dall'array di byte specificato, bytes, iniziando dal byte specificato da offset (utilizzando un indice a base zero) con la lunghezza specificata da length, nel flusso di file oppure nel flusso o array di byte.

Se il parametro length viene omesso, viene utilizzata la lunghezza predefinita 0 e viene scritto l'intero buffer partendo da offset. Se viene omesso anche il parametro offset, viene scritto l'intero buffer.

Se il parametro offset o length è fuori intervallo, viene fissato all'inizio e alla fine dell'array bytes.

Parametri

Scrive un numero a virgola mobile IEEE 754 a precisione doppia (64 bit).

Parametri

Scrive un numero a virgola mobile IEEE 754 a precisione singola (32 bit).

Parametri

Scrive un numero intero con segno a 32 bit.

Parametri

Scrive una stringa multibyte nel flusso di file oppure nel flusso o array di byte mediante il set di caratteri specificato.

Parametri

Elementi API correlati

Scrive un oggetto nel flusso di file oppure nel flusso o array di byte nel formato serializzato AMF.

Parametri

Elementi API correlati

Scrive un numero intero a 16 bit. Vengono utilizzati i 16 bit inferiori del parametro; i 16 bit superiori vengono ignorati.

Parametri

Scrive un numero intero senza segno a 32 bit.

Parametri

Legge una stringa UTF-8 dal flusso di file oppure dal flusso o array di byte. La lunghezza della stringa UTF-8 in byte viene scritta per prima, come numero intero a 16 bit, seguita dai byte che rappresentano i caratteri della stringa.

Parametri

Scrive una stringa UTF-8. È simile a writeUTF(), ma non inserisce come prefisso della stringa una parola di 16 bit.

Parametri

Indica che il flusso è stato chiuso da una chiamata esplicita al metodo close().

Questo evento ha le seguenti proprietà:

Elementi API correlati

Segnala che è stata raggiunta la fine del flusso.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Indica che si è verificato un errore durante un'operazione I/O file asincrona.

Questo evento ha le seguenti proprietà:

Segnala che i dati del buffer sono stati scritti nel file.

Questo evento ha le seguenti proprietà:

Segnala la disponibilità di nuovi dati nel flusso.

Questo evento ha le seguenti proprietà: