Mac Dev Center Mac OS X Reference Library IDEs CPlusTest Reference

Overview

Exception that represents the failure of a unit test.

Discussion

A TestFailure is an exception that represents the failure of a unit test and records the file and line number of the failure along with a message describing the failure. While this class does not descend from std::exception it may be thrown.

Functions

file

Gets the source file in which the failure occurred.

line

Gets the line in the source file on which the failure occurred.

message

Gets informative text describing the failure.

TestFailure

Constructor for the TestFailure exception.

~TestFailure

Destructor for the TestFailure exception.

Gets the source file in which the failure occurred.

public

const std::string& file() const throw(); 

Return Value

The source file in which the failure occurred.

Discussion

Gets the source file in which the failure occurred.

Gets the line in the source file on which the failure occurred.

public

const unsigned int line() const throw(); 

Return Value

The line in the source file on which the failure occurred.

Discussion

Gets the line in the source file on which the failure occurred.

Gets informative text describing the failure.

public

const std::string& message() const throw(); 

Return Value

Informative text describing the failure.

Discussion

Gets informative text describing the failure.

Constructor for the TestFailure exception.

public

TestFailure(
    const std::string& file,
    const unsigned int line,
    const std::string& message) throw(); 

Parameters

Discussion

Constructor for the TestFailure exception.

Destructor for the TestFailure exception.

public

virtual ~TestFailure() throw(); 

Discussion

Destructor for the TestFailure exception.