Struct std::io::Stderr

pub struct Stderr { /* fields omitted */ }

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

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

Note: Windows 可移植性注意事项

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

Implementations

impl Stderr

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

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

当返回的锁离开作用域时，将释放该锁。 返回的防护还实现 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(())
}

pub fn into_locked(self) -> StderrLock<'static>

🔬 This is a nightly-only experimental API. (stdio_locked #86845)

锁定并使用此句柄到标准错误流，返回可写保护。

当返回的守卫作用域解除锁定。 返回的防护还实现 Write trait 来写入数据。

Examples

#![feature(stdio_locked)]
use std::io::{self, Write};

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

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

    Ok(())
}

Trait Implementations

impl AsRawFd for Stderr

This is supported on Unix only.

fn as_raw_fd(&self) -> RawFd

提取原始文件描述符。

impl AsRawFd for Stderr

This is supported on WASI only.

fn as_raw_fd(&self) -> RawFd

🔬 This is a nightly-only experimental API. (wasi_ext #71213)

提取原始文件描述符。

impl AsRawHandle for Stderr

This is supported on Windows only.

fn as_raw_handle(&self) -> RawHandle

提取原始句柄，无需任何所有权。

impl Debug for Stderr

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

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

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 Self where
    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 Self where
    Self: Sized, 

为此 Write 实例创建 “by reference” 适配器。