pub async fn read<P: AsRef<Path>>(path: P) -> Result<Vec<u8>>
Expand description
Reads the entire contents of a file as raw bytes.
This is a convenience function for reading entire files. It pre-allocates a buffer based on the file size when available, so it is typically faster than manually opening a file and reading from it.
If you want to read the contents as a string, use read_to_string
instead.
This function is an async version of std::fs::read
.
Errors
An error will be returned in the following situations:
path
does not point to an existing file.- The current process lacks permissions to read the file.
- Some other I/O error occurred.
Examples
use async_std::fs;
let contents = fs::read("a.txt").await?;