alloc::fmt::write - Rust
Description: API documentation for the Rust `write` fn in crate `alloc`.
Keywords: rust, rustlang, rust-lang, write

# 1.0.0[−][src]Function alloc::fmt::write

    pub fn write(output: &mut dyn Write, args: Arguments) -> Result<(), Error>

The `write` function takes an output stream, and an `Arguments` struct that can be precompiled with the `format_args!` macro.

The arguments will be formatted according to the specified format string into the output stream provided.

# Examples

Basic usage:

    use std::fmt;

    let mut output = String::new();
    fmt::write(&mut output, format_args!("Hello {}!", "world"))
        .expect("Error occurred while trying to write in String");
    assert_eq!(output, "Hello world!");

Please note that using `write!` might be preferable. Example:

    use std::fmt::Write;

    let mut output = String::new();
    write!(&mut output, "Hello {}!", "world")
        .expect("Error occurred while trying to write in String");
    assert_eq!(output, "Hello world!");