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 parameter is not documented and used internally by CA-Clipper.
- Platforms
- All
- Files
- Library is rtl
- See Also