Constructor.

Constructor.

Constructor.

Closes the console and frees any resources acquired.

Gets the console.

Ends the current set of tests.

If this set of tests is not nested within another set, then a message reporting success is written to the console.

Gets an input key stroke.

Prints a failure message, including an error code at the console and raises a panic.

Prints a failure message indicating that a comparison between two values (also printed) resulted in EFalse, at the console and raises a panic.

Prints a failure message indicating that two value (also printed) where not equal, at the console and raises a panic.

Prints a failure message indicating null was encountered, at the console and raises a panic.

Prints a failure message indicating that aValue was not an expected value, at the console and raises a panic.

Tests whether the logging flag is set.

If the logging flag is set, console output is also written to the debug output as represented by a RDebug object.

Marks the start of the next test.

RTest::Start()

Prints an error message and an error code, and raises a USER 84 panic.

Prints an error message, and raises a USER 84 panic.

Prints text to the console.

If the logging flag is set, the string is also written to the debug output as represented by an RDebug object.

RTest::SetLogged() Rtest::Logged() RDebug

Sets the console.

Sets the logging flag.

If the logging flag is set, console output is also written to the debug output as represented by a RDebug object.

Marks the start of a set of tests.

Note that sets of tests can be nested.

A call to this function must be matched by a call to RTest::End() to mark the end of this set of tests.

RTest::End()

Utility function that returns a pointer to the specified TText8* argument or the TText16* argument depending on the value of the aSel argument.

Prints out the console title and version number.

The format of the text is:

         RTEST TITLE: XXX YYY
Epoc/32 YYY
        

where XXX is the console title, and YYY is the version number, formatted as described by TVersion::Name() .

TVersion::Name() RTest::Printf()

Checks the result of a condition and, if this is false, prints a failure message at the console and raises a panic.

Before checking the condition passed in, the operator increments a check number. This is a value that is set to zero at the start of a test and is incremented by this operator (and by all variants of it). It identifies the check being made within the current test. This value is printed on a failure message.

Typically, the operator is called, passing a test condition, for example:

         RTest test(... heading text...,line number... file name)
TInt r;
...some operation to be tested that returns a value in r...
test(r==KErrNone);
        

The failure message has the format:

         : FAIL : XXX failed check N in FFF at line Number: M
RTEST: Checkpoint-fail
        

where XXX is the console title, N is the check number, FFF is the filename, and M is the line number passed in.

Checks the result of a condition and, if this is false, prints a failure message at the console and raises a panic.

Before checking the condition passed in, the operator increments a check number. This is a value that is set to zero at the start of a test and is incremented by this operator (and by all variants of it). It identifies the check being made within the current test. This value is printed on the failure message.

Typically, the operator is called, passing a test condition, for example:

         RTest test(... heading text...,line number)
TInt r;
...some operation to be tested that returns a value in r...
test(r==KErrNone);
        

The failure message has the format:

         : FAIL : XXX failed check N at line Number: M
RTEST: Checkpoint-fail
        

where XXX is the console title, N is the check number, and M is the line number passed in.

Checks the result of a condition and, if this is false, prints a failure message at the console and raises a panic.

Before checking the condition passed in, the operator increments a check number. This is a value that is set to zero at the start of a test and is incremented by this operator (and by all variants of it). It identifies the check being made within the current test. This value is printed on the failure message.

Typically, the operator is called, passing a test condition, for example:

         RTest test(... heading text...)
TInt r;
...some operation to be tested that returns a value in r...
test(r==KErrNone);
        

The failure message has the format:

         : FAIL : XXX failed check N
RTEST: Checkpoint-fail
        

where XXX is the console title, and N is the check number.