Struct std::io::Stdout

pub struct Stdout { /* fields omitted */ }

当前进程的标准输出流的句柄。

每个句柄共享一个待写入标准输出流的数据缓冲区。 访问也可以通过锁定来同步，并且可以通过 lock 方法对锁定进行显式控制。

由 io::stdout 方法创建。

Note: Windows 可移植性注意事项

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

Implementations

impl Stdout

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

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

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

Examples

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

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

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

    Ok(())
}

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

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

将此句柄用于标准输出流，锁定与流关联的共享缓冲区并返回可写保护。

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

使用 io::stdout_locked 函数直接获取锁定句柄通常更简单，除非附近的代码也需要使用解锁句柄。

Examples

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

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

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

    Ok(())
}

Trait Implementations

impl AsRawFd for Stdout

This is supported on Unix only.

fn as_raw_fd(&self) -> RawFd

提取原始文件描述符。

impl AsRawFd for Stdout

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 Stdout

This is supported on Windows only.

fn as_raw_handle(&self) -> RawHandle

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

impl Debug for Stdout

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

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

impl Write for Stdout

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 &Stdout

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” 适配器。