파일 확장자 추가 (file.path.add_extension)

선언

새 경로, 오류 정보 = file.path.add_extension(경로, 확장자)

매개변수

• 경로
  문자열. 기준 경로 문자열입니다.
• 확장자
  문자열. 추가할 파일 확장자이며, 일반적으로 앞에 .을 포함하지 않습니다.

반환값

• 새 경로
  문자열 또는 nil. 성공하면 확장자를 추가한 경로 문자열을 반환하고, 추가할 수 없으면 nil을 반환합니다.
• 오류 정보
  문자열. 경로 문자열이 유효하지 않으면 "Invalid path", 확장자 문자열이 유효하지 않으면 "Invalid extension"을 반환합니다. 확장자에 /가 포함되는 등의 이유로 추가할 수 없으면 오류 정보 없이 nil만 반환할 수 있습니다.

설명

경로 끝에 .과 지정한 확장자를 추가합니다. 원래 경로에 확장자가 있으면 기존 확장자 뒤에 새 확장자를 추가합니다. 예를 들어 file.txt에 bak을 추가하면 file.txt.bak이 됩니다.
전달하는 확장자 앞에 .을 포함할 수 있지만 이 함수는 이를 제거하지 않습니다. .txt를 전달하면 ..txt가 추가됩니다.
이 함수는 경로 문자열만 생성하며 실제 파일이나 디렉터리의 이름을 바꾸지 않습니다.
이 함수는 20250914 이후 버전에서 사용할 수 있습니다.

예제

local new_path = file.path.add_extension("/path/to/file", "txt") -- 반환 "/path/to/file.txt"
local archive_path = file.path.add_extension("/path/to/file.tar", "gz") -- 반환 "/path/to/file.tar.gz"
local backup_path = file.path.add_extension("/path/to/file.txt", "bak") -- 반환 "/path/to/file.txt.bak"
local dotted_path = file.path.add_extension("/path/to/file", ".txt") -- 반환 "/path/to/file..txt"