api: add IntoInnerError::into_error

Currently, for code that doesn't attempt to recover from errors but just
reports the error to the caller, it's forced to return the entire
`IntoInnerError` even if all one wants is the I/O error.

This commit adds `IntoInnerError::into_error` method that consumes
`IntoInnerError` and returns contained `io::Error`. This mirrors the API
of `std::io::IntoInnerError` in Rust stdlib, which provides such method.

PR #304

src/error.rs

@@ -312,6 +312,15 @@ impl<W> IntoInnerError<W> {
  &self.err
  }
 
+ /// Consumes the [`IntoInnerError`] and returns the error which caused the
+ /// call to [`Writer::into_inner`](crate::Writer::into_inner) to fail.
+ ///
+ /// Unlike [`IntoInnerError::error`], this can be used to obtain ownership
+ /// of the underlying error.
+ pub fn into_error(self) -> io::Error {
+ self.err
+ }
+
  /// Returns the underlying writer which generated the error.
  ///
  /// The returned value can be used for error recovery, such as