返回可在输入缓冲区中读取的数据的字节数。在尝试使用某一种读取方法读取数据之前，用户代码必须调用 bytesAvailable 以确保有足够的数据可用。

数据的字节顺序：为 Endian 类中的 BIG_ENDIAN 或 LITTLE_ENDIAN 常量。

指定在使用 readObject() 或 writeObject() 方法写入或读取二进制数据时是使用 AMF3 格式还是 AMF0 格式。

该值为 ObjectEncoding 类中的常数。在默认情况下使用 AMF3 格式。

另请参见

文件中的当前位置。

此值可以按以下任一方式进行修改：

• 显式设置该属性
• 从 FileStream 对象中读取（通过使用一种读取方法）
• 写入到 FileStream 对象

该位置定义为一个数字（而不是单位），以支持长度大于 2³² 字节的文件。此属性的值始终是一个小于 2⁵³ 的整数。如果将此值设置为带有小数部分的数字，则会将此值舍入到最接近的整数。

在异步读取文件时，如果设置了 position 属性，应用程序将开始用从指定位置开始的数据填充读取缓冲区，而 bytesAvailable 属性可以设置为 0。在使用一种读取方法读取数据前等待 complete 事件；或在使用一种读取方法前等待 progress 事件并检查 bytesAvailable 属性。

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, File);

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 属性的值。在从缓冲区读取数据时，会读入新数据以重新填充读取缓冲区。

readAhead 属性对以同步方式打开的文件不起作用。

由于数据是以异步方式读取的，因此 FileStream 对象将调度 事件. 在 progress 事件的事件处理函数方法中，查看所需的字节数是否可用（通过检查 bytesAvailable 属性），然后通过使用一种读取方法从读取缓冲区读取数据。

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 对象。使用 open() 或 openAsync() 方法打开文件。

另请参见

关闭 FileStream 对象。

在调用 close() 方法后将无法读取或写入任何数据。如果以异步方式打开该文件（FileStream 对象使用 openAsync() 方法打开该文件），则调用 close() 方法将导致该对象调度 close 事件。

关闭应用程序将自动关闭与该应用程序中的 FileStream 对象相关联的所有文件。不过，最好在关闭应用程序之前，对以异步方式打开并具有要写入的未处理数据的所有 FileStream 对象注册 closed 事件（以确保写入数据）。

通过调用 open() 或 openAsync() 方法可以重复使用 FileStream 对象。这将关闭与 FileStream 对象相关联的任何文件，但该对象不会调度 close 事件。

对于以异步方式打开的 FileStream 对象（使用 openAsync() 方法），即使为 FileStream 对象调用了 close() 事件并删除了引用该对象的属性和变量，只要有尚未完成操作，并且为操作的完成注册了事件处理函数，就不会将 FileStream 对象作为垃圾回收。特别是，只要以下情况之一仍然可能存在，就会永久保持未引用的 FileStream 对象：

• 对于文件读取操作，尚未到达文件末尾（并且尚未调度 complete 事件）。
• 输出数据仍然可用于写入，并且与输出有关的事件（如 outputProgress 事件或 ioError 事件）已经注册了事件侦听器。

另请参见

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

以同步方式打开 FileStream 对象，指向由 file 参数指定的文件。

如果 FileStream 对象已打开，则调用此方法将在打开文件前关闭文件，且不会为以前打开的文件传送任何进一步事件（包括 close）。

在支持文件锁定的系统中，在“写入”或“更新”模式（FileMode.WRITE 或 FileMode.UPDATE）下打开的文件在关闭前将是不可读的。

参数

另请参见

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

以异步方式打开 FileStream 对象，指向由 file 参数指定的文件。

如果 FileStream 对象已打开，则调用此方法将在打开文件前关闭文件，且不会为以前打开的文件传送任何进一步事件（包括 close）。

如果 fileMode 参数设置为 FileMode.READ 或 FileMode.UPDATE，则文件一经打开，AIR 就会将数据读入到输入缓冲区中，并在将数据读入到输入缓冲区时调度 progress 和 open 事件。

在支持文件锁定的系统中，在“写入”或“更新”模式（FileMode.WRITE 或 FileMode.UPDATE）下打开的文件在关闭前将是不可读的。

参数

另请参见

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

从文件流、字节流或字节数组中读取布尔值。读取单个字节，如果字节非零，则返回 true，否则返回 false。

从文件流、字节流或字节数组中读取带符号的字节。

从文件流、字节流或字节数组中读取 length 参数指定的数据字节数。将从 offset 指定的位置开始，将字节读入 bytes 参数指定的 ByteArray 对象。

参数

从文件流、字节流或字节数组中读取 IEEE 754 双精度浮点数。

从文件流、字节流或字节数组中读取 IEEE 754 单精度浮点数。

从文件流、字节流或字节数组中读取带符号的 32 位整数。

使用指定的字符集从文件流、字节流或字节数组中读取指定长度的多字节字符串。

参数

另请参见

从文件流、字节流或字节数组中读取以 AMF 序列化格式编码的对象。

另请参见

从文件流、字节流或字节数组中读取带符号的 16 位整数。

从文件流、字节流或字节数组中读取无符号的字节。

从文件流、字节流或字节数组中读取无符号的 32 位整数。

从文件流、字节流或字节数组中读取无符号的 16 位整数。

从文件流、字节流或字节数组中读取 UTF-8 字符串。假定字符串的前缀是无符号的短整型（以字节表示长度）。

此方法类似于 Java ^® IDataInput 接口中的 readUTF() 方法。

从字节流或字节数组中读取包含 个字节的 UTF-8 字节序列，并返回一个字符串。

参数

在 FileStream 对象的 position 属性指定的位置截断文件。

删除从 position 属性指定的位置到文件末尾之间的字节。必须打开文件以进行写入。

另请参见

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

写入布尔值。根据 value 参数写入单个字节。如果为 true，则写入 1，如果为 false，则写入 0。

参数

写入一个字节。使用了该参数的低 8 位；忽略了高 24 位。

参数

在指定的字节数组、字节中，从偏移量（使用从零开始的索引）指定的字节开始，向文件流、字节流或字节数组中写入一个长度由 length 指定的字节序列。

如果省略 length 参数，则使用默认长度 0 并从 offset 开始写入整个缓冲区。如果还省略了 offset 参数，则写入整个缓冲区。

如果 offset 或 length 参数超出范围，它们将被锁定到 bytes 数组的开头和结尾。

参数

写入 IEEE 754 双精度（64 位）浮点数。

参数

写入 IEEE 754 单精度（32 位）浮点数。

参数

写入一个带符号的 32 位整数。

参数

使用指定的字符集将多字节字符串写入文件流、字节流或字节数组中。

参数

另请参见

以 AMF 序列化格式将对象写入文件流、字节流或字节数组中。

参数

另请参见

写入一个 16 位整数。使用了该参数的低 16 位；忽略了高 16 位。

参数

写入一个无符号的 32 位整数。

参数

将 UTF-8 字符串写入文件流、字节流或字节数组中。先写入以字节表示的 UTF-8 字符串长度（作为 16 位整数），然后写入表示字符串字符的字节。

参数

写入一个 UTF-8 字符串。类似于 writeUTF()，但不使用 16 位长度的词为字符串添加前缀。

参数

指示 close() 方法的显式调用已关闭流。

此事件具有以下属性：

另请参见

指出已到达流末尾。

此事件具有以下属性：

另请参见

指示在异步文件 I/O 操作期间发生错误。

此事件具有以下属性：

指出已将缓冲数据写入文件。

此事件具有以下属性：

指出流上有可用的新数据。

此事件具有以下属性：