1 /* <ctype.h> replacement macros. 2 3 Copyright (C) 2000-2017 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 261