Macro googletest::expect_that

macro_rules! expect_that {
    ($actual:expr, $expected:expr $(,)?) => { ... };
    ($actual:expr, $expected:expr, $($format_args:expr),* $(,)?) => { ... };
}

Matches the given value against the given matcher, marking the test as failed but continuing execution if it does not match.

This is a non-fatal assertion: the test continues execution in the event of assertion failure.

This can only be invoked inside tests with the googletest::test attribute. The assertion must occur in the same thread as that running the test itself.

Invoking this macro is equivalent to using and_log_failure as follows:

verify_that!(actual, expected).and_log_failure()

One may optionally add arguments which will be formatted and appended to a failure message. For example:

let value = 2;
let extra_information = "Some additional information";
expect_that!(value, eq(3), "Test failed. Extra information: {extra_information}.");

This is output as follows:

Value of: value
Expected: is equal to 3
Actual: 2,
  which isn't equal to 3
  at ...
Test failed. Extra information: Some additional information.