home *** CD-ROM | disk | FTP | other *** search
/ ftp.update.uu.se / ftp.update.uu.se.2014.03.zip / ftp.update.uu.se / pub / rainbow / msdos / misc / reply.lzh / REPLY.DOC < prev   
Text File  |  1985-05-23  |  3KB  |  73 lines
  1.                                                                           Batch
  2.                                                                        Commands
  3.  
  4. REPLY Subcommand
  5.  
  6. Purpose:  Requests a user input and matches that reply against a list of valid
  7.           replies.  ERRORLEVEL is set depending upon the match.
  8.  
  9.               Note: This subcommand requires DOS 2 or later and will produce an
  10.               error if used with DOS 1.
  11.  
  12. Format:   REPLY[/U] [string]
  13.  
  14.           string         element [element ...]
  15.                          A string may contain at most 8 elements.
  16.  
  17.           element        any ASCII characters not including a space, the piping
  18.                          character, or the redirection characters.  The maximum
  19.                          length of an element is 64 characters.
  20.  
  21.               Note: elements must be separated by one or more blanks.  The
  22.               length of string is restricted by the limit of 127 characters for
  23.               any complete DOS command.
  24.  
  25. Type:     Internal    External
  26.                          ***
  27.  
  28. Remarks:  The /U parameter causes both the parameter string and the input reply
  29.           to be converted to upper case, thus making the match case
  30.           insensitive.
  31.  
  32.           The subcommand writes the output request for a reply to the standard
  33.           output device and accepts the input reply from the standard input
  34.           device.  These may be redirected or piped.  Error messages are
  35.           written to the standard error device.
  36.  
  37.           The subcommand sets the ERRORLEVEL exit code upon completion.  The
  38.           value depends upon the match between the input reply and the elements
  39.           of the parameter string.
  40.  
  41.               0 = no input reply entered
  42.               1 thru N = for a parameter string of N elements, the value set is
  43.                   the number of the element which the input reply exactly
  44.                   matches
  45.               N+1 = input reply does not exactly match any of the N elements in
  46.                   the parameter string
  47.  
  48.           The REPLY subcommand has two format options:
  49.  
  50.           Option 1 - No parameter string specified
  51.  
  52.           Use this option to request a reply to a Yes/No question.  The /U
  53.           parameter is automatically set if this option is chosen, and is
  54.           ignored if specified.  A default parameter string is constructed of
  55.           two elements in this order: Y N
  56.  
  57.               REPLY    is equivalent to   REPLY/U Y N
  58.  
  59.           Option 2 - Parameter string specified
  60.  
  61.           Use this option to request a reply from an arbitrary list of choices.
  62.  
  63. Example:      ECHO Do you wish to continue? (Y/N)
  64.               REPLY
  65.               IF ERRORLEVEL 3 GOTO bad
  66.               IF ERRORLEVEL 2 GOTO no
  67.               IF ERRORLEVEL 1 GOTO yes
  68.               REM This is the default action
  69.  
  70. -----------------------------------------------------------------------------
  71. Program REPLY, Copyright(C) October 1984, MJH Consulting.  Permission granted
  72. to copy for non-commercial uses only.  All other rights retained.
  73.