coregrind/m_demangle/safe-ctype.c

   1 /* <ctype.h> replacement macros.
   2
   3    Copyright (C) 2000-2022 Free Software Foundation, Inc.
   4    Contributed by Zack Weinberg <zackw@stanford.edu>.
   5
   6 This file is part of the libiberty library.
   7 Libiberty is free software; you can redistribute it and/or
   8 modify it under the terms of the GNU Library General Public
   9 License as published by the Free Software Foundation; either
  10 version 2 of the License, or (at your option) any later version.
  11
  12 Libiberty is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15 Library General Public License for more details.
  16
  17 You should have received a copy of the GNU Library General Public
  18 License along with libiberty; see the file COPYING.LIB.  If
  19 not, write to the Free Software Foundation, Inc., 51 Franklin Street - Fifth Floor,
  20 Boston, MA 02110-1301, USA.  */
  21
  22 /*
  23
  24 @defvr Extension HOST_CHARSET
  25 This macro indicates the basic character set and encoding used by the
  26 host: more precisely, the encoding used for character constants in
  27 preprocessor @samp{#if} statements (the C "execution character set").
  28 It is defined by @file{safe-ctype.h}, and will be an integer constant
  29 with one of the following values:
  30
  31 @ftable @code
  32 @item HOST_CHARSET_UNKNOWN
  33 The host character set is unknown - that is, not one of the next two
  34 possibilities.
  35
  36 @item HOST_CHARSET_ASCII
  37 The host character set is ASCII.
  38
  39 @item HOST_CHARSET_EBCDIC
  40 The host character set is some variant of EBCDIC.  (Only one of the
  41 nineteen EBCDIC varying characters is tested; exercise caution.)
  42 @end ftable
  43 @end defvr
  44
  45 @deffn  Extension ISALPHA  (@var{c})
  46 @deffnx Extension ISALNUM  (@var{c})
  47 @deffnx Extension ISBLANK  (@var{c})
  48 @deffnx Extension ISCNTRL  (@var{c})
  49 @deffnx Extension ISDIGIT  (@var{c})
  50 @deffnx Extension ISGRAPH  (@var{c})
  51 @deffnx Extension ISLOWER  (@var{c})
  52 @deffnx Extension ISPRINT  (@var{c})
  53 @deffnx Extension ISPUNCT  (@var{c})
  54 @deffnx Extension ISSPACE  (@var{c})
  55 @deffnx Extension ISUPPER  (@var{c})
  56 @deffnx Extension ISXDIGIT (@var{c})
  57
  58 These twelve macros are defined by @file{safe-ctype.h}.  Each has the
  59 same meaning as the corresponding macro (with name in lowercase)
  60 defined by the standard header @file{ctype.h}.  For example,
  61 @code{ISALPHA} returns true for alphabetic characters and false for
  62 others.  However, there are two differences between these macros and
  63 those provided by @file{ctype.h}:
  64
  65 @itemize @bullet
  66 @item These macros are guaranteed to have well-defined behavior for all
  67 values representable by @code{signed char} and @code{unsigned char}, and
  68 for @code{EOF}.
  69
  70 @item These macros ignore the current locale; they are true for these
  71 fixed sets of characters:
  72 @multitable {@code{XDIGIT}} {yada yada yada yada yada yada yada yada}
  73 @item @code{ALPHA}  @tab @kbd{A-Za-z}
  74 @item @code{ALNUM}  @tab @kbd{A-Za-z0-9}
  75 @item @code{BLANK}  @tab @kbd{space tab}
  76 @item @code{CNTRL}  @tab @code{!PRINT}
  77 @item @code{DIGIT}  @tab @kbd{0-9}
  78 @item @code{GRAPH}  @tab @code{ALNUM || PUNCT}
  79 @item @code{LOWER}  @tab @kbd{a-z}
  80 @item @code{PRINT}  @tab @code{GRAPH ||} @kbd{space}
  81 @item @code{PUNCT}  @tab @kbd{`~!@@#$%^&*()_-=+[@{]@}\|;:'",<.>/?}
  82 @item @code{SPACE}  @tab @kbd{space tab \n \r \f \v}
  83 @item @code{UPPER}  @tab @kbd{A-Z}
  84 @item @code{XDIGIT} @tab @kbd{0-9A-Fa-f}
  85 @end multitable
  86
  87 Note that, if the host character set is ASCII or a superset thereof,
  88 all these macros will return false for all values of @code{char} outside
  89 the range of 7-bit ASCII.  In particular, both ISPRINT and ISCNTRL return
  90 false for characters with numeric values from 128 to 255.
  91 @end itemize
  92 @end deffn
  93
  94 @deffn  Extension ISIDNUM         (@var{c})
  95 @deffnx Extension ISIDST          (@var{c})
  96 @deffnx Extension IS_VSPACE       (@var{c})
  97 @deffnx Extension IS_NVSPACE      (@var{c})
  98 @deffnx Extension IS_SPACE_OR_NUL (@var{c})
  99 @deffnx Extension IS_ISOBASIC     (@var{c})
 100 These six macros are defined by @file{safe-ctype.h} and provide
 101 additional character classes which are useful when doing lexical
 102 analysis of C or similar languages.  They are true for the following
 103 sets of characters:
 104
 105 @multitable {@code{SPACE_OR_NUL}} {yada yada yada yada yada yada yada yada}
 106 @item @code{IDNUM}        @tab @kbd{A-Za-z0-9_}
 107 @item @code{IDST}         @tab @kbd{A-Za-z_}
 108 @item @code{VSPACE}       @tab @kbd{\r \n}
 109 @item @code{NVSPACE}      @tab @kbd{space tab \f \v \0}
 110 @item @code{SPACE_OR_NUL} @tab @code{VSPACE || NVSPACE}
 111 @item @code{ISOBASIC}     @tab @code{VSPACE || NVSPACE || PRINT}
 112 @end multitable
 113 @end deffn
 114
 115 */
 116
 117 #if 0 /* in valgrind */
 118 #include "ansidecl.h"
 119 #include <safe-ctype.h>
 120 #include <stdio.h>  /* for EOF */
 121 #endif /* ! in valgrind */
 122
 123 #include "vg_libciface.h"
 124
 125 #include "safe-ctype.h"
 126
 127 #if EOF != -1
 128  #error "<safe-ctype.h> requires EOF == -1"
 129 #endif
 130
 131 /* Shorthand */
 132 #define bl _sch_isblank
 133 #define cn _sch_iscntrl
 134 #define di _sch_isdigit
 135 #define is _sch_isidst
 136 #define lo _sch_islower
 137 #define nv _sch_isnvsp
 138 #define pn _sch_ispunct
 139 #define pr _sch_isprint
 140 #define sp _sch_isspace
 141 #define up _sch_isupper
 142 #define vs _sch_isvsp
 143 #define xd _sch_isxdigit
 144
 145 /* Masks.  */
 146 #define L  (const unsigned short) (lo|is   |pr) /* lower case letter */
 147 #define XL (const unsigned short) (lo|is|xd|pr) /* lowercase hex digit */
 148 #define U  (const unsigned short) (up|is   |pr) /* upper case letter */
 149 #define XU (const unsigned short) (up|is|xd|pr) /* uppercase hex digit */
 150 #define D  (const unsigned short) (di   |xd|pr) /* decimal digit */
 151 #define P  (const unsigned short) (pn      |pr) /* punctuation */
 152 #define _  (const unsigned short) (pn|is   |pr) /* underscore */
 153
 154 #define C  (const unsigned short) (         cn) /* control character */
 155 #define Z  (const unsigned short) (nv      |cn) /* NUL */
 156 #define M  (const unsigned short) (nv|sp   |cn) /* cursor movement: \f \v */
 157 #define V  (const unsigned short) (vs|sp   |cn) /* vertical space: \r \n */
 158 #define T  (const unsigned short) (nv|sp|bl|cn) /* tab */
 159 #define S  (const unsigned short) (nv|sp|bl|pr) /* space */
 160
 161 /* Are we ASCII? */
 162 #if HOST_CHARSET == HOST_CHARSET_ASCII
 163
 164 const unsigned short _sch_istable[256] =
 165 {
 166   Z,  C,  C,  C,   C,  C,  C,  C,   /* NUL SOH STX ETX  EOT ENQ ACK BEL */
 167   C,  T,  V,  M,   M,  V,  C,  C,   /* BS  HT  LF  VT   FF  CR  SO  SI  */
 168   C,  C,  C,  C,   C,  C,  C,  C,   /* DLE DC1 DC2 DC3  DC4 NAK SYN ETB */
 169   C,  C,  C,  C,   C,  C,  C,  C,   /* CAN EM  SUB ESC  FS  GS  RS  US  */
 170   S,  P,  P,  P,   P,  P,  P,  P,   /* SP  !   "   #    $   %   &   '   */
 171   P,  P,  P,  P,   P,  P,  P,  P,   /* (   )   *   +    ,   -   .   /   */
 172   D,  D,  D,  D,   D,  D,  D,  D,   /* 0   1   2   3    4   5   6   7   */
 173   D,  D,  P,  P,   P,  P,  P,  P,   /* 8   9   :   ;    <   =   >   ?   */
 174   P, XU, XU, XU,  XU, XU, XU,  U,   /* @   A   B   C    D   E   F   G   */
 175   U,  U,  U,  U,   U,  U,  U,  U,   /* H   I   J   K    L   M   N   O   */
 176   U,  U,  U,  U,   U,  U,  U,  U,   /* P   Q   R   S    T   U   V   W   */
 177   U,  U,  U,  P,   P,  P,  P,  _,   /* X   Y   Z   [    \   ]   ^   _   */
 178   P, XL, XL, XL,  XL, XL, XL,  L,   /* `   a   b   c    d   e   f   g   */
 179   L,  L,  L,  L,   L,  L,  L,  L,   /* h   i   j   k    l   m   n   o   */
 180   L,  L,  L,  L,   L,  L,  L,  L,   /* p   q   r   s    t   u   v   w   */
 181   L,  L,  L,  P,   P,  P,  P,  C,   /* x   y   z   {    |   }   ~   DEL */
 182
 183   /* high half of unsigned char is locale-specific, so all tests are
 184      false in "C" locale */
 185   0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,
 186   0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,
 187   0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,
 188   0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,
 189
 190   0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,
 191   0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,
 192   0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,
 193   0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,  0, 0, 0, 0,
 194 };
 195
 196 const unsigned char _sch_tolower[256] =
 197 {
 198    0,  1,  2,  3,   4,  5,  6,  7,   8,  9, 10, 11,  12, 13, 14, 15,
 199   16, 17, 18, 19,  20, 21, 22, 23,  24, 25, 26, 27,  28, 29, 30, 31,
 200   32, 33, 34, 35,  36, 37, 38, 39,  40, 41, 42, 43,  44, 45, 46, 47,
 201   48, 49, 50, 51,  52, 53, 54, 55,  56, 57, 58, 59,  60, 61, 62, 63,
 202   64,
 203
 204   'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
 205   'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z',
 206
 207   91, 92, 93, 94, 95, 96,
 208
 209   'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
 210   'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z',
 211
 212  123,124,125,126,127,
 213
 214  128,129,130,131, 132,133,134,135, 136,137,138,139, 140,141,142,143,
 215  144,145,146,147, 148,149,150,151, 152,153,154,155, 156,157,158,159,
 216  160,161,162,163, 164,165,166,167, 168,169,170,171, 172,173,174,175,
 217  176,177,178,179, 180,181,182,183, 184,185,186,187, 188,189,190,191,
 218
 219  192,193,194,195, 196,197,198,199, 200,201,202,203, 204,205,206,207,
 220  208,209,210,211, 212,213,214,215, 216,217,218,219, 220,221,222,223,
 221  224,225,226,227, 228,229,230,231, 232,233,234,235, 236,237,238,239,
 222  240,241,242,243, 244,245,246,247, 248,249,250,251, 252,253,254,255,
 223 };
 224
 225 const unsigned char _sch_toupper[256] =
 226 {
 227    0,  1,  2,  3,   4,  5,  6,  7,   8,  9, 10, 11,  12, 13, 14, 15,
 228   16, 17, 18, 19,  20, 21, 22, 23,  24, 25, 26, 27,  28, 29, 30, 31,
 229   32, 33, 34, 35,  36, 37, 38, 39,  40, 41, 42, 43,  44, 45, 46, 47,
 230   48, 49, 50, 51,  52, 53, 54, 55,  56, 57, 58, 59,  60, 61, 62, 63,
 231   64,
 232
 233   'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M',
 234   'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z',
 235
 236   91, 92, 93, 94, 95, 96,
 237
 238   'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M',
 239   'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z',
 240
 241  123,124,125,126,127,
 242
 243  128,129,130,131, 132,133,134,135, 136,137,138,139, 140,141,142,143,
 244  144,145,146,147, 148,149,150,151, 152,153,154,155, 156,157,158,159,
 245  160,161,162,163, 164,165,166,167, 168,169,170,171, 172,173,174,175,
 246  176,177,178,179, 180,181,182,183, 184,185,186,187, 188,189,190,191,
 247
 248  192,193,194,195, 196,197,198,199, 200,201,202,203, 204,205,206,207,
 249  208,209,210,211, 212,213,214,215, 216,217,218,219, 220,221,222,223,
 250  224,225,226,227, 228,229,230,231, 232,233,234,235, 236,237,238,239,
 251  240,241,242,243, 244,245,246,247, 248,249,250,251, 252,253,254,255,
 252 };
 253
 254 #else
 255 # if HOST_CHARSET == HOST_CHARSET_EBCDIC
 256   #error "FIXME: write tables for EBCDIC"
 257 # else
 258   #error "Unrecognized host character set"
 259 # endif
 260 #endif