# 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

See Also

- @...GET
- @...PROMPT
- MENU TO
- READ
- SET KEY
- __AtPrompt()
- __MenuTo()