Rust rename用法及代碼示例

將文件或目錄重命名為新名稱，如果 to 已存在，則替換原始文件。

如果新名稱位於不同的掛載點，這將不起作用。

特定於平台的行為

此函數當前對應於 Unix 上的 rename 函數和 Windows 上帶有 MOVEFILE_REPLACE_EXISTING 標誌的 MoveFileEx 函數。

因此，雙方的行為from和to存在不同。在 Unix 上，如果from是一個目錄，to也必須是一個(空)目錄。如果from不是目錄，to也必須不是目錄。相比之下，在 Windows 上，from可以是任何東西，但是to必須不是是一個目錄。

請注意，這個may change in the future。

錯誤

此函數會在以下情況下返回錯誤，但不僅限於這些情況：

• from 不存在。
• 用戶沒有查看內容的權限。
• from 和 to 位於不同的文件係統上。

例子

use std::fs;

fn main() -> std::io::Result<()> {
    fs::rename("a.txt", "b.txt")?; // Rename a.txt to b.txt
    Ok(())
}