Reads the entire contents of a file as a string.
This is a convenience function for reading entire files. It pre-allocates a string 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 raw bytes, use
This function is an async version of
An error will be returned in the following situations:
pathdoes not point to an existing file.
- The current process lacks permissions to read the file.
- The contents of the file cannot be read as a UTF-8 string.
- Some other I/O error occurred.
use async_std::fs; let contents = fs::read_to_string("a.txt").await?;