# Macro std::print

1.0.0 · source ·

    macro_rules! print {
        ($($arg:tt)*) => { ... };
    }

Expand description

Prints to the standard output.

Equivalent to the `println!` macro except that a newline is not printed at the end of the message.

Note that stdout is frequently line-buffered by default so it may be necessary to use `io::stdout().flush()` to ensure the output is emitted immediately.

The `print!` macro will lock the standard output on each call. If you call `print!` within a hot loop, this behavior may be the bottleneck of the loop. To avoid this, lock stdout with `io::stdout().lock()`:

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

    let mut lock = stdout().lock();
    write!(lock, "hello world").unwrap();

Run

Use `print!` only for the primary output of your program. Use `eprint!` instead to print error and progress messages.

See the formatting documentation in `std::fmt` for details of the macro argument syntax.

## Panics

Panics if writing to `io::stdout()` fails.

Writing to non-blocking stdout can cause an error, which will lead this macro to panic.

## Examples

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

    print!("this ");
    print!("will ");
    print!("be ");
    print!("on ");
    print!("the ");
    print!("same ");
    print!("line ");

    io::stdout().flush().unwrap();

    print!("this string has a newline, why not choose println! instead?\n");

    io::stdout().flush().unwrap();

Run