Return whether a caught assertion failure matches the expected probe.

Synopsis

Declared in <bsls_asserttest.h>

static
bool
catchProbe(
    char expectedResult,
    bool checkLevel,
    char expectedLevel,
    AssertTestException const& caughtException,
    char const* testDriverFileName);

Description

Return true if the specified expectedResult is F (for Fail), the specified checkLevel flag is false or the expectedLevel is as wide or wider than the actual assertion failure level, the specified caughtException contains valid fields, and the specified testDriverFileName is either null or refers to the same (valid) component name as the filename in caughtException; otherwise, return false. If expectedResult, testDriverFileName, or any field of caughtException is invalid (i.e., an invalid filename, null or empty expression text, or a non‐positive line number), this function reports the invalid value(s) to stdout before returning false. If testDriverFileName is not null, but does not reflect the same component name as the otherwise valid filename in caughtException, this function prints a message delineating the mismatching deduced component names to stdout before returning false.

Return Value

true if the failure probe matches, else false

Parameters

Name

Description

expectedResult

expected outcome (P for pass, F for fail)

checkLevel

whether to compare assertion levels

expectedLevel

expected assertion level (S, A, O, or I)

caughtException

exception thrown by the assertion handler

testDriverFileName

test‐driver file, or null to skip origination

Created with MrDocs