追加路径组成部分 (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"