zsh 0.8.13

Zsh interpreter and parser in Rust
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
50
51
52
53
54
55
56
57
58
59

// Support for printf-style formatting.
#[macro_export]
macro_rules! sprintf {
    // Allow a `&str` or `&Utf32Str` as a format, and return a `Utf32String`.
    ($fmt:expr $(, $arg:expr)* $(,)?) => {
        {
            let mut target = fish_widestring::WString::new();
            $crate::sprintf!(=> &mut target, $fmt, $($arg),*);
            target
        }
    };

    // Allow a `&str` or `&Utf32Str` as a format, and write to a target,
    // which should be a `&mut String` or `&mut Utf32String`.
    //
    (=> $target:expr, $fmt:expr $(, $arg:expr)* $(,)?) => {
        {
            let _ = fish_printf::sprintf!(=> $target, $fmt, $($arg),*);
        }
    };
}

#[macro_export]
macro_rules! fprintf {
    // Allow a `&str` or `&Utf32Str` as a format, and write to an fd.
    ($fd:expr, $fmt:expr $(, $arg:expr)* $(,)?) => {
        {
            let wide = $crate::wutil::sprintf!($fmt, $( $arg ),*);
            $crate::wutil::unescape_bytes_and_write_to_fd(&wide, $fd);
        }
    }
}

#[macro_export]
macro_rules! printf {
    // Allow a `&str` or `&Utf32Str` as a format, and write to stdout.
    ($fmt:expr $(, $arg:expr)* $(,)?) => {
        $crate::fprintf!(libc::STDOUT_FILENO, $fmt $(, $arg)*)
    }
}

#[macro_export]
macro_rules! eprintf {
    // Allow a `&str` or `&Utf32Str` as a format, and write to stderr.
    ($fmt:expr $(, $arg:expr)* $(,)?) => {
        fprintf!(libc::STDERR_FILENO, $fmt $(, $arg)*)
    }
}

pub use {eprintf, fprintf, printf, sprintf};

#[cfg(test)]
mod tests {
    // Test basic sprintf with both literals and wide strings.
    #[test]
    fn test_sprintf() {
        assert_eq!(sprintf!("Hello, %s!", "world"), "Hello, world!");
    }
}