DISPLAY COVERAGE
Displays the contents of a coverage file in the results pane of the Command window.
Syntax
DISPLAY COVERAGE <filename1> | ? | <filename skeleton 1>
[ALL]
[SUMMARY]
[TO FILE <filename2> | ? | <filename skeleton 2>]
[TO PRINTER]
<filename1> | ? | <filename skeleton 1>
The coverage file for the desired program. The ? and <filename skeleton 1> options display a dialog box from which you can select a coverage file. If you specify a file without including its path, dBASE Plus looks for the file in the current directory, then in the path you specify with SET PATH. If you specify a file without including its extension, dBASE Plus assumes .COV.
ALL
Includes the coverage files, if any, for all other program files that could be called by the main program file, adding to the display:
The total number of logical blocks exercised in all the program files combined
The percentage of logical blocks exercised in all the program files combined
SUMMARY
Excludes the logical blocks that were exercised. Without SUMMARY, both the logical blocks that were exercised, and the logical blocks not exercised are displayed. Use the SUMMARY option to find code that still needs to be exercised.
TO FILE <filename2> | ? | <filename skeleton 2>
Directs output to <filename2> in addition to the results pane of the Command window. By default, dBASE Plus assigns a .TXT extension to <filename2> and saves the file in the current directory. The ? and <filename skeleton 2> options display a dialog box in which you specify the name of the target file and the directory to save it in.
TO PRINTER
Directs output to the printer in addition to the results pane of the Command window.
Description
A coverage file contains the results of the coverage analysis of a program file. You cause dBASE Plus to analyze the execution of any code in a program file by compiling the program file with coverage, either by having SET COVERAGE ON when the program is compiled, or with the #pragma coverage(on) directive in the program file. A coverage file is created whenever any code in the program file is executed.
The coverage file has the same name as the program file, and changes the last letter of the extension to the letter "V"; unless the file is a .PRG, in which case the coverage file has an extension of .COV. For example, the coverage file for GRADES.PRG is GRADES.COV, and the coverage file for STUDENTS.WFM is STUDENTS.WFV.
The coverage file accumulates statistics whenever any code in the program file is executed. You will usually want to make sure that all logical blocks in your code have been exercised. You may erase the coverage file to restart the coverage analysis totals.
DISPLAY COVERAGE displays the results of the coverage analysis:
Each logical block, and how many times it was exercised
The total number of blocks, and the number of blocks that were tested
The percentage of blocks tested
DISPLAY COVERAGE pauses when the results pane is full and displays a dialog box prompting you to display another screenful of information. Use the TO FILE clause to send the information to a file. Use the TO PRINTER clause to send the information to the printer. In either case, you can use SET CONSOLE OFF to suppress the display of the information in the results pane.
DISPLAY COVERAGE is the same as LIST COVERAGE, except that LIST COVERAGE does not pause with the first window of information but rather continuously lists the information until complete. This makes LIST COVERAGE more appropriate for outputting to a file or printer.