OxL Reference

method File.rename

Renames or moves (atomic within one file system; an existing destination file is replaced).

Example:

oxl✓ checked in CI
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  io

Since. 1.0.0-beta

Parameters

NameType
fromstr
tostr

Returns

()

Errors

Effects

io

Defined in: std/io/io.oxl:437

See also