Struct std::io::IntoInnerError

1.0.0 · source ·
pub struct IntoInnerError<W>(_, _);
Expand description

BufWriter::into_inner 返回的错误,将写出缓冲区时发生的错误与缓冲的 writer 对象结合在一起,可用于从条件中恢复。

Examples

use std::io::BufWriter;
use std::net::TcpStream;

let mut stream = BufWriter::new(TcpStream::connect("127.0.0.1:34254").unwrap());

// 用流做东西

// 我们想取回 `TcpStream`,所以让我们尝试:

let stream = match stream.into_inner() {
    Ok(s) => s,
    Err(e) => {
        // 在这里,e 是一个 IntoInnerError
        panic!("An error occurred");
    }
};
Run

Implementations§

source§

impl<W> IntoInnerError<W>

source

pub fn error(&self) -> &Error

返回导致 BufWriter::into_inner() 调用失败的错误。

尝试写入内部缓冲区时返回此错误。

Examples
use std::io::BufWriter;
use std::net::TcpStream;

let mut stream = BufWriter::new(TcpStream::connect("127.0.0.1:34254").unwrap());

// 用流做东西

// 我们想取回 `TcpStream`,所以让我们尝试:

let stream = match stream.into_inner() {
    Ok(s) => s,
    Err(e) => {
        // 在这里,e 是一个 IntoInnerError,让我们记录内部错误。
        // 在此示例中,我们仅将 'log' 更改为 stdout。
        println!("{}", e.error());

        panic!("An unexpected error occurred.");
    }
};
Run
source

pub fn into_inner(self) -> W

返回产生错误的缓冲 writer 实例。

返回的对象可用于错误恢复,例如重新检查缓冲区。

Examples
use std::io::BufWriter;
use std::net::TcpStream;

let mut stream = BufWriter::new(TcpStream::connect("127.0.0.1:34254").unwrap());

// 用流做东西

// 我们想取回 `TcpStream`,所以让我们尝试:

let stream = match stream.into_inner() {
    Ok(s) => s,
    Err(e) => {
        // 在这里,e 是一个 IntoInnerError,让我们重新检查缓冲区:
        let buffer = e.into_inner();

        // 做一些事情来尝试恢复

        // 之后,让我们返回流
        buffer.into_inner().unwrap()
    }
};
Run
1.55.0 · source

pub fn into_error(self) -> Error

消耗 IntoInnerError 并返回导致 BufWriter::into_inner() 调用失败的错误。 与 error 不同,它可用于获取基本错误的所有权。

Example
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
1.55.0 · source

pub fn into_parts(self) -> (Error, W)

消耗 IntoInnerError 并返回导致 BufWriter::into_inner() 调用失败的错误,以及返回的 writer。

这可以用来简单地获取潜在错误的所有权。它也可以用于高级错误恢复。

Example
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§

source§

impl<W: Debug> Debug for IntoInnerError<W>

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

使用给定的格式化程序格式化该值。 Read more
source§

impl<W> Display for IntoInnerError<W>

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

使用给定的格式化程序格式化该值。 Read more
source§

impl<W: Send + Debug> Error for IntoInnerError<W>

source§

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()
1.30.0 · source§

fn source(&self) -> Option<&(dyn Error + 'static)>

此错误的下级来源 (如果有)。 Read more
source§

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting
source§

fn provide<'a>(&'a self, demand: &mut Demand<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access #99301)
提供对用于错误报告的上下文的基于类型的访问。 Read more
source§

impl<W> From<IntoInnerError<W>> for Error

source§

fn from(iie: IntoInnerError<W>) -> Error

从输入类型转换为此类型。

Auto Trait Implementations§

§

impl<W> !RefUnwindSafe for IntoInnerError<W>

§

impl<W> Send for IntoInnerError<W>where W: Send,

§

impl<W> Sync for IntoInnerError<W>where W: Sync,

§

impl<W> Unpin for IntoInnerError<W>where W: Unpin,

§

impl<W> !UnwindSafe for IntoInnerError<W>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

获取 selfTypeIdRead more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

从拥有的值中一成不变地借用。 Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

从拥有的值中借用。 Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

返回未更改的参数。

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

调用 U::from(self)

也就是说,这种转换是 From<T> for U 实现选择执行的任何操作。

source§

impl<E> Provider for Ewhere E: Error + ?Sized,

source§

fn provide<'a>(&'a self, demand: &mut Demand<'a>)

🔬This is a nightly-only experimental API. (provide_any #96024)
数据提供者应实现此方法以提供他们能够通过使用 demand 提供的所有值。 Read more
source§

impl<T> ToString for Twhere T: Display + ?Sized,

source§

default fn to_string(&self) -> String

将给定值转换为 StringRead more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

发生转换错误时返回的类型。
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

执行转换。
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

发生转换错误时返回的类型。
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

执行转换。