Struct std::io::Stderr

pub struct Stderr { /* private fields */ }

进程的标准错误流的句柄。

有关更多信息，请参见 io::stderr 方法。

Note: Windows 可移植性注意事项

在控制台中操作时，此流的 Windows 实现不支持非 UTF-8 字节序列。 尝试写入无效的 UTF-8 字节将返回错误。

在具有分离控制台的进程中，例如使用 #![windows_subsystem = "windows"] 的进程，或在从此类进程派生的子进程中，包含的句柄将为空。

在这种情况下，标准库的 Read 和 Write 将什么都不做，默默地成功。 通过标准库或通过原始 Windows API 调用的所有其他 I/O 操作都将失败。

Implementations

impl Stderr

pub fn lock(&self) -> StderrLock<'static>

将此句柄锁定到标准错误流，返回可写防护。

当返回的锁离开作用域时，将释放该锁。 返回的防护还实现 Write trait 来写入数据。

Examples

use std::io::{self, Write};

fn foo() -> io::Result<()> {
    let stderr = io::stderr();
    let mut handle = stderr.lock();

    handle.write_all(b"hello world")?;

    Ok(())
}

Trait Implementations

impl AsFd for Stderr

fn as_fd(&self) -> BorrowedFd<'_>

借用文件描述符。

impl AsHandle for Stderr

Available on Windows only.

fn as_handle(&self) -> BorrowedHandle<'_>

借用句柄。

impl AsRawFd for Stderr

fn as_raw_fd(&self) -> RawFd

提取原始文件描述符。

impl AsRawHandle for Stderr

Available on Windows only.

fn as_raw_handle(&self) -> RawHandle

提取原始句柄。

impl Debug for Stderr

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

使用给定的格式化程序格式化该值。

impl IsTerminal for Stderr

fn is_terminal(&self) -> bool

如果 descriptor/handle 引用 terminal/tty，则返回 true。

impl Write for &Stderr

fn write(&mut self, buf: &[u8]) -> Result<usize>

在此 writer 中写入一个缓冲区，返回写入的字节数。

fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize>

类似于 write，不同之处在于它是从缓冲区切片中写入数据的。

fn is_write_vectored(&self) -> bool

🔬This is a nightly-only experimental API. (can_vector #69941)

确定此 Writer 是否具有有效的 write_vectored 实现。

fn flush(&mut self) -> Result<()>

刷新此输出流，确保所有中间缓冲的内容均到达其目的地。

fn write_all(&mut self, buf: &[u8]) -> Result<()>

尝试将整个缓冲区写入此 writer。

fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<()>

🔬This is a nightly-only experimental API. (write_all_vectored #70436)

尝试将多个缓冲区写入此 writer。

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<()>

将格式化的字符串写入此 writer，返回遇到的任何错误。

fn by_ref(&mut self) -> &mut Selfwhere Self: Sized,

为这个 Write 实例创建一个 “by reference” 适配器。

impl Write for Stderr

fn write(&mut self, buf: &[u8]) -> Result<usize>

在此 writer 中写入一个缓冲区，返回写入的字节数。

fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize>

类似于 write，不同之处在于它是从缓冲区切片中写入数据的。

fn is_write_vectored(&self) -> bool

🔬This is a nightly-only experimental API. (can_vector #69941)

确定此 Writer 是否具有有效的 write_vectored 实现。

fn flush(&mut self) -> Result<()>

刷新此输出流，确保所有中间缓冲的内容均到达其目的地。

fn write_all(&mut self, buf: &[u8]) -> Result<()>

尝试将整个缓冲区写入此 writer。

fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<()>

🔬This is a nightly-only experimental API. (write_all_vectored #70436)

尝试将多个缓冲区写入此 writer。

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<()>

将格式化的字符串写入此 writer，返回遇到的任何错误。

fn by_ref(&mut self) -> &mut Selfwhere Self: Sized,

为这个 Write 实例创建一个 “by reference” 适配器。