Nối thêm phần mở rộng tệp (file.path.add_extension)

Khai báo

đường dẫn mới, thông báo lỗi = file.path.add_extension(đường dẫn, phần mở rộng)

Tham số

• đường dẫn
  Kiểu chuỗi. Chuỗi đường dẫn cơ sở.
• phần mở rộng
  Kiểu chuỗi. Phần mở rộng tệp cần nối thêm, thường không có dấu . ở đầu.

Giá trị trả về

• đường dẫn mới
  Kiểu chuỗi hoặc nil. Khi thành công, trả về chuỗi đường dẫn sau khi nối thêm phần mở rộng; trả về nil nếu không thể nối thêm.
• thông báo lỗi
  Kiểu chuỗi. Trả về "Invalid path" nếu chuỗi đường dẫn không hợp lệ, "Invalid extension" nếu chuỗi phần mở rộng không hợp lệ. Nếu không thể nối thêm vì phần mở rộng chứa / hoặc vì lý do tương tự, hàm có thể chỉ trả về nil mà không kèm thông báo lỗi.

Mô tả

Nối . và phần mở rộng được chỉ định vào cuối đường dẫn. Nếu đường dẫn ban đầu đã có phần mở rộng, phần mới được nối sau phần hiện có; ví dụ nối bak vào file.txt sẽ được file.txt.bak.
Phần mở rộng truyền vào có thể có dấu . ở đầu, nhưng hàm không loại bỏ dấu đó; truyền .txt sẽ nối thêm ..txt.
Hàm chỉ tạo chuỗi đường dẫn, không đổi tên tệp hoặc thư mục thực tế.
Hàm này chỉ khả dụng trên các phiên bản phát hành sau 20250914.

Ví dụ

local new_path = file.path.add_extension("/path/to/file", "txt") -- Trả về "/path/to/file.txt"
local archive_path = file.path.add_extension("/path/to/file.tar", "gz") -- Trả về "/path/to/file.tar.gz"
local backup_path = file.path.add_extension("/path/to/file.txt", "bak") -- Trả về "/path/to/file.txt.bak"
local dotted_path = file.path.add_extension("/path/to/file", ".txt") -- Trả về "/path/to/file..txt"