경로 구성 요소 추가 (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"