Fade away

Appearance

Struct std::io::Stdout ​

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

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

由 io::stdout 方法创建。

Note: Windows 可移植性注意事项

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

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

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

Implementations ​

impl Stdout ​

lock ​

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

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

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

返回值：返回一个 StdoutLock

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

fn main() -> io::Result<()> {
  let mut stdout = io::stdout().lock();
  stdout.write_all(b"hello world")?;
  Ok(())
}

Trait Implementations ​

impl AsFd for Stdout ​

as_fd ​

借用文件描述符。

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

impl AsHandle for Stdout ​

TIP

Available on Windows only.

as_handle ​

借用句柄。

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

impl AsRawFd for Stdout ​

as_raw_fd ​

提取原始文件描述符。

rust
fn as_raw_fd(&self) -> RawFd

impl AsRawHandle for Stdout ​

TIP

Available on Windows only.

as_raw_handle ​

提取原始句柄。

rust
fn as_raw_handle(&self) -> RawHandle

impl Debug for Stdout ​

fmt ​

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

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

impl IsTerminal for Stdout ​

is_terminal ​

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

rust
fn is_terminal(&self) -> bool

impl Write for &Stdout ​

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

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

impl Send for Stdout ​

impl Sync for Stdout ​

impl Unpin for Stdout ​

impl UnwindSafe for Stdout ​

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

Copyright © 2024-present xarzhi