home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / ibm1 / do101j2.arj / GETC.SCR < prev    next >
Encoding:
Text File  |  1991-12-29  |  1.7 KB  |  42 lines
  1. .pg wi full clr cy
  2.     COMMAND NAME»gray«: »%t« GetChar »ye«
  3.  
  4.     /GETC[HARACTER] {Prompt} {List}[ {variable}][ LC]
  5. /cw
  6.     Gets a »ma«single character»#« from the user. The character must be
  7.     one of those in »cy«{List}»#«. Otherwise the command will continue
  8.     to prompt until one of the characters in »cy«{List}»#« is entered.
  9.  
  10.     »wh«{List}»#«         List of valid characters. (»wh«""»#« = ALL
  11.                    characters). The string must be enclosed in
  12.                    double quotes ("") if it is empty (all
  13.                    characters) or contains space or comma.
  14.     »wh«{Prompt}»#«       The prompt that is displayed for the user. It
  15.                    must be enclosed in quotes if it contains the
  16.                    parse parameter(s). Variables are expanded.
  17.     »wh«{variable}»#«     Optional token indicating the variable in
  18.                    which the character is to be stored.
  19.     »wh«LC»#«             Optional token which indicates that the
  20.                    response should be left as is. The default is
  21.                    to convert the response to upper case and to
  22.                    convert »cy«{List}»#« to upper case.
  23.  
  24. .pg clr
  25.     The character is stored in the system variable »ye«CHAR»#« if
  26.     »cy«{variable}»#« is not entered. You can access this variable once
  27.     the »%t«/GETC»#« command has been executed.
  28.  
  29. .pg clr
  30.  
  31.     Here is an example of a »%t«/GETC»#« command which prompts for the
  32.     a letter between "»ma«A»#«" and "»ma«C»#«".  Press »bo«<enter>»#« to
  33.     execute the command.
  34.  
  35. |/GETC "    Enter a letter between A-C:" ABC
  36.  
  37.     Your response is saved in the variable CHAR.
  38.  
  39. |    Your answer was:  »ye«%Char»#«
  40.  
  41. /ENDEXEC
  42.