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

Syntax: N_RESTGETS(<memvar>)

Restore `Get' list from memory variable created by N_SAVEGETS.

Example

@ 1,0 SAY "City:" GET M->city
@ 2,0 SAY "State:" GET M->state VALID STATE->(STATE())
READ
 ...
FUNCTION STATE
SEEK M->STATE
IF .NOT. FOUND()
  gets = N_SAVEGETS()
  APPEND BLANK
  @ 4,0 SAY "Enter new state"
  READ
  N_RESTGETS(gets)
ENDIF
RETURN .T.

Notes

N_RESTGETS should be issued after a lower level read is completed and before
returning to the higher level read.  If the lower level read was `READ SAVE'
then you should issue `CLEAR GETS' prior to N_RESTGETS.

A lower level read may modify fields and memory variables in use by a higher
level read, however a lower level read must not release any memory variables
is use by a higher level read.

N_RESTGETS can be used inside any VALID, HELP, or SET KEY procedure.  It
cannot be used inside of an event procedure.

If any fields in the higher level read are changed in the lower level read,
then your program should issue N_REGET() after N_RESTGETS to redisplay the
fields.  Exception: Clipper will automatically redisplay the field under the
cursor when the program returns to the higher level read.

N_RESTGETS does not restore screen contents, which must be restored with the
Clipper command RESTORE SCREEN.