Lib.rs

Allows to close a file without silently dropping errors

Errors can happen when closing a file, indicating that the file was not (completely) written. The standard library currently simply discards such error when the std::io::File goes out of scope.

This crate allows to close the file and handle potential errors.

use close_file::Closable;
use std::io::Write;

let mut f = std::fs::File::create("temp").unwrap();
f.write_all("Hello, world!".as_bytes());
f.close();

The close() function consumes the File. However, on Windows, a failed close operation may be retried. For this case the returned CloseError contains the original File.