lua中的lfs库介绍

说明

lfs是lua中的一个文件系统库，提供了更多高级的文件和目录操作功能，使得lua可以更方便地进行文件属性获取、目录遍历、路径管理以及文件锁定等操作

常用函数解析

lfs.attributes

lfs.attributes(file_path, attribute_name)

• 获取文件或目录的属性信息，如修改时间、大小等
• 示例:

local lfs = require "lfs"
local file_path = "/path/to/file.txt"
local attr = lfs.attributes(file_path)
print("Modification time:", attr.modification)
print("File size:", attr.size)

• 返回值: 返回一个包含指定属性信息的表，可根据需要访问不同的属性字段，如 modification（最后修改时间）、size（文件大小）等

lfs.chdir

lfs.chdir(path)

• 改变当前工作目录到指定的路径
• 示例:

local lfs = require "lfs"
lfs.chdir("/path/to/new/directory")

• 返回值: 无返回值。

lfs.currentdir

lfs.currentdir()

• 获取当前工作目录的路径
• 示例:

local lfs = require "lfs"
local current_dir = lfs.currentdir()
print("Current directory:", current_dir)

• 返回值: 返回当前工作目录的路径字符串

lfs.dir

lfs.dir(path)

• 返回一个迭代器，用于遍历指定目录中的文件和子目录
• 示例:

local lfs = require "lfs"
for file in lfs.dir("/path/to/directory") doprint("Found file:", file)
end

• 返回值: 返回一个迭代器，可以用于遍历目录中的每个文件和子目录名。

lfs.mkdir

lfs.mkdir(path)

• 创建一个新目录
• 示例:

local lfs = require "lfs"
lfs.mkdir("/path/to/new/directory")

• 返回值: 无返回值。

lfs.rmdir

lfs.rmdir(path)

• 删除一个目录
• 示例:

local lfs = require "lfs"
lfs.rmdir("/path/to/directory-to-delete")

• 返回值: 无返回值。

lfs.lock

lfs.lock(file_handle, mode)

• 在指定文件上设置或释放锁，用于控制并发访问
• 示例:

local lfs = require "lfs"
local file = io.open("/path/to/file.txt", "r")
lfs.lock(file, "w")  -- 对文件进行写入锁定

• 返回值: 无返回值。

lfs.touch

lfs.touch(file_path[, atime, mtime])

• 更新指定文件的访问时间和修改时间，如果文件不存在则创建空文件
• 示例:

local lfs = require "lfs"
lfs.touch("/path/to/file.txt")

• 返回值: 无返回值。

lfs.link

lfs.link(oldname, newname, symlink)

• 创建一个硬链接或符号链接（如果操作系统支持）
• 示例:

local lfs = require "lfs"
lfs.link("/path/to/source.txt", "/path/to/link.txt")

• 返回值: 成功时返回 true，失败时返回 nil 和错误信息

lfs.setmode

lfs.setmode(file_handle, mode)

• 设置指定文件的打开模式
• 示例:

local lfs = require "lfs"
local file = io.open("/path/to/file.txt", "r")
lfs.setmode(file, "binary")

• 返回值: 无返回值

lfs.symlinkattributes

lfs.symlinkattributes(file_path, attribute_name)

• 获取符号链接文件的属性信息
• 示例:

local lfs = require "lfs"
local attr = lfs.symlinkattributes("/path/to/symlink")
print("Link target:", attr.target)

• 返回值: 返回一个表，包含符号链接文件的属性信息，如 target（链接目标路径）等