Click above to get retro games delivered to your door ever month!

 DEBUG FUNCTIONS

 The Debug category consists of the ClipOn debugging functions.  The
 Debug functions can be used directly in a Clipper program but were
 designed to be used with Clipper's debugger.  The debugger provides
 many useful features, however, it can not perform database
 operations that are helpful while debugging a program.  For
 example, a program that is adding records to a database can be
 checked to be sure that each field is being replaced correctly.
 The ClipOn functions SELECT(), SKIP(), GO(), SEEK(), or LOCATE()
 can be used to position at the correct record and the VIEW()
 function can be used to display all of the fields in the database.

 Many of the Debug functions are the same as the Clipper command
 with the same name (e.g. SKIP).  However, most of the functions also
 have additional options to perform other useful tasks.

 The ClipOn Debug functions can be executed in the Clipper debugger
 by typing in the name of the function (with the parenthesis) and
 any needed parameters.  The function will perform it's task and any
 output or return value will be displayed on the screen.

 CLIPPER SUMMER '87
 In the Clipper Summer '87 version, use the Clipper debugger menu
 option DISPLAY/ EXPRESSION to execute the ClipOn Debug functions.
 The ClipOn function name is entered in the "Expression" prompt and
 the function return value, if any, is displayed in the "Value" area
 in the Expression window.

 CLIPPER 5.0
 In the Clipper 5.0 version, use the Clipper debugger "command"
 window (the window where the cursor is positioned when the debugger
 is entered) to execute the ClipOn Debug functions.  The ClipOn
 function name is entered on the command line, in the command
 window, prefixed by a question mark (i.e. ? go(5) ) and the
 function return value, if any, is displayed on the next line in the
 window, below the function name entered.

 NOTE: The ClipOn Debug functions are contained in a separate object
 file called CLIPBUG.OBJ.  This object file must be included in the
 link file separately, as an object file, to ensure that it is
 linked into the program.  In overlaid programs, CLIPBUG.OBJ must be
 specified in the root segment and not in an overlay segment.  Refer
 to Chapter 2, Using ClipOn/Linking, for an example of how to link
 CLIPBUG.OBJ.  For convenience, all of the ClipOn Debug functions
 are located together in Chapter 5, separate from the other ClipOn
 functions.

 VIEW()                   VAR()
 ARR()                    REINDEX()
 SKIP()                   ZAP()
 GO()                     COUNT()
 SELECT()                 STAT()
 CLOSE()                  REC()
 USE()                    END()
 SETORDER()               TOP()
 DEL()                    FND()
 UNDEL()                  SEEK()
 LOCATE()                 PACK()
 CONTINUE() / CONT()
.