Di chuyển tệp hoặc thư mục (file.move)
Khai báo
thành công, thông báo lỗi = file.move(đường dẫn nguồn, đường dẫn đích [, chế độ])
Tham số
- đường dẫn nguồn
Kiểu chuỗi. Đường dẫn tuyệt đối của tệp hoặc thư mục nguồn. - đường dẫn đích
Kiểu chuỗi. Đường dẫn tuyệt đối đầy đủ của tệp hoặc thư mục sau khi di chuyển, bao gồm tên tệp hoặc tên thư mục đích. - chế độ 20250914+
Kiểu chuỗi, không bắt buộc. Chế độ di chuyển. Các giá trị:- chuỗi rỗng hoặc bỏ qua: chế độ mặc định không ghi đè; thất bại nếu đích đã tồn tại
- "overwrite" hoặc "o": ghi đè đích hiện có; đích hiện có sẽ bị xóa
- "merge" hoặc "m": chỉ hợp nhất thư mục; giữ lại các tệp đã có ở đích
- "overwrite-merge" hoặc "om"/"mo": hợp nhất thư mục và ghi đè các tệp trùng tên
Giá trị trả về
- thành công
Kiểu boolean. Trả về true khi thành công, false khi thất bại. - thông báo lỗi
Kiểu chuỗi. Thông báo lỗi khi thao tác thất bại.
Mô tả
Thực hiện di chuyển tệp hoặc thư mục mà
đường dẫn nguồntrỏ tới thành tệp hoặc thư mục tạiđường dẫn đích. Thay đổi tên trong cùng một thư mục chính là đổi tên.
Hàm có ngữ nghĩa “di chuyển thành đường dẫn chỉ định”, không phải “di chuyển vào trong thư mục chỉ định”.đường dẫn đíchchỉ định tệp hoặc thư mục cuối cùng; tên tệp hay thư mục nguồn không được tự động nối thêm. Ngay cả khi đích đã tồn tại và là thư mục, hoặc đường dẫn đích kết thúc bằng/, hàm cũng không đặt tệp hoặc thư mục nguồn vào trong thư mục đó.
Ví dụ, để di chuyển/a/b/cvào/d/e/mà giữ tênc, đường dẫn đích phải là/d/e/c, không thể chỉ là/d/e/.
Nếu đích đã tồn tại, hàm xử lý theo tham sốchế độ: chế độ mặc định trả về thất bại, chế độ ghi đè thay thế chính đích đó, còn chế độ hợp nhất thư mục hợp nhất nội dung thư mục nguồn vào thư mục đích.
Từ khóa: đổi tên tệp, đổi tên thư mục, di chuyển tệp, di chuyển thư mục.
Hàm này chỉ khả dụng trên các phiên bản phát hành sau 20250313.
Ví dụ
ok, err = file.move(XXT_SCRIPTS_PATH..'/1.zip', XXT_SCRIPTS_PATH..'/2.zip')
if not ok then
sys.alert('Di chuyển thất bại: '..err)
end
Lưu ý: Ví dụ trên sử dụng hàm ngoài chương này sys.alert.
Thực hiện di chuyển sang thư mục khác và giữ nguyên tên
-- Giả sử /d/e là thư mục đã tồn tại và /d/e/c chưa tồn tại
file.move('/a/b/c', '/d/e/c') -- Đúng: di chuyển c thành /d/e/c
-- Ví dụ độc lập về cách viết sai: đích là chính e, không phải c trong thư mục e
-- file.move('/a/b/c', '/d/e/') -- Thất bại ở chế độ mặc định vì đích đã tồn tại
-- Chế độ ghi đè thay thế chính e, không tạo /d/e/c (20250914+)
-- file.move('/a/b/c', '/d/e/', 'overwrite')
Định nghĩa hàm “di chuyển vào trong thư mục”
Dưới đây là ví dụ về hàm bao bọc tùy chỉnh, yêu cầu phiên bản sau 20250914. Thư mục đích phải đã tồn tại. Hàm giữ nguyên tên tệp hoặc thư mục nguồn và truyền tham số tùy chọn mode cho file.move. Xung đột tên vẫn được xử lý theo chế độ đã chỉ định.
local function file_move_into(src_path, dst_dir, mode)
if file.exists(dst_dir) ~= "directory" then
return false, "Target is not a directory"
end
local name, err = file.path.last_component(src_path)
if not name then
return false, err
end
-- Tránh dùng chính thư mục đích hoặc thư mục cha của nó làm đích cuối cùng.
if name == "" or name == "/" or name == "." or name == ".." then
return false, "Source path must end with a file or directory name"
end
local dst_path, path_err = file.path.add_component(dst_dir, name)
if not dst_path then
return false, path_err
end
return file.move(src_path, dst_path, mode)
end
-- Giả sử /d/e là thư mục đã tồn tại; di chuyển c thành /d/e/c
local ok, err = file_move_into("/a/b/c", "/d/e/")
if not ok then
print("Di chuyển thất bại: "..err)
end
-- Để thay thế /d/e/c, có thể chỉ định chế độ ghi đè khi gọi hàm:
-- file_move_into("/a/b/c", "/d/e/", "overwrite")
Lưu ý: Đoạn mã trên sử dụng file.exists, file.path.last_component và file.path.add_component.