---
name: rename
status: documented
runtime: pp
source: src/runtime/pp/filemod.rs
---
```{index} single: rename; Perl built-in (pp runtime)
```

# rename

## Synopsis

```perl
rename $old, $new or die "Cannot rename: $!";
rename 'file.tmp', 'file.dat';
```

## Description

Renames or moves a file.

Renames the file OLDNAME to NEWNAME. If NEWNAME already exists, it is
replaced atomically (on the same filesystem). Cannot move files across
filesystem boundaries. Uses `std::fs::rename`. Returns 1 on success,
0 on failure (and sets `$!`).

## See also

unlink, link, File::Copy