Struct std::io::IntoInnerError 1.0.0[−][src]
pub struct IntoInnerError<W>(_, _);
An error returned by BufWriter::into_inner
which combines an error that
happened while writing out the buffer, and the buffered writer object
which may be used to recover from the condition.
Examples
use std::io::BufWriter; use std::net::TcpStream; let mut stream = BufWriter::new(TcpStream::connect("127.0.0.1:34254").unwrap()); // do stuff with the stream // we want to get our `TcpStream` back, so let's try: let stream = match stream.into_inner() { Ok(s) => s, Err(e) => { // Here, e is an IntoInnerError panic!("An error occurred"); } };Run
Implementations
impl<W> IntoInnerError<W>
[src]
impl<W> IntoInnerError<W>
[src]pub fn error(&self) -> &Error
[src]
Returns the error which caused the call to BufWriter::into_inner()
to fail.
This error was returned when attempting to write the internal buffer.
Examples
use std::io::BufWriter; use std::net::TcpStream; let mut stream = BufWriter::new(TcpStream::connect("127.0.0.1:34254").unwrap()); // do stuff with the stream // we want to get our `TcpStream` back, so let's try: let stream = match stream.into_inner() { Ok(s) => s, Err(e) => { // Here, e is an IntoInnerError, let's log the inner error. // // We'll just 'log' to stdout for this example. println!("{}", e.error()); panic!("An unexpected error occurred."); } };Run
pub fn into_inner(self) -> W
[src]
Returns the buffered writer instance which generated the error.
The returned object can be used for error recovery, such as re-inspecting the buffer.
Examples
use std::io::BufWriter; use std::net::TcpStream; let mut stream = BufWriter::new(TcpStream::connect("127.0.0.1:34254").unwrap()); // do stuff with the stream // we want to get our `TcpStream` back, so let's try: let stream = match stream.into_inner() { Ok(s) => s, Err(e) => { // Here, e is an IntoInnerError, let's re-examine the buffer: let buffer = e.into_inner(); // do stuff to try to recover // afterwards, let's just return the stream buffer.into_inner().unwrap() } };Run
pub fn into_error(self) -> Error
[src]
Consumes the IntoInnerError
and returns the error which caused the call to
BufWriter::into_inner()
to fail. Unlike error
, this can be used to
obtain ownership of the underlying error.
Example
#![feature(io_into_inner_error_parts)] use std::io::{BufWriter, ErrorKind, Write}; let mut not_enough_space = [0u8; 10]; let mut stream = BufWriter::new(not_enough_space.as_mut()); write!(stream, "this cannot be actually written").unwrap(); let into_inner_err = stream.into_inner().expect_err("now we discover it's too small"); let err = into_inner_err.into_error(); assert_eq!(err.kind(), ErrorKind::WriteZero);Run
pub fn into_parts(self) -> (Error, W)
[src]
Consumes the IntoInnerError
and returns the error which caused the call to
BufWriter::into_inner()
to fail, and the underlying writer.
This can be used to simply obtain ownership of the underlying error; it can also be used for advanced error recovery.
Example
#![feature(io_into_inner_error_parts)] use std::io::{BufWriter, ErrorKind, Write}; let mut not_enough_space = [0u8; 10]; let mut stream = BufWriter::new(not_enough_space.as_mut()); write!(stream, "this cannot be actually written").unwrap(); let into_inner_err = stream.into_inner().expect_err("now we discover it's too small"); let (err, recovered_writer) = into_inner_err.into_parts(); assert_eq!(err.kind(), ErrorKind::WriteZero); assert_eq!(recovered_writer.buffer(), b"t be actually written");Run
Trait Implementations
impl<W: Send + Debug> Error for IntoInnerError<W>
[src]
impl<W: Send + Debug> Error for IntoInnerError<W>
[src]impl<W> From<IntoInnerError<W>> for Error
[src]
impl<W> From<IntoInnerError<W>> for Error
[src]fn from(iie: IntoInnerError<W>) -> Error
[src]
Auto Trait Implementations
impl<W> !RefUnwindSafe for IntoInnerError<W>
impl<W> Send for IntoInnerError<W> where
W: Send,
W: Send,
impl<W> Sync for IntoInnerError<W> where
W: Sync,
W: Sync,
impl<W> Unpin for IntoInnerError<W> where
W: Unpin,
W: Unpin,
impl<W> !UnwindSafe for IntoInnerError<W>
Blanket Implementations
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]pub fn borrow(&self) -> &TⓘNotable traits for &'_ mut I
impl<'_, I> Iterator for &'_ mut I where
I: Iterator + ?Sized, type Item = <I as Iterator>::Item;impl<'_, F> Future for &'_ mut F where
F: Future + Unpin + ?Sized, type Output = <F as Future>::Output;impl<R: Read + ?Sized> Read for &mut Rimpl<W: Write + ?Sized> Write for &mut W
[src]
Notable traits for &'_ mut I
impl<'_, I> Iterator for &'_ mut I where
I: Iterator + ?Sized, type Item = <I as Iterator>::Item;impl<'_, F> Future for &'_ mut F where
F: Future + Unpin + ?Sized, type Output = <F as Future>::Output;impl<R: Read + ?Sized> Read for &mut Rimpl<W: Write + ?Sized> Write for &mut W
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut TⓘNotable traits for &'_ mut I
impl<'_, I> Iterator for &'_ mut I where
I: Iterator + ?Sized, type Item = <I as Iterator>::Item;impl<'_, F> Future for &'_ mut F where
F: Future + Unpin + ?Sized, type Output = <F as Future>::Output;impl<R: Read + ?Sized> Read for &mut Rimpl<W: Write + ?Sized> Write for &mut W
[src]
Notable traits for &'_ mut I
impl<'_, I> Iterator for &'_ mut I where
I: Iterator + ?Sized, type Item = <I as Iterator>::Item;impl<'_, F> Future for &'_ mut F where
F: Future + Unpin + ?Sized, type Output = <F as Future>::Output;impl<R: Read + ?Sized> Read for &mut Rimpl<W: Write + ?Sized> Write for &mut W