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");