取得符號連結屬性 (file.lattrs)

聲明

屬性表, 錯誤資訊 = file.lattrs(目錄路徑 [, 請求字段])

參數

• 目錄路徑
  文字型
• 請求字段
  可選參數，支援以下三種傳法：
  • 省略：建立並返回包含所有字段的屬性表
  • 傳入一個表（表型）：不新建表，而是將屬性填充到傳入的表中
  • 傳入單個字段名（文字型）：直接返回該字段的值
  • "dev"：這表示檔案的 inode 所在的裝置
  • "ino"：檔案的 inode 號
  • "mode"：檔案類型，可能是 "file", "directory", "link", "socket", "named pipe", "char device", "block device" 或 "other"
  • "nlink"：硬連結數
  • "uid"：檔案所有者 ID
  • "gid"：檔案所有者組 ID
  • "rdev"：特殊檔案 inode 的裝置類型
  • "access"：檔案最近訪問時間
  • "modification"：檔案最近修改時間
  • "change"：檔案狀態最近改變時間
  • "size"：檔案大小，單位為位元組
  • "permissions"：檔案權限
  • "blksize"：檔案系統 I/O 的塊大小
  • "blocks"：檔案已分配的 512 位元組塊數
  • "target"：符號連結指向的檔案路徑

回傳值

• 屬性表
  表型，操作成功返回屬性表，操作失敗返回 nil
• 錯誤資訊
  文字型，操作失敗時的錯誤資訊

說明

取得檔案屬性；若目標是符號連結，返回符號連結本身的資訊（而不是指向的目標），等同於 lfs.symlinkattributes
該函式在 20250705 以後版本方可使用

範例

local info, err = file.lattrs("/var/mobile/Media/1ferver/lua/scripts/")
if info then
    sys.alert("文件信息："..json.encode(info))
else
    sys.alert("获取文件属性失败："..err)
end

注：上述代碼中使用了非本章函式 sys.alert