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

READVAR()

Return variable name of current GET or MENU
---------------------------------------------------------------------------------

 Syntax

        READVAR( [<cVarName>] ) --> cOldVarName  

 Arguments

        <cVarName>   is a new variable name to set.    

 Returns

        READVAR()   return the old variable name. If no variable 
                  previously was set, READVAR() return "".

 Description

      READVAR() is set inside a READ or MENU TO command to hold the
      uppercase name of the GET / MENU TO variable, and re-set back to
      old  value when those commands finished. You should not normally set
      a  variable name but rather use it to retrieve the name of a GET
      variable when executing a VALID or WHEN clause, or during SET KEY
      execution and you are inside a READ or MENU TO.

 Examples

      // display a menu, press F1 to view the MENU TO variable name
      CLS
      @ 1, 10 PROMPT "blood sucking insect that infect beds   "
      @ 2, 10 PROMPT "germ; virus infection                   "
      @ 3, 10 PROMPT "defect; snag; (source of) malfunctioning"
      @ 4, 10 PROMPT "small hidden microphone                 "
      @ 6, 10 SAY "(Press F1 for a hint)"
      SET KEY 28 TO ShowVar
      MENU TO What_Is_Bug

      PROCEDURE ShowVar
      ALERT( READVAR() )        // WHAT_IS_BUG in red ALERT() box
      

Status

      Ready

 Compliance

      READVAR() works exactly like CA-Clipper's READKEY(), note however,
      that the <cVarName> parameter is not documented and used internally
      by CA-Clipper.

 Platforms

      All

 Files

      Library is rtl