zng_task::fs

Function write

pub async fn write<P, C>(path: P, contents: C) -> Result<(), Error>
where P: AsRef<Path>, C: AsRef<[u8]>,
Expand description

Writes a slice of bytes as the new contents of a file.

This function will create a file if it does not exist, and will entirely replace its contents if it does.

§Errors

An error will be returned in the following situations:

  • The file’s parent directory does not exist.
  • The current process lacks permissions to write to the file.
  • Some other I/O error occurred.

§Examples

async_fs::write("a.txt", b"Hello world!").await?;