Updated libcore/macro.rs to note write macro can work in no_std setups

This commit is contained in:
MagnumOpus21
2018-08-11 14:43:50 -04:00
committed by Siva Prasad
parent b0297f3043
commit 2ae2c628ee

View File

@@ -349,6 +349,34 @@ macro_rules! try {
/// write!(&mut v, "s = {:?}", s).unwrap(); // uses io::Write::write_fmt
/// assert_eq!(v, b"s = \"abc 123\"");
/// ```
/// /// Note : This macro can be used in no_std setups as well
/// /// In a no_std setup you are responsible for the
/// /// implementation details of the components.
/// ```rust
/// extern crate core;
/// use core::fmt::Write;
/// #[derive(Debug)]
/// struct Greetings<'a>{
/// message : &'a str,
/// }
/// impl<'a> Write for Greetings<'a>{
/// fn write_str(&mut self, _s: &str) -> core::fmt::Result {
/// unimplemented!();
/// }
/// }
/// fn main(){
/// let mut m = Greetings{message: ""};
/// write!(&mut m, "Hello World").expect("Not written");
/// }
/// ```
#[macro_export]
#[stable(feature = "rust1", since = "1.0.0")]
macro_rules! write {