custom-print 0.1.0

Define custom println and dbg macros in wasm and other targets
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

/// Defines a `print`-like macro with a given name that uses
/// specified write macro, error-handling policy and writer.
///
/// The writer itself is specified by the rest arguments with the [`define_writer`] macros.
///
/// # Examples
///
/// ```rust
/// let mut string = String::new();
/// custom_print::define_printlike!(cprintln, writeln, expect, fmt, |value: &str| string += value);
/// custom_print::define_printlike!(try_println, writeln, try, fmt, |value: &str| string += value);
///
/// assert_eq!(cprintln!("first"), ());
/// assert_eq!(string, "first\n");
/// assert_eq!(try_println!("second"), Ok(()));
/// assert_eq!(string, "first\nsecond\n");
/// ```
#[macro_export]
macro_rules! define_printlike {
    ( $name:ident, $macro:path, expect, $($args:tt)* ) => {
        $crate::_define_printlike_impl!(
            ($), $name, $macro, expect, $crate::define_writer!($($args)*)
        );
    };
    ( $name:ident, $macro:path, try, $($args:tt)* ) => {
        $crate::_define_printlike_impl!(
            ($), $name, $macro, try, $crate::define_try_writer!($($args)*)
        );
    };
}

#[doc(hidden)]
#[macro_export]
macro_rules! _define_printlike_impl {
    ( ($d:tt), $name:ident, $macro:path, $handler:tt, $writer:expr ) => {
        #[allow(unused_macros)]
        macro_rules! $name {
            // Dummy comment below is used to avoid rustfmt formatting bug.
            // Issue: https://github.com/rust-lang/rustfmt/issues/4609
            /* ================================================================================== */
            () => {
                $crate::write!($macro, $writer, $handler)
            };
            ($d ($d args:tt)+) => {
                $crate::write!($macro, $writer, $handler, $d ($d args)+)
            };
        }
    };
}