View source for RESTGETS()

==Purpose==
Restore status of previously saved GETS


==Syntax==
RESTGETS(<expC>)


==See Also==
[[@...GET]], [[CLEAR GETS]], [[FMT()]], [[READ]], [[RESTORE GETS]], [[RESTORE SCREEN]], [[SAVE GETS]], [[SAVEGETS()]], [[SAVE SCREEN]]


==Description==
The RESTGETS() function lets you restore the GETS previously saved by the SAVEGETS() function. The <expC> is the name of the variable to which the return value of SAVEGETS() was stored.


==Example==
<code lang="recital">
// Set up validation procedure
procedure checkit
  parameters check
  save screen
  // Specify SAVEGETS() and CLEAR GETS before @...gets
  m_save=savegets()
  clear gets
  @0,1 get field4
  // Activate gets in validation procedure
  read
  // Reactivate reads in main screen form
  if not empty(field4)
      set validate on
  endif
  restgets(m_save)
  restore screen
return

clear
@1,1 get field1
@2,1 get field2 when field1="g"
@3,1 get field3 validate with checkit
read

</code>


==Products==
Recital 
[[Category:Documentation]]
[[Category:Functions]]