追加路徑組成部分 (file.path.add_component)

聲明

新路徑, 錯誤資訊 = file.path.add_component(路徑, 組成部分)

參數

• 路徑
  文字型，基礎路徑字串
• 組成部分
  文字型，要追加的路徑組成部分

回傳值

• 新路徑
  文字型 或 nil，成功時回傳追加組成部分後的路徑字串，路徑或組成部分無效時回傳 nil
• 錯誤資訊
  文字型，路徑或組成部分無效時回傳 "Invalid path"

說明

在基礎路徑後追加指定的路徑組成部分，自動處理連接處的路徑分隔符 /
此函式只生成路徑字串，不會建立實際的檔案或目錄
該函式在 20250914 以後的版本方可使用

範例

local full_path = file.path.add_component("/usr/local", "bin") -- 回傳 "/usr/local/bin"
local tmp_path = file.path.add_component("/", "tmp") -- 回傳 "/tmp"