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

SAVE SCREEN


Syntax:     SAVE SCREEN [TO <memvar>]

Purpose:    To SAVE the current SCREEN to a buffer or optional memory
            variable.

Options:    To: The TO clause specifies a memory variable to SAVE
            the current SCREEN.  The variable created is character type
            and the length of the screen is 4000 bytes.

Usage:      Multiple screens may be saved by assigning each screen to a
            memory variable.  SAVE SCREEN is used in conjunction with
            RESTORE SCREEN to eliminate the need to repaint an original
            screen that has been temporarily replaced.

            In addition to ordinary memory variables, you can also SAVE
            SCREENs to array elements making screen management easier.
            Note, however, you cannot SAVE arrays to (.mem) files in
            order to SAVE multiple screens to disk.

            Warning: SAVE SCREEN, RESTORE SCREEN, SAVESCREEN(), and
            RESTSCREEN() are not supported when either ANSI.OBJ or
            IBMANSI.OBJ is linked into the current program.

Library:    CLIPPER.LIB


----------------------------------- Example --------------------------------

   DECLARE screens[10]
   SAVE SCREEN TO screens[1]
   *
   <statements>...
   *
   RESTORE SCREEN FROM screens[1]