2.3.1.11 Exit Testlist (@X)

The Exit Testlist command allows the programmer to stop the testlist programatically, before the end of the testlistlist is reached. This command is useful if there is some criterion the subject has met (or not met) and the test can then be concluded.

Name:

Exit Testlist

Class:

Control

Code:

@X

Syntax:

@X

System:

Terminates the testlist. A '@9999' is outputted to the testlist before the 'END' end-of-testlist marker is outputted. The testlist generator needs to put out a #S/.../ to tell stat to ignore the key/time '@9999' combination.

History:

Introduced in Cogsys 4.

Test File:

ATX_T01.IN: Tests basic operation

@C Testing the "Exit Testlist" function \@X#W2000 Press any key.#R The testlist will end in 5 seconds...#W5000 #S/123456789/ @X You should not see this text, or wait for this key press: #R

Example:

input

Exiting cogsys in 2 seconds#W2000#S/0000/@X

cogsys

Waits 2 seconds, then writes '0000' to output and then writes '@9999' to output. The testlist then comes to an end.