rename in async_std::fs - Rust (original) (raw)

pub async fn rename<P: AsRef<Path>, Q: AsRef<Path>>(
    from: P,
    to: 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.

This function is an async version of std::fs::rename.

§Errors

An error will be returned in the following situations:

• from does not point to an existing file or directory.
• from and to are on different filesystems.
• The current process lacks permissions to do the rename operation.
• Some other I/O error occurred.

§Examples

use async_std::fs;

fs::rename("a.txt", "b.txt").await?;