forked from mirror/async-std
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
44 lines
1.1 KiB
Rust
44 lines
1.1 KiB
Rust
5 years ago
|
/// 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()`][flush] to ensure the output is emitted
|
||
|
/// immediately.
|
||
|
///
|
||
|
/// Use `print!` only for the primary output of your program. Use
|
||
|
/// [`eprint!`] instead to print error and progress messages.
|
||
|
///
|
||
|
/// [`println!`]: macro.println.html
|
||
|
/// [flush]: io/trait.Write.html#tymethod.flush
|
||
|
/// [`eprint!`]: macro.eprint.html
|
||
|
///
|
||
|
/// # Panics
|
||
|
///
|
||
|
/// Panics if writing to `io::stdout()` fails.
|
||
|
///
|
||
|
/// # 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();
|
||
|
/// ```
|
||
|
#[macro_export]
|
||
|
macro_rules! print {
|
||
|
($($arg:tt)*) => ($crate::io::_print(format_args!($($arg)*)));
|
||
|
}
|