sys.volume 库模块帮助文档

sys.volume 成员列表 #

存储卷相关函数。
相关库：fsys.drives, sys.storage

sys.volume.deviceDefine(文件路径) #

将指定的目录映射为虚拟分区
成功返回分区路径

sys.volume.deviceDefine(文件路径,"Z:") #

将指定的目录映射为虚拟分区
成功返回分区路径

sys.volume.deviceRemove("字符串参数") #

移除分区

sys.volume.getAllDevice() #

返回所有设备名

sys.volume.getDeviceName(文件路径) #

文件路径转换为设备名

sys.volume.getDriveType(驱动器路径) #

返回驱动器类型
以DRIVE为前缀的常量表示不同类型

sys.volume.getFreeDrive() #

获取未使用的盘符（自"C:"开始）
这个函数实际指向 fsys.drives.free 函数

sys.volume.getInfo() #

返回对象:volumeinfoObject

sys.volume.getInfo(分区或完整路径) #

返回分区信息,
参数可指定盘符或完整文件路径
盘符可带冒号也可以不带

sys.volume.getLogicalDrives() #

返回一个包含所可用的逻辑分区盘符的数组,
盘符以冒号结束

这个函数实际指向 fsys.drives.get

sys.volume.getName(path) #

获取参数 @path 指定文件或文件夹所在磁盘卷的挂载点（根路径）。
它能解析具体的路径，并返回该路径在文件系统中所归属的卷的最长前缀。
可正确追踪挂载点与符号链接并返回物理卷挂载点。
本地路径返回盘符，网络共享路径返回最长前缀
返回值自动去除 \\?\ 前缀与尾部 \

sys.volume.getPathName(设备名) #

设备名转换为文件路径

sys.volume.getSpaceSize("C:\") #

获取分区空间大小, 剩余大小等信息。
参数指定该分区根目录或者分区内其他有效的目录路径，默认值为当前目录。
返回对象可用 tostring 或连接操作符转换为字符串，格式为："分区大小（使用百分比）"。

sys.volume.getSpaceSize() #

返回对象:valuespacesizeObject

sys.volume.maxSpace(子目录路径) #

将指定的子目录路径转换为空间最大的分区下的完整路径。
返回转换后的路径

sys.volume.setLabel("字符串参数","卷标") #

设置区分卷标

valuespacesizeObject 成员列表 #

valuespacesizeObject.availablePercentage #

有效空间百分比

valuespacesizeObject.avaliableSize #

剩余有效空间大小。
返回值为 math.size64 对象

返回对象:mathSize64Object

剩余有效空间大小。
返回值为格式化后的字符串（如 "200 GB"）

valuespacesizeObject.freePercentage #

剩余空间百分比

valuespacesizeObject.freeSize #

剩余空间大小。
返回值为 math.size64 对象

返回对象:mathSize64Object

剩余空间大小。
返回值为格式化后的字符串（如 "200 GB"）

valuespacesizeObject.totalSize #

总大小。
返回值为 math.size64 对象

返回对象:mathSize64Object

总大小。
返回值为格式化后的字符串（如 "200 GB"）

volumeinfoObject 成员列表 #

volumeinfoObject.drive #

分区路径

volumeinfoObject.flag #

标志位

volumeinfoObject.fsys #

文件系统

volumeinfoObject.label #

卷名

volumeinfoObject.maxlen #

文件路径最大长度

volumeinfoObject.serial #

序列号

volumeinfoObject.serialNum #

序列号(数值)

Markdown 格式