| Paquete | flash.filesystem |
| Clase | public class FileStream |
| Herencia | FileStream  EventDispatcher Object |
| Implementa | IDataInput, IDataOutput |
| Versiones de motor de ejecución: | AIR 1.0 |
open() o de forma asíncrona llamando al método openAsync().
La ventaja de abrir archivos de forma asíncrona reside en que otro código puede ejecutarse mientras Adobe AIR lee y escribe los procesos en segundo plano. Cuando se abre de forma asíncrona, los eventos progress se distribuyen como procedimiento de las operaciones.
Un objeto File abierto de forma sincrónica se comporta casi como un objeto ByteArray; un archivo que se abre de forma asíncrona se comporta casi como un objeto Socket o URLStream. Cuando se abre un objeto File de forma sincrónica, la llamada se detiene mientras se leen o escriben los datos solicitados en el archivo subyacente. Cuando se abre de forma asíncrona, todos los datos escritos en el flujo se guardan en el búfer inmediatamente para escribirse después en el archivo.
Sea cual sea el método de lectura, asíncrono o sincrónico, los métodos reales son sincrónicos. En ambos casos, leen desde los datos actualmente disponibles. La diferencia es que al leer de forma sincrónica todos los datos están disponibles en todo momento y al leer de forma asíncrona, los datos van estando disponibles a medida que el flujo avanza en el búfer de lectura. En cualquier caso, los datos que se pueden leer de forma sincrónica en el momento actual se representan mediante la propiedad bytesAvailable.
Una aplicación que procesa entradas asíncronas suele registrar eventos progress y consumir los datos a medida que están disponibles mediante llamadas a métodos de lectura. Una aplicación también puede simplemente esperar a que todos los datos estén disponibles registrando el evento complete y procesando todos los datos cuando se distribuya el evento complete.
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
| bytesAvailable : uint [solo lectura]
Devuelve el número de bytes de datos disponibles para su lectura en el búfer de entrada. | FileStream | ||
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| endian : String
El orden de bytes de los datos; la constante BIG_ENDIAN o LITTLE_ENDIAN de la clase Endian. | FileStream | ||
| objectEncoding : uint
Especifica si al escribir o leer datos binarios con el método readObject() o writeObject() se utiliza el formato AMF3 o AMF0. | FileStream | ||
| position : Number
La posición actual en el archivo. | FileStream | ||
| readAhead : Number
La mínima cantidad de datos que se leen en el disco al leer archivos de forma asíncrona. | FileStream | ||
| Método | Definido por | ||
|---|---|---|---|
Crea un objeto FileStream. | FileStream | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | |
Cierra el objeto FileStream. | FileStream | ||
|
Distribuye un evento en el flujo del evento. | EventDispatcher | |
|
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
Abre el objeto FileStream de forma sincrónica y señala al archivo especificado por el parámetro file. | FileStream | ||
Abre el objeto FileStream de forma asíncrona y señala al archivo especificado por el parámetro file. | FileStream | ||
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
Lee un valor booleano desde el flujo del archivo, de bytes o desde el conjunto de bytes. | FileStream | ||
Lee un byte con signo desde el flujo del archivo, de bytes o desde el conjunto de bytes. | FileStream | ||
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. | FileStream | ||
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. | FileStream | ||
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. | FileStream | ||
Lee un entero de 32 bits con signo desde el flujo del archivo, de bytes o desde el conjunto de bytes. | FileStream | ||
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. | FileStream | ||
Lee un objeto desde el flujo del archivo, de bytes o desde el conjunto de bytes, codificado en formato serializado AMF. | FileStream | ||
Lee un entero de 16 bits con signo desde el flujo del archivo, de bytes o desde el conjunto de bytes. | FileStream | ||
Lee un byte sin signo desde el flujo del archivo, de bytes o desde el conjunto de bytes. | FileStream | ||
Lee un entero de 32 bits sin signo desde el flujo del archivo, de bytes o desde el conjunto de bytes. | FileStream | ||
Lee un entero de 16 bits sin signo desde el flujo del archivo, de bytes o desde el conjunto de bytes. | FileStream | ||
Lee una cadena UTF-8 desde el flujo del archivo, de bytes o desde el conjunto de bytes. | FileStream | ||
Lee una secuencia de bytes UTF-8 desde el flujo de bytes o el conjunto de bytes y devuelve una cadena. | FileStream | ||
|
Elimina un detector del objeto EventDispatcher. | EventDispatcher | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
Trunca el archivo en la posición especificada por la propiedad position del objeto FileStream. | FileStream | ||
|
Devuelve el valor simple del objeto especificado. | Object | |
|
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher | |
Escribe un valor booleano. | FileStream | ||
Escribe un byte. | FileStream | ||
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. | FileStream | ||
Escribe un número de coma flotante (64 bits) con precisión doble IEEE 754. | FileStream | ||
Escribe un número de coma flotante (32 bits) con precisión simple IEEE 754. | FileStream | ||
Escribe un entero de 32 bits con signo. | FileStream | ||
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. | FileStream | ||
Escribe un objeto en el flujo del archivo, de bytes o en el conjunto de bytes, en formato serializado AMF. | FileStream | ||
Escribe un entero de 16 bits. | FileStream | ||
Escribe un entero de 32 bits sin signo. | FileStream | ||
Escribe una cadena UTF-8 en el flujo del archivo, de bytes o en el conjunto de bytes. | FileStream | ||
Escribe una cadena UTF-8. | FileStream | ||
| Evento | Resumen | Definido por | ||
|---|---|---|---|---|
| [evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | ||
| Indica que el flujo se ha cerrado mediante una llamada explícita al método close(). | FileStream | |||
| Indica que se ha alcanzado el final del flujo. | FileStream | |||
| [evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | ||
| Indica que se ha producido un error durante una operación asíncrona de E/S de archivos. | FileStream | |||
| Indica que los datos almacenados en el búfer se han escrito en el archivo. | FileStream | |||
| Indica la disponibilidad de nuevos datos en el flujo. | FileStream | |||
bytesAvailable | propiedad |
bytesAvailable:uint [solo lectura] | Versiones de motor de ejecución: | AIR 1.0 |
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.
Implementación
public function get bytesAvailable():uint endian | propiedad |
objectEncoding | propiedad |
objectEncoding:uint| Versiones de motor de ejecución: | AIR 1.0 |
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.
Implementación
public function get objectEncoding():uint public function set objectEncoding(value:uint):voidElementos de API relacionados
position | propiedad |
position:Number| Versiones de motor de ejecución: | AIR 1.0 |
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 232 bytes de longitud. El valor de esta propiedad siempre es un número entero menor que 253. 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.
Implementación
public function get position():Number public function set position(value:Number):voidEjemplo ( Cómo utilizar este ejemplo )
position del objeto FileStream se actualiza a medida que la aplicación lee datos de un archivo.
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();
}
readAhead | propiedad |
readAhead:Number| Versiones de motor de ejecución: | AIR 1.0 |
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.
Implementación
public function get readAhead():Number public function set readAhead(value:Number):voidEjemplo ( Cómo utilizar este ejemplo )
readAhead para limitar a 100 bytes la cantidad de datos que se lee en un archivo:
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);
}
}
FileStream | () | Información sobre |
public function FileStream()| Versiones de motor de ejecución: | AIR 1.0 |
Crea un objeto FileStream. Utilice el método open() u openAsync() para abrir un archivo.
Elementos de API relacionados
close | () | método |
public function close():void| Versiones de motor de ejecución: | AIR 1.0 |
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
completeno se ha distribuido). - Los datos de salida siguen disponibles para su escritura, y los eventos relacionados con la salida (como el evento
outputProgressoioError) tienen registrados detectores de eventos.
Eventos
close: — El archivo (abierto de forma asíncrona) se cierra.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
close() del objeto FileStream cierra el archivo cuando se escriben los datos.
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");
}
close() del objeto FileStream cierra el archivo cuando se escriben los datos.
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();
open | () | método |
public function open(file:File, fileMode:String):void| Versiones de motor de ejecución: | AIR 1.0 |
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
file:File — El objeto File que especifica el archivo que se va a abrir.
| |
fileMode:String — Una cadena de la clase FileMode que define las funciones del objeto FileStream (por ejemplo, la capacidad de leer o escribir en el archivo).
|
Emite
IOError — El archivo no existe; no dispone de los permisos adecuados para abrirlo; está abriendo un archivo para leerlo y no dispone de permisos de lectura, o bien está abriendo un archivo para escribir en él y no dispone de permisos de escritura.
| |
SecurityError — La ubicación del archivo está en el directorio de la aplicación y el parámetro fileMode se establece en modo "append", "update" o "write".
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
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();
openAsync | () | método |
public function openAsync(file:File, fileMode:String):void| Versiones de motor de ejecución: | AIR 1.0 |
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
file:File — El objeto File que especifica el archivo que se va a abrir.
| |
fileMode:String — Una cadena de la clase FileMode que define las funciones del objeto FileStream (por ejemplo, la capacidad de leer o escribir en el archivo).
|
Eventos
ioError: — El archivo no existe; no dispone de los permisos adecuados para abrirlo; está abriendo un archivo para leerlo y no dispone de permisos de lectura, o bien está abriendo un archivo para escribir en él y no dispone de permisos de escritura.
| |
progress: — Se distribuye a medida que se leen datos en el búfer de entrada. (El archivo debe abrirse con el parámetro fileMode establecido en FileMode.READ o FileMode.UPDATE.)
| |
complete: — Los datos del archivo que se han leído en el búfer de entrada. (El archivo debe abrirse con el parámetro fileMode establecido en FileMode.READ o FileMode.UPDATE.)
|
Emite
SecurityError — La ubicación del archivo está en el directorio de la aplicación y el parámetro fileMode se establece en modo "append", "update" o "write".
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
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();
}
readBoolean | () | método |
public function readBoolean():Boolean| Versiones de motor de ejecución: | AIR 1.0 |
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.
Boolean — Un valor booleano, true si el byte es distinto de cero; en caso contrario, false.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
readByte | () | método |
public function readByte():int| Versiones de motor de ejecución: | AIR 1.0 |
Lee un byte con signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.
Valor devueltoint — El valor devuelto se encuentra entre -128 y 127.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
readBytes | () | método |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| Versiones de motor de ejecución: | AIR 1.0 |
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
bytes:ByteArray — Objeto ByteArray en el que se leerán los datos.
| |
offset:uint (default = 0)bytes en el que debe comenzar la lectura de datos.
| |
length:uint (default = 0) |
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
readDouble | () | método |
public function readDouble():Number| Versiones de motor de ejecución: | AIR 1.0 |
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.
Valor devueltoNumber — Un número de coma flotante con precisión doble IEEE 754.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
readFloat | () | método |
public function readFloat():Number| Versiones de motor de ejecución: | AIR 1.0 |
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.
Valor devueltoNumber — Un número de coma flotante con precisión simple IEEE 754.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
readInt | () | método |
public function readInt():int| Versiones de motor de ejecución: | AIR 1.0 |
Lee un entero de 32 bits con signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.
Valor devueltoint — El valor devuelto se encuentra entre -2147483648 y 2147483647.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
readMultiByte | () | método |
public function readMultiByte(length:uint, charSet:String):String| Versiones de motor de ejecución: | AIR 1.0 |
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
length:uint — El número de bytes del flujo de bytes que se va a leer.
| |
charSet:String — La cadena que denota el juego de caracteres que se utilizará para interpretar los bytes. Las posibles cadenas del conjunto de caracteres puden ser "shift-jis", "cn-gb", "iso-8859-1" y otras. Para obtener una lista completa, consulte los juegos de caracteres admitidos.
Nota: si el sistema actual no reconoce el valor del parámetro |
String — Cadena con codificación UTF-8.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
Elementos de API relacionados
readObject | () | método |
public function readObject():*| Versiones de motor de ejecución: | AIR 1.0 |
Lee un objeto desde el flujo del archivo, de bytes o desde el conjunto de bytes, codificado en formato serializado AMF.
Valor devuelto* — El objeto deserializado.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
Elementos de API relacionados
readShort | () | método |
public function readShort():int| Versiones de motor de ejecución: | AIR 1.0 |
Lee un entero de 16 bits con signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.
Valor devueltoint — El valor devuelto se encuentra entre -32768 y 32767.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
readUnsignedByte | () | método |
public function readUnsignedByte():uint| Versiones de motor de ejecución: | AIR 1.0 |
Lee un byte sin signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.
Valor devueltouint — El valor devuelto se encuentra entre 0 y 255.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
readUnsignedInt | () | método |
public function readUnsignedInt():uint| Versiones de motor de ejecución: | AIR 1.0 |
Lee un entero de 32 bits sin signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.
Valor devueltouint — El valor devuelto se encuentra entre 0 y 4294967295.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
readUnsignedShort | () | método |
public function readUnsignedShort():uint| Versiones de motor de ejecución: | AIR 1.0 |
Lee un entero de 16 bits sin signo desde el flujo del archivo, de bytes o desde el conjunto de bytes.
Valor devueltouint — El valor devuelto se encuentra entre 0 y 65535.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
readUTF | () | método |
public function readUTF():String| Versiones de motor de ejecución: | AIR 1.0 |
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®.
String — Cadena UTF-8 generada por la representación de caracteres en bytes.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
readUTFBytes | () | método |
public function readUTFBytes(length:uint):String| Versiones de motor de ejecución: | AIR 1.0 |
Lee una secuencia de bytes UTF-8 desde el flujo de bytes o el conjunto de bytes y devuelve una cadena.
Parámetros
length:uint — El número de bytes que se van a leer.
|
String — Cadena UTF-8 generada por la representación de caracteres en bytes con la longitud especificada.
|
Eventos
ioError: — El archivo no se puede leer o no está abierto. Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de lectura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
| |
EOFError — La posición especificada para los datos de lectura supera el número de bytes disponibles (especificado por la propiedad bytesAvailable).
|
truncate | () | método |
public function truncate():void| Versiones de motor de ejecución: | AIR 1.0 |
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.
Emite
IllegalOperationError — El archivo no está abierto para su escritura.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
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);
}
writeBoolean | () | método |
public function writeBoolean(value:Boolean):void| Versiones de motor de ejecución: | AIR 1.0 |
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
value:Boolean — Valor booleano que determina el byte que se escribe. Si el parámetro es true, se escribe 1; si es false, se escribe 0.
|
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
writeByte | () | método |
public function writeByte(value:int):void| Versiones de motor de ejecución: | AIR 1.0 |
Escribe un byte. Se utilizan los 8 bits más bajos del parámetro; los 24 bits altos se omiten.
Parámetros
value:int — Un valor de byte como un entero.
|
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
writeBytes | () | método |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| Versiones de motor de ejecución: | AIR 1.0 |
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
bytes:ByteArray — Conjunto de bytes que se va a escribir.
| |
offset:uint (default = 0) | |
length:uint (default = 0) |
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
writeDouble | () | método |
public function writeDouble(value:Number):void| Versiones de motor de ejecución: | AIR 1.0 |
Escribe un número de coma flotante (64 bits) con precisión doble IEEE 754.
Parámetros
value:Number — Número de coma flotante (64 bits) con precisión doble.
|
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
writeFloat | () | método |
public function writeFloat(value:Number):void| Versiones de motor de ejecución: | AIR 1.0 |
Escribe un número de coma flotante (32 bits) con precisión simple IEEE 754.
Parámetros
value:Number — Número de coma flotante (32 bits) con precisión simple.
|
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
writeInt | () | método |
public function writeInt(value:int):void| Versiones de motor de ejecución: | AIR 1.0 |
Escribe un entero de 32 bits con signo.
Parámetros
value:int — Valor de byte como un entero con signo.
|
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
writeMultiByte | () | método |
public function writeMultiByte(value:String, charSet:String):void| Versiones de motor de ejecución: | AIR 1.0 |
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
value:String — El valor de la cadena que se va a escribir.
| |
charSet:String — Cadena que denota el conjunto de caracteres que se va a utilizar. Las posibles cadenas del conjunto de caracteres puden ser "shift-jis", "cn-gb", "iso-8859-1" y otras. Para obtener una lista completa, consulte los juegos de caracteres admitidos.
|
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
Elementos de API relacionados
writeObject | () | método |
public function writeObject(object:*):void| Versiones de motor de ejecución: | AIR 1.0 |
Escribe un objeto en el flujo del archivo, de bytes o en el conjunto de bytes, en formato serializado AMF.
Parámetros
object:* — El objeto que se va a serializar.
|
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
Elementos de API relacionados
writeShort | () | método |
public function writeShort(value:int):void| Versiones de motor de ejecución: | AIR 1.0 |
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
value:int — Un valor de byte como un entero.
|
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
writeUnsignedInt | () | método |
public function writeUnsignedInt(value:uint):void| Versiones de motor de ejecución: | AIR 1.0 |
Escribe un entero de 32 bits sin signo.
Parámetros
value:uint — Valor de byte como un entero sin signo.
|
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
writeUTF | () | método |
public function writeUTF(value:String):void| Versiones de motor de ejecución: | AIR 1.0 |
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
value:String — El valor de la cadena que se va a escribir.
|
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
RangeError — Si la longitud de la cadena es superior a 65535.
| |
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
writeUTFBytes | () | método |
public function writeUTFBytes(value:String):void| Versiones de motor de ejecución: | AIR 1.0 |
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
value:String — El valor de la cadena que se va a escribir.
|
Eventos
ioError: — No se puede escribir en el archivo (por ejemplo, porque no se encuentra). Este evento se distribuye sólo en archivos abiertos para operaciones asíncronas (con el método openAsync()).
|
Emite
IOError — Si el archivo no se ha abierto, si se ha abierto pero no con capacidad de escritura, o si se ha abierto para operaciones asíncronas (con el método open()), no se podrá leer (por ejemplo, porque el archivo falta).
|
close | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.CLOSE| Versiones de motor de ejecución: | AIR 1.0 |
Indica que el flujo se ha cerrado mediante una llamada explícita al método close().
Event.CLOSE define el valor de la propiedad type de un objeto de evento close.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto cuya conexión se ha cerrado. |
Elementos de API relacionados
complete | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.COMPLETE| Versiones de motor de ejecución: | AIR 1.0 |
Indica que se ha alcanzado el final del flujo.
La constanteEvent.COMPLETE define el valor de la propiedad type de un objeto de evento complete.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto de red que ha terminado de cargarse. |
Elementos de API relacionados
ioError | Evento |
flash.events.IOErrorEventpropiedad IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Versiones de motor de ejecución: | AIR 1.0 |
Indica que se ha producido un error durante una operación asíncrona de E/S de archivos.
Define el valor de la propiedadtype de un objeto de evento ioError.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
errorID | Un número de referencia asociado al error concreto (sólo AIR). |
target | El objeto de red en el que se produce el error de entrada/salida. |
text | Texto que se mostrará como mensaje de error. |
outputProgress | Evento |
flash.events.OutputProgressEventpropiedad OutputProgressEvent.type =
flash.events.OutputProgressEvent.OUTPUT_PROGRESS| Versiones de motor de ejecución: | AIR 1.0 |
Indica que los datos almacenados en el búfer se han escrito en el archivo.
Define el valor de la propiedadtype de un objeto de evento outputProgress.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
bytesPending | Número de bytes pendientes de escribir en el momento en el que el detector procesa el evento. |
bytesTotal | Número total de bytes que se escribirán en última instancia si el proceso de escritura se realiza correctamente. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto FileStream que informa sobre el progreso. |
progress | Evento |
flash.events.ProgressEventpropiedad ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versiones de motor de ejecución: | AIR 1.0 |
Indica la disponibilidad de nuevos datos en el flujo.
Define el valor de la propiedadtype de un objeto de evento progress.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
bytesLoaded | Número de elementos o bytes cargados en el momento en que el detector procesa el evento. |
bytesTotal | Número total de elementos o bytes que se cargarán en última instancia si el proceso de carga se realiza correctamente. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto que informa sobre el progreso. |
Tue Jun 12 2018, 02:12 PM Z