Function rename

pub async fn rename<P, Q>(src: P, dst: Q) -> Result<(), Error>
where
    P: AsRef<Path>,
    Q: AsRef<Path>,

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 and dst 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?;