method File.rename
Renames or moves (atomic within one file system; an existing destination file is replaced).
Example:
use std.io { File, fs }
fn main() io {
let dir = fs.tempDir()!
File.writeText("{dir}/a", "1")!
File.rename("{dir}/a", "{dir}/b")!
print("{File.exists("{dir}/a")} {File.exists("{dir}/b")}")
fs.removeAll(dir)!
}Output
false true
pub(api) static fn rename(from: str, to: str) -> () | IoError ioSince. 1.0.0-beta
Parameters
| Name | Type |
|---|---|
from | str |
to | str |
Returns
()
Errors
IoError@error
Effects
io
Defined in: std/io/io.oxl:437