Skip to content

Struct std::io::Stderr

rust
pub struct Stderr { /* private fields */ }

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

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

Note: Windows 可移植性注意事项

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

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

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

Implementations

impl Stderr

lock

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

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

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

返回值:返回一个StderrLock

rust
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

as_fd

借用文件描述符。

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

impl AsHandle for Stderr

Available on Windows only.

as_handle

借用句柄。

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

impl AsRawFd for Stderr

as_raw_fd

提取原始文件描述符。

rust
fn as_raw_fd(&self) -> RawFd

impl AsRawHandle for Stderr

Available on Windows only.

as_raw_handle

提取原始句柄。

rust
fn as_raw_handle(&self) -> RawHandle

impl Debug for Stderr

fmt

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

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

impl IsTerminal for Stderr

is_terminal

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

rust
fn is_terminal(&self) -> bool

impl Write for &Stderr

write

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

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

write_vectored

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

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

is_write_vectored

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

rust
fn is_write_vectored(&self) -> bool

flush

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

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

write_all

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

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

write_all_vectored

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

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

write_fmt

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

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

by_ref

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

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

impl Write for Stderr

write

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

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

write_vectored

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

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

is_write_vectored

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

rust
fn is_write_vectored(&self) -> bool

flush

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

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

write_all

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

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

write_all_vectored

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

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

write_fmt

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

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

by_ref

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

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

Auto Trait Implementations

impl RefUnwindSafe for Stderr

impl Send for Stderr

impl Sync for Stderr

impl Unpin for Stderr

impl UnwindSafe for Stderr

Blanket Implementations

impl<T> Any for T

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

impl<T> Borrow<T> for T

rust
impl<T> Borrow<T> for T
where
  T: ?Sized,

impl<T> BorrowMut<T> for T

rust
impl<T> BorrowMut<T> for T
where
  T: ?Sized,

impl<T> From<T> for T

impl<T, U> Into<U> for T

rust
impl<T, U> Into<U> for T
where
  U: From<T>,

impl<T, U> TryFrom<U> for T

rust
impl<T, U> TryFrom<U> for T
where
  U: Into<T>,

impl<T, U> TryInto<U> for T

rust
impl<T, U> TryInto<U> for T
where
  U: TryFrom<T>,

MIT Licensed