imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li

2026-08-24T08:08:27Z

Imported from legacy OpenComputers documentation at ocdoc.cil.li

New page

= 组件：文件系统 =

此组件由处于管理模式的[[Item/floppy disk/zh|软盘]]或[[Item/hard disk drive/zh|硬盘驱动器]]提供。（对于非管理模式，请参见[[Component/drive/zh|驱动器]]组件）

组件名：`filesystem`。

回调函数：

* `spaceUsed():number`

<pre>返回当前文件系统的已用容量，单位为字节。
</pre>

* `open(path:string[, mode:string='r']):number`

<pre>打开一个新的文件描述符，并返回其句柄。
</pre>

* `seek(handle:number, whence:string, offset:number):number`

<pre>在指定的已打开文件描述符中移动操作位置。返回新的指针位置。
</pre>

* `makeDirectory(path:string):boolean`

<pre>在文件系统的给定绝对路径处创建一个新目录。若必要的话创建其各级父目录。
</pre>

* `exists(path:string):boolean`

<pre>返回文件系统中给定绝对路径指向的对象是否存在。
</pre>

* `isReadOnly():boolean`

<pre>返回文件系统是否只读。
</pre>

* `write(handle:number, value:string):boolean`

<pre>将给定数据写入到给定句柄对应的文件描述符中。
</pre>

* `spaceTotal():number`

<pre>返回文件系统的总容量，单位为字节。
</pre>

* `isDirectory(path:string):boolean`

<pre>返回文件系统中给定绝对路径指向的对象是否为目录。
</pre>

* `rename(from:string, to:string):boolean`

<pre>将文件系统中第一个给定绝对路径指向的对象重命名/移动为第二个。
</pre>

* `list(path:string):table`

<pre>返回文件系统中给定绝对路径指向的目录下的对象名列表。
</pre>

* `lastModified(path:string):number`

<pre>返回文件系统中给定绝对路径指向的对象上次修改时的（现实世界）时间戳。
</pre>

* `getLabel():string`

<pre>获取文件系统的当前标签。
</pre>

* `remove(path:string):boolean`

<pre>删除文件系统中给定绝对路径指向的对象。
</pre>

* `close(handle:number)`

<pre>关闭给定句柄对应的文件描述符。
</pre>

* `size(path:string):number`

<pre>返回文件系统中给定绝对路径指向的对象的大小。
</pre>

* `read(handle:number, count:number):string or nil`

<pre>从指定句柄对应的文件描述符中读取最多指定大小的数据。若到达`EOF`则返回`nil`。
</pre>

* `setLabel(value:string):string`

<pre>设定文件系统的标签。返回新的标签值，可能为截短形式。
</pre>
== 目录 ==

{{:Component/contents/zh}}

Component/filesystem/zh - Revision history

imported>OCDoc Import: Imported from legacy OpenComputers documentation at ocdoc.cil.li