// NOTE: Exporting macros in Rust is a bit weird. `#[macro_export]` causes them to be exported to // the crate root, but that makes it difficult to include just the macros without using // `#[macro_use] extern crate nih_plug;`. That's why the macros are also re-exported from this // module. /// Write something to the logger. This defaults to STDERR unless the user is running Windows and a /// debugger has been attached, in which case `OutputDebugString()` will be used instead. /// /// The logger's behavior can be controlled by setting the `NIH_LOG` environment variable to: /// /// - `stderr`, in which case the log output always gets written to STDERR. /// - `windbg` (only on Windows), in which case the output always gets logged using /// `OutputDebugString()`. /// - A file path, in which case the output gets appended to the end of that file which will be /// created if necessary. #[macro_export] macro_rules! nih_log { ($($args:tt)*) => ( $crate::log::info!($($args)*) ); } pub use nih_log; /// Similar to `nih_log!()`, more scream-y. Used for printing fatal errors. #[macro_export] macro_rules! nih_error { ($($args:tt)*) => ( $crate::log::error!($($args)*) ); } pub use nih_error; /// The same as `nih_log!()`, but with source and thread information. Like the /// `nih_debug_assert*!()` macros, this is only shown when compiling in debug mode. #[macro_export] macro_rules! nih_trace { ($($args:tt)*) => ( $crate::util::permit_alloc(|| $crate::log::trace!($($args)*)) ); } pub use nih_trace; /// Analogues to the `dbg!()` macro, but respecting the `NIH_LOG` environment variable and with all /// of the same logging features as the other `nih_*!()` macros. Like the `nih_debug_assert*!()` /// macros, this is only shown when compiling in debug mode, but the macro will still return the /// value in non-debug modes. #[macro_export] macro_rules! nih_dbg { () => { $crate::util::permit_alloc(|| $crate::log::debug!("")); }; ($val:expr $(,)?) => { // Match here acts as a let-binding: https://stackoverflow.com/questions/48732263/why-is-rusts-assert-eq-implemented-using-a-match/48732525#48732525 match $val { tmp => { $crate::util::permit_alloc(|| $crate::log::debug!("{} = {:#?}", stringify!($val), &tmp)); tmp } } }; ($($val:expr),+ $(,)?) => { ($($crate::nih_dbg!($val)),+,) }; } pub use nih_dbg; /// A `debug_assert!()` analogue that prints the error with line number information instead of /// panicking. /// /// TODO: Detect if we're running under a debugger, and trigger a break if we are #[macro_export] macro_rules! nih_debug_assert { ($cond:expr $(,)?) => ( #[allow(clippy::neg_cmp_op_on_partial_ord)] if cfg!(debug_assertions) && !$cond { $crate::util::permit_alloc(|| $crate::log::debug!(concat!("Debug assertion failed: ", stringify!($cond)))); } ); ($cond:expr, $format:expr $(, $($args:tt)*)?) => ( #[allow(clippy::neg_cmp_op_on_partial_ord)] if cfg!(debug_assertions) && !$cond { $crate::util::permit_alloc(|| $crate::log::debug!(concat!("Debug assertion failed: ", stringify!($cond), ", ", $format), $($($args)*)?)); } ); } pub use nih_debug_assert; /// An unconditional debug assertion failure, for if the condition has already been checked /// elsewhere. #[macro_export] macro_rules! nih_debug_assert_failure { () => ( if cfg!(debug_assertions) { $crate::util::permit_alloc(|| $crate::log::debug!("Debug assertion failed")); } ); ($format:expr $(, $($args:tt)*)?) => ( if cfg!(debug_assertions) { $crate::util::permit_alloc(|| $crate::log::debug!(concat!("Debug assertion failed: ", $format), $($($args)*)?)); } ); } pub use nih_debug_assert_failure; /// A `debug_assert_eq!()` analogue that prints the error with line number information instead of /// panicking. #[macro_export] macro_rules! nih_debug_assert_eq { ($left:expr, $right:expr $(,)?) => ( if cfg!(debug_assertions) && $left != $right { $crate::util::permit_alloc(|| $crate::log::debug!(concat!("Debug assertion failed: ", stringify!($left), " != ", stringify!($right)))); } ); ($left:expr, $right:expr, $format:expr $(, $($args:tt)*)?) => ( if cfg!(debug_assertions) && $left != $right { $crate::util::permit_alloc(|| $crate::log::debug!(concat!("Debug assertion failed: ", stringify!($left), " != ", stringify!($right), ", ", $format), $($($args)*)?)); } ); } pub use nih_debug_assert_eq; /// A `debug_assert_ne!()` analogue that prints the error with line number information instead of /// panicking. #[macro_export] macro_rules! nih_debug_assert_ne { ($left:expr, $right:expr $(,)?) => ( if cfg!(debug_assertions) && $left == $right { $crate::util::permit_alloc(|| $crate::log::debug!(concat!("Debug assertion failed: ", stringify!($left), " == ", stringify!($right)))); } ); ($left:expr, $right:expr, $format:expr $(, $($args:tt)*)?) => ( if cfg!(debug_assertions) && $left == $right { $crate::util::permit_alloc(|| $crate::log::debug!(concat!("Debug assertion failed: ", stringify!($left), " == ", stringify!($right), ", ", $format), $($($args)*)?)); } ); } pub use nih_debug_assert_ne;