组件：文件系统
=====================
此组件由处于管理模式的[[item:floppy_disk:zh|软盘]]或[[item:hard_disk_drive:zh|硬盘驱动器]]提供。（对于非管理模式，请参见[[component:drive:zh|驱动器]]组件）  
  
组件名：`filesystem`。  
  
回调函数：

- `spaceUsed():number`  
  返回当前文件系统的已用容量，单位为字节。  
\\
- `open(path:string[, mode:string='r']):number`  
  打开一个新的文件描述符，并返回其句柄。  
\\
- `seek(handle:number, whence:string, offset:number):number`  
  在指定的已打开文件描述符中移动操作位置。返回新的指针位置。  
\\
- `makeDirectory(path:string):boolean`  
  在文件系统的给定绝对路径处创建一个新目录。若必要的话创建其各级父目录。  
\\
- `exists(path:string):boolean`  
  返回文件系统中给定绝对路径指向的对象是否存在 。  
\\
- `isReadOnly():boolean`  
  返回文件系统是否只读。  
\\
- `write(handle:number, value:string):boolean`  
  将给定数据写入到给定句柄对应的文件描述符中。  
\\
- `spaceTotal():number`  
  返回文件系统的总容量，单位为字节。  
\\
- `isDirectory(path:string):boolean`  
  返回文件系统中给定绝对路径指向的对象是否为目录 。  
\\
- `rename(from:string, to:string):boolean`  
  将文件系统中第一个给定绝对路径指向的对象重命名/移动为第二个。  
\\
- `list(path:string):table`  
  返回文件系统中给定绝对路径指向的目录下的对象名列表。  
\\
- `lastModified(path:string):number`  
  返回文件系统中给定绝对路径指向的对象上次修改时的（现实世界）时间戳。  
\\
- `getLabel():string`  
  获取文件系统的当前标签。  
\\
- `remove(path:string):boolean`  
  删除文件系统中给定绝对路径指向的对象。  
\\
- `close(handle:number)`  
  关闭给定句柄对应的文件描述符。  
\\
- `size(path:string):number`  
  返回文件系统中给定绝对路径指向的对象的大小。  
\\
- `read(handle:number, count:number):string or nil`  
  从指定句柄对应的文件描述符中读取最多指定大小的数据。若到达`EOF`则返回`nil`。  
\\
- `setLabel(value:string):string`  
  设定文件系统的标签。返回新的标签值，可能为截短形式。

目录
----

{{page>component:contents:zh&noheader&noeditbutton&nouser&nofooter}}