Struct std::io::Stdout

[+] Show declaration

pub struct Stdout { /* fields omitted */ }

[−] Expand description

A handle to the global standard output stream of the current process.

Each handle shares a global buffer of data to be written to the standard output stream. Access is also synchronized via a lock and explicit control over locking is available via the lock method.

Created by the io::stdout method.

Note: Windows Portability Consideration

When operating in a console, the Windows implementation of this stream does not support non-UTF-8 byte sequences. Attempting to write bytes that are not valid UTF-8 will return an error.

Methods

impl Stdout[−]

Important traits for StdoutLock<'_>

impl<'_> Write for StdoutLock<'_>

pub fn lock(&self) -> StdoutLock[−]

Locks this handle to the standard output stream, returning a writable guard.

The lock is released when the returned lock goes out of scope. The returned guard also implements the Write trait for writing data.

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(())
}

Trait Implementations

impl Write for Stdout[+]

[+] Show hidden undocumented items

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

Write a buffer into this writer, returning how many bytes were written.

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

Like write, except that it writes from a slice of buffers.

fn flush(&mut self) -> Result<()>[−]

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.

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

Attempts to write an entire buffer into this writer.

fn write_fmt(&mut self, args: Arguments) -> Result<()>[−]

Writes a formatted string into this writer, returning any error encountered.

Important traits for &'_ mut F

impl<'_, F> Future for &'_ mut F where
    F: Unpin + Future + ?Sized,  type Output = <F as Future>::Output;impl<'_, I> Iterator for &'_ mut I where
    I: Iterator + ?Sized,  type Item = <I as Iterator>::Item;impl<R: Read + ?Sized, '_> Read for &'_ mut Rimpl<W: Write + ?Sized, '_> Write for &'_ mut W

fn by_ref(&mut self) -> &mut Self where
    Self: Sized, [−]

Creates a "by reference" adaptor for this instance of Write.

impl AsRawFd for Stdout[+]

[+] Show hidden undocumented items

fn as_raw_fd(&self) -> RawFd[−]

This is supported on Unix only.

Extracts the raw file descriptor.

impl AsRawHandle for Stdout[+]

[+] Show hidden undocumented items

fn as_raw_handle(&self) -> RawHandle[−]

This is supported on Windows only.

Extracts the raw handle, without taking any ownership.

impl Debug for Stdout[+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter) -> Result[−]

Formats the value using the given formatter.