FileStream  - AS3

Retorna o número de bytes de dados disponíveis para leitura no buffer de entrada. O código do usuário precisa chamar a bytesAvailable para garantir que há dados suficientes, antes de tentar a leitura com um dos métodos.

A ordem de bytes para os dados, seja a constante BIG_ENDIAN ou LITTLE_ENDIAN da classe Endian.

Especifica se o formato AMF3 ou o AMF0 é usado ao gravar ou ler dados binários usando o método readObject() ou writeObject().

O valor é uma constante da classe ObjectEncoding. Por padrão, o formato AMF3 é usado.

Elementos da API relacionados

A posição atual no arquivo.

Este valor é modificado de qualquer uma das seguintes maneiras:

• Quando você define a propriedade de forma explícita
• Ao ler do objeto FileStream (com um dos métodos de leitura)
• Ao gravar no objeto FileStream

A posição é definida como um Number (em vez de uint) para dar suporte a arquivos maiores do que 2³² bytes de extensão. O valor dessa propriedade é sempre um número inteiro menor do que 2⁵³. Se você definir esse valor como um número com um componente fracionário, o valor será arredondado para baixo, para o inteiro mais próximo.

Ao ler um arquivo de forma assíncrona, se você definir a propriedade position, o aplicativo começará a preencher o buffer de leitura com a data iniciando na posição especificada e a propriedade bytesAvailable poderá ser definida como 0. Aguarde um evento complete antes de usar um método de leitura para ler dados, ou aguarde um evento progress e verifique a propriedade bytesAvailable antes de usar um método de leitura.

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

A quantidade mínima de dados a serem lidos do disco ao ler arquivos assincronamente.

Esta propriedade especifica quantos dados um fluxo assíncrono tenta ler além da posição atual. Os dados são lidos em blocos, com base no tamanho de página do sistema de arquivos. Assim se você definir readAhead como 9.000 em um sistema de computador com tamanho de página de 8 KB (8192 bytes), o tempo de execução adianta a leitura de 2 blocos, ou 16384 bytes de uma vez. O valor padrão desta propriedade é infinito: por padrão, um arquivo aberto para leitura assincronamente lê até o fim do arquivo.

Ler dados do buffer de leitura não altera o valor da propriedade readAhead. Quando você lê dados do buffer de leitura, novos dados são lidos para preencher novamente o buffer de leitura.

A propriedade readAhead não tem nenhum efeito sobre um arquivo aberto de forma síncrona.

Conforme os dados são lidos de forma assíncrona, o objeto FileStream despacha eventos.progress. No método de manipulador de eventos do evento progress, verifique se o número necessário de bytes está disponível (marcando a propriedade bytesAvailable) e, em seguida, leia os dados do buffer de leitura usando um método de leitura.

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

Cria um objeto FileStream. Use o método open() ou openAsync() para abrir um arquivo.

Elementos da API relacionados

Fecha o objeto FileStream.

Não é possível ler nem gravar nenhum dado depois de chamar o método close(). Se o arquivo tiver sido aberto assincronamente (o objeto FileStream usou o método openAsync() para abri-lo), chamar o método close() faz com que o objeto despache o evento close.

Fechar o aplicativo automaticamente fecha todos os arquivos associados a objetos FileStream no aplicativo. No entanto, é melhor se registrar para um evento closed em todos os objetos FileStream abertos de forma assíncrona que tenham dados pendentes a gravar, antes de fechar o aplicativo (para garantir que os dados sejam gravados).

Você pode reutilizar o objeto FileStream chamando o método open() ou o openAsync(). Isso fecha todo arquivo associado ao objeto FileStream, mas o objeto não despacha o evento close.

Para um objeto FileStream aberto assincronamente (usando o método openAsync()), mesmo que você chame o evento close() para um objeto FileStream e exclua propriedades e variáveis que façam referência ao objeto, o objeto FileStream não será coletado como lixo se houver operações pendentes e manipuladores de eventos registrados para sua conclusão. Especificamente, um objeto FileStream de outro modo não referenciado persistirá desde que um dos seguintes ainda seja possível:

• Para operações de leitura de arquivos, o fim do arquivo não foi alcançado (e o evento complete não foi despachado).
• Ainda há dados de saída disponíveis para gravação, e eventos relacionados à saída (como o evento outputProgress ou o evento ioError) têm ouvintes de eventos registrados.

Elementos da 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 o objeto FileStream de forma síncrona, apontando para o arquivo especificado pelo parâmetro file.

Se o objeto FileStream já estiver aberto, a ação de chamar o método fechará o arquivo antes de abri-lo e nenhum evento adicional (incluindo close) será entregue para arquivo aberto anteriormente.

Em sistemas que oferecem suporte a bloqueio de arquivos, um arquivo aberto no modo "gravar" ou "atualizar" (FileMode.WRITE ou FileMode.UPDATE) só ficará legível depois de fechado.

Uma vez que você estiver executando operações no arquivo, chame o métodoperto() do objeto FileStream. Alguns sistemas operacionais limitam o número de arquivos concorrentemente abertos.

Parâmetros

Elementos da 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 o objeto FileStream de forma assíncrona, apontando para o arquivo especificado pelo parâmetro file.

Se o objeto FileStream já estiver aberto, a ação de chamar o método fechará o arquivo antes de abri-lo e nenhum evento adicional (incluindo close) será entregue para arquivo aberto anteriormente.

Se o parâmetro fileMode estiver definido como FileMode.READ ou FileMode.UPDATE, o AIR lerá os dados no buffer de entrada tão logo o arquivo seja aberto, e eventos progress e open serão despachados à medida que os dados forem lidos no buffer de entrada.

Em sistemas que oferecem suporte a bloqueio de arquivos, um arquivo aberto no modo "gravar" ou "atualizar" (FileMode.WRITE ou FileMode.UPDATE) só ficará legível depois de fechado.

Uma vez que você estiver executando operações no arquivo, chame o métodoperto() do objeto FileStream. Alguns sistemas operacionais limitam o número de arquivos concorrentemente abertos.

Parâmetros

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

Lê um valor booliano do fluxo de arquivo, fluxo de bytes ou da matriz de bytes. O único byte é lido e é retornado true se o byte for diferente de zero, false em caso contrário.

Lê um byte com sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.

Lê o número de bytes de dados especificados pelo parâmetro de lenght do fluxo de arquivos, fluxo de bytes ou da matriz de bytes. Os bytes são lidos no objeto ByteArray, especificado pelo parâmetro bytes, com o início na posição especificada pelo deslocamento.

Parâmetros

Lê um número de ponto flutuante de precisão dupla IEEE 754 do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.

Lê um número de ponto flutuante de precisão única IEEE 754 do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.

Lê um inteiro de 32 bits assinado do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.

Lê uma string multibyte do comprimento especificado para o fluxo de arquivo, fluxo de byte ou matriz de byte, usando o conjunto de caracteres especificado.

Parâmetros

Elementos da API relacionados

Escreve um objeto no fluxo de arquivo, fluxo de bytes ou matriz de bytes codificado no formato serializado AMF.

Elementos da API relacionados

Lê um inteiro de 16 bits com sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.

Lê um byte sem sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.

Lê um inteiro de 32 bits não assinado do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.

Lê um inteiro de 16 bits sem sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.

Leia uma string UTF-8 a partir do fluxo de arquivos, fluxo de byte ou matriz de byte. A string é assumida como prefixada com uma curta não assinada, indicativa do comprimento em bytes.

Este método é semelhante ao método readUTF() na interface Java^® IDataInput.

Lê uma string de bytes UTF-8 do fluxo de bytes ou da matriz de bytes e retorna uma string.

Parâmetros

Trunca o arquivo na posição especificada pela propriedade position do objeto FileStream.

Os bytes na posição especificada pela propriedade position no final do arquivo são excluídos. O arquivo deve estar aberto para gravação.

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

Grava um valor booliano. Um único byte é gravado de acordo com o parâmetro value, 1 se for true ou 0 se for false.

Parâmetros

Grava um byte. Os 8 bits inferiores do parâmetro são usados e os 24 bits superiores são ignorados.

Parâmetros

Grava uma sequência de bytes da matriz de bytes especificada, bytes, iniciando no byte especificado por offset (usando um índice com base zero) com length especificado por comprimento, no fluxo de arquivo, fluxo de bytes ou na matriz de bytes.

Se o parâmetro lenght for omitido, é usado o comprimento padrão de 0 e todo o buffer com início em offset é gravado. Se o parâmetro deslocamento também for omitido, é gravado todo o buffer.

Se os parâmetros offset ou length estiverem fora do limite, eles são fixados no início e no fim da matriz de bytes.

Parâmetros

Grava um número de ponto flutuante de precisão dupla (64 bits) IEEE 754.

Parâmetros

Grava um número de ponto flutuante de precisão única (32 bits) IEEE 754.

Parâmetros

Grava um inteiro assinado de 32 bits.

Parâmetros

Grava uma string multibyte para o fluxo de arquivo, fluxo de byte ou matriz de byte, usando o conjunto de caracteres especificado.

Parâmetros

Elementos da API relacionados

Grava um objeto no fluxo de arquivo, fluxo de bytes ou na matriz de bytes no formato serializado AMF.

Parâmetros

Elementos da API relacionados

Grava um inteiro de 16 bits. Os 16 bits inferiores do parâmetro são usados e os 16 bits superiores são ignorados.

Parâmetros

Grava um inteiro não assinado de 32 bits.

Parâmetros

Grava uma string UTF-8 para o fluxo de arquivos, fluxo de byte ou matriz de byte. O comprimento da string UTF-8 em bytes é gravado primeiro, como uma integral de 16 bits, seguido pelos bytes que representam os caracteres da string.

Parâmetros

Grava uma string UTF-8. Semelhante à writeUTF(), mas não coloca como prefixo da string uma palavra com o comprimento de 16 bits.

Parâmetros

Indica que o fluxo foi fechado por uma chamada explícita para o método close().

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Sinaliza que o fim do fluxo foi alcançado.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Indica que um erro ocorreu durante uma operação assíncrona de E/S de arquivo.

Esse evento tem as seguintes propriedades:

Sinaliza que os dados armazenados em buffer foram gravados no arquivo.

Esse evento tem as seguintes propriedades:

Sinaliza a disponibilidade de novos dados no fluxo.

Esse evento tem as seguintes propriedades: