blob: 5f2166bcf467ff8a813ff0383f7bfff0fe922155 [file] [log] [blame] [view]
The `File` struct represents a file that has been opened (it wraps a file
descriptor), and gives read and/or write access to the underlying file.
Since many things can go wrong when doing file I/O, all the `File` methods
return the `IoResult<T>` type, which is an alias for `Result<T, IoError>`.
This makes the failure of all I/O operations *explicit*, thanks to
this the programmer can see all the failure paths, and is encouraged to handle
them in a proactive manner.