FileStream  - AS3

Devuelve el número de bytes de datos disponibles para su lectura en el búfer de entrada. El código de usuario debe llamar a bytesAvailable para garantizar que hay datos suficientes disponibles antes de intentar leerlos con uno de los métodos read.

El orden de bytes de los datos, la constante BIG_ENDIAN o LITTLE_ENDIAN de la clase Endian.

Especifica si al escribir o leer datos binarios con el método readObject() o writeObject() se utiliza el formato AMF3 o AMF0.

El valor es una constante de la clase ObjectEncoding. De forma predeterminada, se utiliza el formato AMF3.

Elementos de API relacionados

La posición actual en el archivo.

El valor se puede modificar del modo siguiente:

• Cuando se establece la propiedad explícitamente
• Cuando se lee desde el objeto FileStream (con uno de los métodos de lectura)
• Cuando se escribe en el objeto FileStream

La posición está definida como Number (no como uint) para poder admitir archivos con más de 2³² bytes de longitud. El valor de esta propiedad siempre es un número entero menor que 2⁵³. Si define este valor como un número con componente fraccionario, el valor se redondea hacia el entero inferior más cercano.

Cuando se lee un archivo de forma asíncrona, si la propiedad position está definida, la aplicación comienza a llenar el búfer de lectura con datos desde la posición especificada y la propiedad bytesAvailable se puede establecer en 0. Espere a un evento complete antes de utilizar un método read para leer los datos; o espere a un evento progress y compruebe la propiedad bytesAvailable antes de utilizar un método read.

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 mínima cantidad de datos que se leen en el disco al leer archivos de forma asíncrona.

Esta propiedad especifica los datos que intenta leer un flujo asíncrono más allá de la posición actual. Los datos se leen en bloques basados en el tamaño de página del sistema de archivos. Así, si se establece readAhead como 9.000 en un sistema informático con un tamaño de página de 8 KB (8192 bytes), el motor de ejecución lee con antelación 2 bloques o 16.384 bytes a la vez. El valor predeterminado de esta propiedad es infinito: de forma predeterminada, un archivo abierto para leer de forma asíncrona lee hasta el final del archivo.

Leer datos desde el búfer de lectura no cambia el valor de la propiedad readAhead. Cuando se leen datos desde el búfer, se leen los datos nuevos para rellenar el búfer de lectura.

La propiedad readAhead no tiene ningún efecto en archivos abiertos de forma sincrónica.

A medida que se leen datos asíncronamente, el objeto FileStream distribuye eventos progress. En el método del controlador de eventos del evento progress, compruebe que el número de bytes disponibles (verifique la propiedad bytesAvailable) y, a continuación, lea los datos del búfer de lectura con un método read.

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 objeto FileStream. Utilice el método open() u openAsync() para abrir un archivo.

Elementos de API relacionados

Cierra el objeto FileStream.

No es posible escribir ni leer más datos una vez llamado el método close(). Si el archivo se ha abierto de forma asíncrona (el objeto FileStream utilizado en el método openAsync() para abrir el archivo), al llamar al método close() el objeto distribuye el evento close.

Al cerrar la aplicación se cierran automáticamente todos los archivos asociados a los objetos FileStream de la aplicación. Sin embargo, es mejor registrar un evento closed en todos los objetos abiertos de forma asíncrona con datos pendientes de escribir antes de cerrar la aplicación (para garantizar que se escriben los datos).

Puede reutilizar el objeto FileStream llamando al método open() o al método openAsync(). Esto cierra cualquier archivo asociado al objeto FileStream, pero el objeto no distribuye el evento close.

Para un objeto FileStream abierto de forma asíncrona (con el método openAsync()), incluso si se llama al evento close() para un objeto FileStream y se eliminan las propiedades y las variables que hacen referencia al objeto, no se elimina los datos innecesarios de FileStream mientras existan operaciones pendientes y haya registrados controladores de eventos para su realización. En concreto, un objeto FileStream al que de otro modo no se haría referencia, se conserva siempre y cuando se dé alguna de estas circunstancias:

• En operaciones de lectura de archivos, no se ha alcanzado el final del archivo (y el evento complete no se ha distribuido).
• Los datos de salida siguen disponibles para su escritura, y los eventos relacionados con la salida (como el evento outputProgress o ioError) tienen registrados detectores de eventos.

Elementos de API relacionados

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

Abre el objeto FileStream de forma síncrona y señala al archivo especificado por el parámetro file.

Si el objeto FileStream ya está abierto, al llamar al método se cierra el archivo antes de abrirlo y no se entregan más eventos (incluidos los close) para el archivo abierto previamente.

En sistemas que admitan el bloqueo de archivos, un archivo abierto en modo de "escritura" o de "actualización" (FileMode.WRITE o FileMode.UPDATE) no se puede leer hasta que se cierra.

Cuando haya acabado con las operaciones del archivo, llame al método close() del objeto FileStream. Algunos sistemas operativos limitan el número regla archivos que se pueden abrir al mismo tiempo.

Parámetros

Elementos de API relacionados

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

Abre el objeto FileStream de forma asíncrona y señala al archivo especificado por el parámetro file.

Si el objeto FileStream ya está abierto, al llamar al método se cierra el archivo antes de abrirlo y no se entregan más eventos (incluidos los close) para el archivo abierto previamente.

Si el parámetro fileMode se establece en FileMode.READ o en FileMode.UPDATE, AIR lee los datos del búfer de entrada en cuanto se abre el archivo. Los eventos progress y open se distribuyen en el búfer de entrada.

En sistemas que admitan el bloqueo de archivos, un archivo abierto en modo de "escritura" o de "actualización" (FileMode.WRITE o FileMode.UPDATE) no se puede leer hasta que se cierra.

Cuando haya acabado con las operaciones del archivo, llame al método close() del objeto FileStream. Algunos sistemas operativos limitan el número regla archivos que se pueden abrir al mismo tiempo.

Parámetros

Elementos de API relacionados

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

Lee un valor booleano desde el flujo del archivo, de bytes o desde el conjunto de bytes. Se lee un solo byte y devuelve true si el byte es distinto de cero; en caso contrario, devuelve false.

Lee un byte con signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.

Lee el número de bytes de datos, especificado por el parámetro length, desde el flujo del archivo, de bytes o desde el conjunto de bytes. Los bytes se leen en el objeto ByteArray especificado por el parámetro bytes, comenzando desde la posición especificada por offset.

Parámetros

Lee un número de coma flotante con doble precisión IEEE 754 desde el flujo del archivo, de bytes o desde el conjunto de bytes.

Lee un número de coma flotante con precisión simple IEEE 754 desde el flujo del archivo, de bytes o desde el conjunto de bytes.

Lee un entero de 32 bits con signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.

Lee una cadena multi-byte de la longitud especificada en el flujo del archivo, de bytes o en el conjunto de bytes, utilizando el conjunto de caracteres especificado.

Parámetros

Elementos de API relacionados

Lee un objeto desde el flujo del archivo, de bytes o desde el conjunto de bytes, codificado en formato serializado AMF.

Elementos de API relacionados

Lee un entero de 16 bits con signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.

Lee un byte sin signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.

Lee un entero de 32 bits sin signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.

Lee un entero de 16 bits sin signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.

Lee una cadena UTF-8 desde el flujo del archivo, de bytes o desde el conjunto de bytes. Se da por hecho que la cadena tiene un prefijo de declaración unsigned short que indica la longitud en bytes.

Este método es similar al método readUTF() de la interfaz IDataInput de Java^®.

Lee una secuencia de bytes UTF-8 desde el flujo de bytes o el conjunto de bytes y devuelve una cadena.

Parámetros

Trunca el archivo en la posición especificada por la propiedad position del objeto FileStream.

Se eliminan los bytes desde la posición especificada por la propiedad position al final del archivo. El archivo debe estar abierto para su escritura.

Elementos de API relacionados

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

Escribe un valor booleano. Se escribe un solo byte según el parámetro value, 1 si es true o 0 si es false.

Parámetros

Escribe un byte. Se utilizan los 8 bits más bajos del parámetro; los 24 bits altos se omiten.

Parámetros

Escribe una secuencia de bytes desde el conjunto de bytes especificado (bytes). Comienza desde el byte especificado por offset (con un índice basado en cero) con una longitud especificada por length, en el flujo de archivos, el flujo de bytes o el conjunto de bytes.

Si se omite el parámetro length, se utiliza un valor predeterminado de length 0 y se escribe todo el búfer comenzando desde offset. Si también se omite el parámetro offset, se escribirá en todo el búfer.

Si el parámetro offset o length está fuera de rango, se ajustarán al principio y al final del conjunto bytes.

Parámetros

Escribe un número de coma flotante (64 bits) con precisión doble IEEE 754.

Parámetros

Escribe un número de coma flotante (32 bits) con precisión simple IEEE 754.

Parámetros

Escribe un entero de 32 bits con signo.

Parámetros

Se escribe una cadena multi-byte en el flujo del archivo, de bytes o en el conjunto de bytes, utilizando el conjunto de caracteres especificado.

Parámetros

Elementos de API relacionados

Escribe un objeto en el flujo del archivo, de bytes o en el conjunto de bytes, en formato serializado AMF.

Parámetros

Elementos de API relacionados

Escribe un entero de 16 bits. Se utilizan los 16 bits más bajos del parámetro; los 16 bits altos se omiten.

Parámetros

Escribe un entero de 32 bits sin signo.

Parámetros

Escribe una cadena UTF-8 en el flujo del archivo, de bytes o en el conjunto de bytes. La longitud de la cadena UTF-8 (expresada en bytes) se escribe primero, como un entero de 16 bits, seguida de los bytes que representan los caracteres de la cadena.

Parámetros

Escribe una cadena UTF-8. Similar a writeUTF(), pero no añade un prefijo a la cadena con una palabra de 16 bits de longitud.

Parámetros

Indica que el flujo se ha cerrado mediante una llamada explícita al método close().

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Indica que se ha alcanzado el final del flujo.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Indica que se ha producido un error durante una operación asíncrona de E/S de archivos.

Este evento tiene las propiedades siguientes:

Indica que los datos almacenados en el búfer se han escrito en el archivo.

Este evento tiene las propiedades siguientes:

Indica la disponibilidad de nuevos datos en el flujo.

Este evento tiene las propiedades siguientes: