Component/filesystem/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`

设定文件系统的标签。返回新的标签值，可能为截短形式。

目录

< 100% 15% 15% >
组件API		3D打印机 - 抽象总线 - 无线接入点 - 区块加载器 - 电脑 - 合成 - 数据卡 - 数据库 - 调试 - 无人机 - 驱动器 - EEPROM - 经验 - 文件系统 - 发电机 - 地质分析仪 - GPU - 全息投影仪 - 因特网 - 物品栏控制器 - 拴绳 - 微控制器 - 调制解调器 - 运动传感器 - 导航 - 网络拆分器 - 活塞 - 红石 - 运动红石机构 - 机器人 - 屏幕 - 告示牌 - 储罐控制器 - 牵引光束 - 转运器 - 隧道 - 世界传感器
:::	其它	访问组件 - 信号
:::	模组联动	应用能源