Pacote | flash.filesystem |
Classe | public class FileStream |
Herança | FileStream EventDispatcher Object |
Implementações | IDataInput, IDataOutput |
Versões de runtime: | AIR 1.0 |
open()
, ou de forma assíncrona, chamando o método openAsync()
.
A vantagem de abrir arquivos de forma assíncrona é que outro código pode ser executado enquanto o Adobe AIR executa processos de gravação em segundo plano. Quando abertos assincronamente, eventos, progress
são despachados conforme as operações continuam.
Um objeto File aberto de forma síncrona comporta-se de modo muito semelhante a um objeto ByteArray; um arquivo aberto de forma assíncrona comporta-se de modo muito semelhante a um objeto Socket ou URLStream. Quando o objeto File é aberto de forma síncrona, o chamador faz uma pausa enquanto os dados solicitados são lidos do arquivo subjacente ou gravados no arquivo subjacente. Quando aberto de forma assíncrona, qualquer dado gravado no fluxo é imediatamente armazenado em buffer e, posteriormente, gravado no arquivo.
Seja a leitura de um arquivo síncrona ou assíncrona, os métodos reais de leitura são síncronos. Nos dois casos, eles leem a partir de dados "disponíveis" no momento. A diferença é que, ao ler de forma síncrona, todos os dados estão disponíveis o tempo todo, ao passo que ao ler de forma assíncrona, os dados se tornam disponíveis gradualmente, conforme fluem para um buffer de leitura. De um ou outro modo, os dados que podem ser lidos de forma síncrona no momento atual são representados pela propriedade bytesAvailable
.
Um aplicativo que esteja processando uma entrada assíncrona geralmente se registra para eventos progress
e consome os dados conforme eles se tornam disponíveis, chamando métodos de leitura. Como alternativa, um aplicativo pode simplesmente aguardar até que todos os dados estejam disponíveis, registrando-se para o evento complete
e processando o conjunto de dados inteiro quando o evento complete
for despachado.
Propriedade | Definido por | ||
---|---|---|---|
bytesAvailable : uint [somente leitura]
Retorna o número de bytes de dados disponíveis para leitura no buffer de entrada. | FileStream | ||
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
endian : String
A ordem de bytes para os dados, seja a constante BIG_ENDIAN ou LITTLE_ENDIAN da classe Endian. | FileStream | ||
objectEncoding : uint
Especifica se o formato AMF3 ou o AMF0 é usado ao gravar ou ler dados binários usando o método readObject() ou writeObject(). | FileStream | ||
position : Number
A posição atual no arquivo. | FileStream | ||
readAhead : Number
A quantidade mínima de dados a serem lidos do disco ao ler arquivos assincronamente. | FileStream |
Método | Definido por | ||
---|---|---|---|
Cria um objeto FileStream. | FileStream | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | ||
Fecha o objeto FileStream. | FileStream | ||
Envia um evento para o fluxo de eventos. | EventDispatcher | ||
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
Abre o objeto FileStream de forma síncrona, apontando para arquivo especificado pelo parâmetro do arquivo. | FileStream | ||
Abre o objeto FileStream de forma assincronamente, apontando para o arquivo especificado pelo parâmetro file. | FileStream | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Lê um valor booliano do fluxo de arquivo, fluxo de bytes ou da matriz de bytes. | FileStream | ||
Lê um byte com sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes. | FileStream | ||
Lê o número de bytes de dados, especificados pelo parâmetro de comprimento, do fluxo de arquivos, do fluxo de bytes ou da matriz de bytes. | FileStream | ||
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. | FileStream | ||
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. | FileStream | ||
Lê um inteiro de 32 bits assinado do fluxo de arquivos, fluxo de bytes ou da matriz de bytes. | FileStream | ||
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. | FileStream | ||
Escreve um objeto no fluxo de arquivo, fluxo de bytes ou matriz de bytes codificado no formato serializado AMF. | FileStream | ||
Lê um inteiro de 16 bits com sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes. | FileStream | ||
Lê um byte sem sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes. | FileStream | ||
Lê um inteiro de 32 bits não assinado do fluxo de arquivos, fluxo de bytes ou da matriz de bytes. | FileStream | ||
Lê um inteiro de 16 bits sem sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes. | FileStream | ||
Leia uma string UTF-8 a partir do fluxo de arquivos, fluxo de byte ou matriz de byte. | FileStream | ||
Lê uma string de bytes UTF-8 do fluxo de bytes ou da matriz de bytes e retorna uma string. | FileStream | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
Retorna a representação de string do objeto especificado. | Object | ||
Trunca o arquivo na posição especificada pela propriedade position do objeto FileStream. | FileStream | ||
Retorna o valor primitivo do objeto especificado. | Object | ||
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher | ||
Grava um valor booliano. | FileStream | ||
Grava um byte. | FileStream | ||
Grava uma sequência de bytes da matriz de bytes especificada, bytes, iniciando no byte especificado pelo deslocamento (usando um índice com base zero) com um comprimento especificado por comprimento, no fluxo de arquivo, fluxo de bytes ou na matriz de bytes. | FileStream | ||
Grava um número de ponto flutuante de precisão dupla (64 bits) IEEE 754. | FileStream | ||
Grava um número de ponto flutuante de precisão única (32 bits) IEEE 754. | FileStream | ||
Grava um inteiro assinado de 32 bits. | FileStream | ||
Grava uma string multibyte para o fluxo de arquivo, fluxo de byte ou matriz de byte, usando o conjunto de caracteres especificado. | FileStream | ||
Grava um objeto no fluxo de arquivo, fluxo de bytes ou na matriz de bytes no formato serializado AMF. | FileStream | ||
Grava um inteiro de 16 bits. | FileStream | ||
Grava um inteiro não assinado de 32 bits. | FileStream | ||
Grava uma string UTF-8 para o fluxo de arquivos, fluxo de byte ou matriz de byte. | FileStream | ||
Grava uma string UTF-8. | FileStream |
Evento | Resumo | Definido por | ||
---|---|---|---|---|
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
Indica que o fluxo foi fechado por uma chamada explícita para o método close(). | FileStream | |||
Sinaliza que o fim do fluxo foi alcançado. | FileStream | |||
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
Indica que um erro ocorreu durante uma operação assíncrona de E/S de arquivo. | FileStream | |||
Sinaliza que os dados armazenados em buffer foram gravados no arquivo. | FileStream | |||
Sinaliza a disponibilidade de novos dados no fluxo. | FileStream |
bytesAvailable | propriedade |
bytesAvailable:uint
[somente leitura] Versões de runtime: | AIR 1.0 |
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.
Implementação
public function get bytesAvailable():uint
endian | propriedade |
objectEncoding | propriedade |
objectEncoding:uint
Versões de runtime: | AIR 1.0 |
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.
Implementação
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void
Elementos da API relacionados
position | propriedade |
position:Number
Versões de runtime: | AIR 1.0 |
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 232 bytes de extensão. O valor dessa propriedade é sempre um número inteiro menor do que 253. 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.
Implementação
public function get position():Number
public function set position(value:Number):void
Exemplo ( Como usar este exemplo )
position
do objeto FileStream é atualizada à medida que o aplicativo lê dados em um arquivo.
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 | propriedade |
readAhead:Number
Versões de runtime: | AIR 1.0 |
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.
Implementação
public function get readAhead():Number
public function set readAhead(value:Number):void
Exemplo ( Como usar este exemplo )
readAhead
para limitar em 100 bytes a quantidade de dados lidos em um arquivo:
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 | () | Construtor |
public function FileStream()
Versões de runtime: | AIR 1.0 |
Cria um objeto FileStream. Use o método open()
ou openAsync()
para abrir um arquivo.
Elementos da API relacionados
close | () | método |
public function close():void
Versões de runtime: | AIR 1.0 |
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 eventoioError
) têm ouvintes de eventos registrados.
Eventos
close: — O arquivo, aberto assincronamente, é fechado.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
close()
do objeto FileStream fecha o arquivo quando os dados são gravados.
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()
do objeto FileStream fecha o arquivo quando os dados são gravados.
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
Versões de runtime: | AIR 1.0 |
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
file:File — O objeto File que especifica o arquivo para abrir.
| |
fileMode:String — Uma string da classe FileMode que define os recursos do FileStream, como a capacidade de ler do arquivo ou gravar no arquivo.
|
Lança
IOError — O arquivo não existe; você não tem permissões adequadas para abrir o arquivo; você está abrindo um arquivo para acesso de leitura e não tem permissões de leitura; ou você está abrindo um arquivo para acesso de gravação e não tem permissões para gravação.
| |
SecurityError — O local do arquivo é o diretório do aplicativo, e o parâmetro fileMode está definido como modo "anexar", "atualizar" ou "gravar".
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
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
Versões de runtime: | AIR 1.0 |
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
file:File — O objeto File que especifica o arquivo para abrir.
| |
fileMode:String — Uma string da classe FileMode que define os recursos do FileStream, como a capacidade de ler do arquivo ou gravar no arquivo.
|
Eventos
ioError: — O arquivo não existe; você não tem permissões adequadas para abrir o arquivo; você está abrindo um arquivo para acesso de leitura e não tem permissões de leitura; ou você está abrindo um arquivo para acesso de gravação e não tem permissões para gravação.
| |
progress: — Despachado como dado, é lido no buffer de entrada. (O arquivo deve ser aberto com o parâmetro fileMode definido como FileMode.READ ou FileMode.UPDATE .)
| |
complete: — Os dados do arquivo foram lidos no buffer de entrada. (O arquivo deve ser aberto com o parâmetro fileMode definido como FileMode.READ ou FileMode.UPDATE .)
|
Lança
SecurityError — O local do arquivo é o diretório do aplicativo, e o parâmetro fileMode está definido como modo "anexar", "atualizar" ou "gravar".
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
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
Versões de runtime: | AIR 1.0 |
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.
Boolean — O valor booliano, true se o byte for diferente de zero, false em caso contrário.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
readByte | () | método |
public function readByte():int
Versões de runtime: | AIR 1.0 |
Lê um byte com sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.
Retornaint — O valor retornado está na faixa de -128 a 127.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
readBytes | () | método |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Versões de runtime: | AIR 1.0 |
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
bytes:ByteArray — O objeto ByteArray para a leitura de dados.
| |
offset:uint (default = 0 ) — O deslocamento no parâmetro de bytes em que deve começar a leitura dos dados.
| |
length:uint (default = 0 ) — O número de bytes a ser lido. O valor padrão de 0 permite a leitura de todos os dados disponíveis.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
readDouble | () | método |
public function readDouble():Number
Versões de runtime: | AIR 1.0 |
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.
RetornaNumber — Um número de ponto flutuante de precisão dupla IEEE 754.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
readFloat | () | método |
public function readFloat():Number
Versões de runtime: | AIR 1.0 |
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.
RetornaNumber — Um número de ponto flutuante de precisão única IEEE 754.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
readInt | () | método |
public function readInt():int
Versões de runtime: | AIR 1.0 |
Lê um inteiro de 32 bits assinado do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.
Retornaint — O valor retornado está na faixa de -2147483648 a 2147483647.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
readMultiByte | () | método |
public function readMultiByte(length:uint, charSet:String):String
Versões de runtime: | AIR 1.0 |
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
length:uint — O número de bytes do fluxo de bytes para leitura.
| |
charSet:String — A string que denota o conjunto de caracteres usados para interpretar os bytes. As strings possíveis de conjunto de caracteres incluem "shift-jis" , "cn-gb" , "iso-8859-1" e outras. Para obter uma lista completa, consulte
Conjuntos de caracteres suportados.
Observação: Caso o valor do parâmetro |
String — String codificada UTF-8
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
Elementos da API relacionados
readObject | () | método |
public function readObject():*
Versões de runtime: | AIR 1.0 |
Escreve um objeto no fluxo de arquivo, fluxo de bytes ou matriz de bytes codificado no formato serializado AMF.
Retorna* — O objeto desserializado
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
Elementos da API relacionados
readShort | () | método |
public function readShort():int
Versões de runtime: | AIR 1.0 |
Lê um inteiro de 16 bits com sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.
Retornaint — O valor retornado está na faixa de -32768 a 32767.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
readUnsignedByte | () | método |
public function readUnsignedByte():uint
Versões de runtime: | AIR 1.0 |
Lê um byte sem sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.
Retornauint — O valor retornado está na faixa de 0 a 255.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
readUnsignedInt | () | método |
public function readUnsignedInt():uint
Versões de runtime: | AIR 1.0 |
Lê um inteiro de 32 bits não assinado do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.
Retornauint — O valor retornado está na faixa de 0 a 4294967295.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
readUnsignedShort | () | método |
public function readUnsignedShort():uint
Versões de runtime: | AIR 1.0 |
Lê um inteiro de 16 bits sem sinal do fluxo de arquivos, fluxo de bytes ou da matriz de bytes.
Retornauint — O valor retornado está na faixa de 0 a 65535.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
readUTF | () | método |
public function readUTF():String
Versões de runtime: | AIR 1.0 |
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.
String — A string UTF-8 produzida pela representação em bytes dos caracteres.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
readUTFBytes | () | método |
public function readUTFBytes(length:uint):String
Versões de runtime: | AIR 1.0 |
Lê uma string de bytes UTF-8 do fluxo de bytes ou da matriz de bytes e retorna uma string.
Parâmetros
length:uint — O número de bytes a ser lido.
|
String — Uma string UTF-8 produzida pela representação em bytes do número de caracteres especificado.
|
Eventos
ioError: — O arquivo não pode ser lido ou não está aberto. Este evento só é despachado para arquivos abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de leitura; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser lido (por exemplo, porque o arquivo está ausente).
| |
EOFError — A posição especificada para ler dados excede o número de bytes disponível (especificado pela propriedade bytesAvailable ).
|
truncate | () | método |
public function truncate():void
Versões de runtime: | AIR 1.0 |
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.
Lança
IllegalOperationError — O arquivo não está aberto para gravação.
|
Elementos da API relacionados
Exemplo ( Como usar este exemplo )
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
Versões de runtime: | AIR 1.0 |
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
value:Boolean — O valor booliano que determina os bytes gravados. Se o parâmetro for true , 1 é escrito; se for false , 0 é escrito.
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
writeByte | () | método |
public function writeByte(value:int):void
Versões de runtime: | AIR 1.0 |
Grava um byte. Os 8 bits inferiores do parâmetro são usados e os 24 bits superiores são ignorados.
Parâmetros
value:int — Um valor de byte como uma integral.
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
writeBytes | () | método |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Versões de runtime: | AIR 1.0 |
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
bytes:ByteArray — A matriz de bytes para gravar.
| |
offset:uint (default = 0 ) — Um índice base zero especifica a posição na matriz para começar a escrita.
| |
length:uint (default = 0 ) — Um inteiro sem sinal especifica a distância no buffer a ser gravada.
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
writeDouble | () | método |
public function writeDouble(value:Number):void
Versões de runtime: | AIR 1.0 |
Grava um número de ponto flutuante de precisão dupla (64 bits) IEEE 754.
Parâmetros
value:Number — Um número de ponto flutuante de precisão dupla (64 bits).
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
writeFloat | () | método |
public function writeFloat(value:Number):void
Versões de runtime: | AIR 1.0 |
Grava um número de ponto flutuante de precisão única (32 bits) IEEE 754.
Parâmetros
value:Number — Um número de ponto flutuante de precisão única (32 bits).
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
writeInt | () | método |
public function writeInt(value:int):void
Versões de runtime: | AIR 1.0 |
Grava um inteiro assinado de 32 bits.
Parâmetros
value:int — Um valor de byte como uma integral assinada.
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
writeMultiByte | () | método |
public function writeMultiByte(value:String, charSet:String):void
Versões de runtime: | AIR 1.0 |
Grava uma string multibyte para o fluxo de arquivo, fluxo de byte ou matriz de byte, usando o conjunto de caracteres especificado.
Parâmetros
value:String — O valor da string para gravar.
| |
charSet:String — A string que denota o conjunto de caracteres para usar. As strings possíveis de conjunto de caracteres incluem "shift-jis" , "cn-gb" , "iso-8859-1" e outras. Para obter uma lista completa, consulte Conjuntos de caracteres suportados.
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
Elementos da API relacionados
writeObject | () | método |
public function writeObject(object:*):void
Versões de runtime: | AIR 1.0 |
Grava um objeto no fluxo de arquivo, fluxo de bytes ou na matriz de bytes no formato serializado AMF.
Parâmetros
object:* — O objeto a ser serializado.
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
Elementos da API relacionados
writeShort | () | método |
public function writeShort(value:int):void
Versões de runtime: | AIR 1.0 |
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
value:int — Um valor de byte como uma integral.
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
writeUnsignedInt | () | método |
public function writeUnsignedInt(value:uint):void
Versões de runtime: | AIR 1.0 |
Grava um inteiro não assinado de 32 bits.
Parâmetros
value:uint — Um valor de byte como uma integral não assinada.
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
writeUTF | () | método |
public function writeUTF(value:String):void
Versões de runtime: | AIR 1.0 |
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
value:String — O valor da string para gravar.
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
RangeError — Se o comprimento da cadeia for maior que 65535.
| |
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
writeUTFBytes | () | método |
public function writeUTFBytes(value:String):void
Versões de runtime: | AIR 1.0 |
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
value:String — O valor da string para gravar.
|
Eventos
ioError: — Você não pode gravar no arquivo (por exemplo, porque o arquivo está ausente). Este evento só é despachado para arquivos que foram abertos para operações assíncronas (usando o método openAsync() ).
|
Lança
IOError — O arquivo não foi aberto; o arquivo foi aberto, mas não foi aberto com recursos de gravação; ou para um arquivo que tenha sido aberto para operações síncronas (usando o método open() ), o arquivo não pode ser gravado (por exemplo, porque o arquivo está ausente).
|
close | Evento |
flash.events.Event
propriedade Event.type =
flash.events.Event.CLOSE
Versões de runtime: | AIR 1.0 |
Indica que o fluxo foi fechado por uma chamada explícita para o método close()
.
Event.CLOSE
define o valor da propriedade type
de um objeto de evento close
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto cuja conexão foi fechada. |
Elementos da API relacionados
complete | Evento |
flash.events.Event
propriedade Event.type =
flash.events.Event.COMPLETE
Versões de runtime: | AIR 1.0 |
Sinaliza que o fim do fluxo foi alcançado.
A constanteEvent.COMPLETE
define o valor da propriedade type
de um objeto de evento complete
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto de rede que concluiu o carregamento. |
Elementos da API relacionados
ioError | Evento |
flash.events.IOErrorEvent
propriedade IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Versões de runtime: | AIR 1.0 |
Indica que um erro ocorreu durante uma operação assíncrona de E/S de arquivo.
Define o valor da propriedadetype
de um objeto de evento ioError
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
errorID | Um número de referência associado ao erro específico (somente AIR). |
target | O objeto de rede que está recebendo o erro de entrada/saída. |
text | Texto a ser exibido como uma mensagem de erro. |
outputProgress | Evento |
flash.events.OutputProgressEvent
propriedade OutputProgressEvent.type =
flash.events.OutputProgressEvent.OUTPUT_PROGRESS
Versões de runtime: | AIR 1.0 |
Sinaliza que os dados armazenados em buffer foram gravados no arquivo.
Define o valor da propriedadetype
de um objeto de evento outputProgress
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
bytesPending | O número de bytes que resta a gravar quando o ouvinte processar o evento. |
bytesTotal | O número total de bytes que será gravado no final se o processo de gravação for bem-sucedido. |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto FileStream que está reportando o progresso. |
progress | Evento |
flash.events.ProgressEvent
propriedade ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS
Versões de runtime: | AIR 1.0 |
Sinaliza a disponibilidade de novos dados no fluxo.
Define o valor da propriedadetype
de um objeto de evento progress
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
bytesLoaded | O número de itens ou bytes carregados no momento em que o ouvinte processa o evento. |
bytesTotal | O número total de itens ou bytes que serão carregados no final se o processo de carregamento tiver êxito. |
cancelable | false ; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O objeto que está informando o andamento. |
Wed Jun 13 2018, 11:10 AM Z