BullseyeCoverage Up Contents Search

cov_check - Check Memory Data Structures 

int cov_check(void);

Description

Function cov_check verifies the integrity of data structures in memory for the current process. Measurements are unaffected. This function does not clear the run-time error status.

This function is automatically declared in source files compiled by covc. In other source files, declare it by including <BullseyeCoverage.h>.

Return Value

If successful, cov_check returns the negative number of object files checked. Otherwise, it returns one of the error codes listed in Run-Time Errors.

Examples

#if _BullseyeCoverage
    int e = cov_check();
    if (e > 0) {
        fprintf(stderr, "%s %u cov_check %d\n", __FILE__, __LINE__, e);
    }
#endif

Notes

Each dynamic link library (DLL) is considered a separate process. Calling this function from inside a DLL only affects the coverage data in that DLL and does not affect coverage data in programs which call the DLL or other DLLs.

Updated: 26 Aug 2020