对象 File

文件操作对象,用于二进制文件读写

文件操作对象用于对二进制文件进行操作,可使用 fs 模块打开和创建文件:

var f = fs.openFile('test.txt');

继承关系

成员属性

name

String, 查询当前文件名

readonly String File.name;

fd

Integer, 查询当前文件描述符

readonly Integer File.fd;

成员函数

chmod

查询当前文件的访问权限,Windows 不支持此方法

File.chmod(Integer mode) async;

调用参数:


seek

移动文件当前操作位置

File.seek(Long offset,
    Integer whence);

调用参数:


tell

查询流当前位置

Long File.tell();

返回结果:


rewind

移动当前位置到流开头

File.rewind();

size

查询流尺寸

Long File.size();

返回结果:


readAll

从流内读取剩余的全部数据

Buffer File.readAll() async;

返回结果:


truncate

修改文件尺寸,如果新尺寸小于原尺寸,则文件被截断

File.truncate(Long bytes) async;

调用参数:


eof

查询文件是否到结尾

Boolean File.eof();

返回结果:


flush

将文件缓冲区内容写入物理设备

File.flush() async;

stat

查询当前文件的基础信息

Stat File.stat() async;

返回结果:


read

从流内读取指定大小的数据

Buffer File.read(Integer bytes = -1) async;

调用参数:

返回结果:


write

将给定的数据写入流

File.write(Buffer data) async;

调用参数:


close

关闭当前流对象

File.close() async;

copyTo

复制流数据到目标流中

Long File.copyTo(Stream stm,
    Long bytes = -1) async;

调用参数:

返回结果:


dispose

强制回收对象,调用此方法后,对象资源将立即释放

File.dispose();

equals

比较当前对象与给定的对象是否相等

Boolean File.equals(object expected);

调用参数:

返回结果:


toString

返回对象的字符串表示,一般返回 "[Native Object]",对象可以根据自己的特性重新实现

String File.toString();

返回结果:


toJSON

返回对象的 JSON 格式表示,一般返回对象定义的可读属性集合

Value File.toJSON(String key = "");

调用参数:

返回结果:


valueOf

返回对象本身的数值

Value File.valueOf();

返回结果: