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
|
//! Macros for string formatting.
/// Conditionally perform string formatting.
///
/// If `$enabled` is true, then do the formatting and return a `Cow::Owned`.
///
/// Otherwise, just return the borrowed (often `'static`) string
/// `$borrowed`.
///
/// When `$enabled` is false, this avoids the overhead of allocating
/// and writing to a buffer, as well as any overhead or side effects
/// of the format arguments.
///
/// # Example
///
/// You can use `format_if` to implement a detailed error logging facility
/// that can be enabled at runtime.
///
/// ```
/// # #[macro_use] extern crate mac;
/// # use std::borrow::Cow::{Borrowed, Owned};
/// # fn main() {
/// let formatted = format_if!(true, "Vague error", "Error code {:?}", 3);
///
/// assert_eq!(&formatted[..], "Error code 3");
/// if let Borrowed(_) = formatted {
/// panic!("Wrong!")
/// }
///
/// let not_formatted = format_if!(false, "Vague error", "Error code {:?}", {
/// // Note that the argument is not evaluated.
/// panic!("oops");
/// });
///
/// assert_eq!(¬_formatted[..], "Vague error");
/// if let Owned(_) = not_formatted {
/// panic!("Wrong!")
/// }
/// # }
/// ```
#[macro_export]
macro_rules! format_if {
($enabled:expr, $borrowed:expr, $fmt:expr, $($args:expr),*) => {
if $enabled {
::std::borrow::Cow::Owned(format!($fmt, $($args),*)) as ::std::borrow::Cow<str>
} else {
::std::borrow::Cow::Borrowed($borrowed)
}
}
}
|