home *** CD-ROM | disk | FTP | other *** search
/ Nebula / nebula.bin / SourceCode / libcs / gethex.c < prev    next >
C/C++ Source or Header  |  1990-12-11  |  4KB  |  113 lines

  1. /*
  2.  * Copyright (c) 1990 Carnegie Mellon University
  3.  * All Rights Reserved.
  4.  * 
  5.  * Permission to use, copy, modify and distribute this software and its
  6.  * documentation is hereby granted, provided that both the copyright
  7.  * notice and this permission notice appear in all copies of the
  8.  * software, derivative works or modified versions, and any portions
  9.  * thereof, and that both notices appear in supporting documentation.
  10.  *
  11.  * THE SOFTWARE IS PROVIDED "AS IS" AND CARNEGIE MELLON UNIVERSITY
  12.  * DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
  13.  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.  IN NO EVENT
  14.  * SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE FOR ANY SPECIAL, DIRECT,
  15.  * INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
  16.  * RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
  17.  * CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  18.  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  19.  *
  20.  * Users of this software agree to return to Carnegie Mellon any
  21.  * improvements or extensions that they make and grant Carnegie the
  22.  * rights to redistribute these changes.
  23.  *
  24.  * Export of this software is permitted only after complying with the
  25.  * regulations of the U.S. Deptartment of Commerce relating to the
  26.  * Export of Technical Data.
  27.  */
  28. /*  gethex --  prompt user for hexadecimal integer
  29.  *
  30.  *  Usage:  i = gethex (prompt,min,max,defalt)
  31.  *    unsigned int i,min,max,defalt;
  32.  *    char *prompt;
  33.  *
  34.  *  Gethex prints the message:  prompt  (min to max, hexadecimal)  [defalt]
  35.  *  and accepts a line of input from the user.  If the input
  36.  *  is not null or numeric, an error message is printed; otherwise,
  37.  *  the value is converted to an hexadecimal integer (or the value "defalt" is
  38.  *  substituted if the input is null).  Then, the value is
  39.  *  checked to ensure that is lies within the range "min" to "max".
  40.  *  If it does not, an error message is printed.  As long as
  41.  *  errors occur, the cycle is repeated; when a legal value is
  42.  *  entered, this value is returned by gethex.
  43.  *  On error or EOF in the standard input, the default is returned.
  44.  *
  45.  *  HISTORY
  46.  * $Log:    gethex.c,v $
  47.  * Revision 1.2  90/12/11  17:54:22  mja
  48.  *     Add copyright/disclaimer for distribution.
  49.  * 
  50.  * 28-Apr-85  Steven Shafer (sas) at Carnegie-Mellon University
  51.  *    Modified for 4.2 BSD.  Now uses stderr for output.
  52.  *
  53.  * 23-Oct-82  Steven Shafer (sas) at Carnegie-Mellon University
  54.  *    Added code to return default on error or EOF in standard input.
  55.  *
  56.  * 20-Nov-79  Steven Shafer (sas) at Carnegie-Mellon University
  57.  *    Created for VAX.
  58.  *
  59.  */
  60.  
  61. #include <stdio.h>
  62. #include <ctype.h>
  63.  
  64. unsigned int atoh();
  65.  
  66. unsigned int gethex (prompt,min,max,defalt)
  67. unsigned int min,max,defalt;
  68. char *prompt;
  69. {
  70.     char input [200];
  71.     register char *p;
  72.     register unsigned int i;
  73.     register int err;
  74.  
  75.     fflush (stdout);
  76.     do {
  77.  
  78.         fprintf (stderr,"%s  (%s%x to %s%x, hexadecimal)  [%s%x]  ",
  79.             prompt,(min ? "0x" : ""),min,
  80.             (max ? "0x" : ""),max,(defalt ? "0x" : ""),defalt);
  81.         fflush (stderr);
  82.  
  83.         if (gets (input) == NULL) {
  84.             i = defalt;
  85.             err = (i < min || max < i);
  86.         }
  87.         else {
  88.             err = 0;
  89.             if (input[0]=='0' && (input[1]=='x' || input[1]=='X'))
  90.                 strcpy (input,input+2);
  91.             for (p=input; *p && ((*p>='0' && *p<='9') ||
  92.                 (*p>='a' && *p<='f') || (*p>='A' && *p<='F'));
  93.                 p++) ;
  94.             if (*p) {        /* non-numeric */
  95.                 err = 1;
  96.             } 
  97.             else {
  98.                 if (*input)    i = atoh (input);
  99.                 else        i = defalt;
  100.                 err = (i < min || max < i);
  101.             }
  102.         }
  103.  
  104.         if (err) {
  105.             fprintf (stderr,"Must be an unsigned hexadecimal number between %s%x and %s%x\n",
  106.             (min ? "0x" : ""),min,(max ? "0x" : ""),max);
  107.         }
  108.     } 
  109.     while (err);
  110.  
  111.     return (i);
  112. }
  113.