メインコンテンツまでスキップ

パス構成要素を追加 (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"