pub async fn rename<P: AsRef<Path>, Q: AsRef<Path>>(
src: P,
dst: Q
) -> Result<()>
Expand description
Renames a file or directory to a new location.
If a file or directory already exists at the target location, it will be overwritten by this operation.
Errors
An error will be returned in the following situations:
src
does not point to an existing file or directory.src
anddst
are on different filesystems.- The current process lacks permissions to do the rename operation.
- Some other I/O error occurred.
Examples
async_fs::rename("a.txt", "b.txt").await?;