blob: d3247eddb86911c46a50c0a45f3f2fed9b8b5e46 [file] [log] [blame]
sewardjde4a1d02002-03-22 01:27:54 +00001/* <ctype.h> replacement macros.
2
Elliott Hughesed398002017-06-21 14:41:24 -07003 Copyright (C) 2000-2017 Free Software Foundation, Inc.
sewardjde4a1d02002-03-22 01:27:54 +00004 Contributed by Zack Weinberg <zackw@stanford.edu>.
5
6This file is part of the libiberty library.
7Libiberty is free software; you can redistribute it and/or
8modify it under the terms of the GNU Library General Public
9License as published by the Free Software Foundation; either
10version 2 of the License, or (at your option) any later version.
11
12Libiberty is distributed in the hope that it will be useful,
13but WITHOUT ANY WARRANTY; without even the implied warranty of
14MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15Library General Public License for more details.
16
17You should have received a copy of the GNU Library General Public
18License along with libiberty; see the file COPYING.LIB. If
sewardj4f2683a2008-10-26 11:53:30 +000019not, write to the Free Software Foundation, Inc., 51 Franklin Street - Fifth Floor,
20Boston, MA 02110-1301, USA. */
sewardjde4a1d02002-03-22 01:27:54 +000021
sewardj4f2683a2008-10-26 11:53:30 +000022/*
sewardjde4a1d02002-03-22 01:27:54 +000023
sewardj4f2683a2008-10-26 11:53:30 +000024@defvr Extension HOST_CHARSET
25This macro indicates the basic character set and encoding used by the
26host: more precisely, the encoding used for character constants in
27preprocessor @samp{#if} statements (the C "execution character set").
28It is defined by @file{safe-ctype.h}, and will be an integer constant
29with one of the following values:
30
31@ftable @code
32@item HOST_CHARSET_UNKNOWN
33The host character set is unknown - that is, not one of the next two
34possibilities.
35
36@item HOST_CHARSET_ASCII
37The host character set is ASCII.
38
39@item HOST_CHARSET_EBCDIC
40The host character set is some variant of EBCDIC. (Only one of the
41nineteen 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
58These twelve macros are defined by @file{safe-ctype.h}. Each has the
59same meaning as the corresponding macro (with name in lowercase)
60defined by the standard header @file{ctype.h}. For example,
61@code{ISALPHA} returns true for alphabetic characters and false for
62others. However, there are two differences between these macros and
63those provided by @file{ctype.h}:
64
65@itemize @bullet
66@item These macros are guaranteed to have well-defined behavior for all
67values representable by @code{signed char} and @code{unsigned char}, and
68for @code{EOF}.
69
70@item These macros ignore the current locale; they are true for these
71fixed 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
87Note that, if the host character set is ASCII or a superset thereof,
88all these macros will return false for all values of @code{char} outside
89the range of 7-bit ASCII. In particular, both ISPRINT and ISCNTRL return
90false 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})
100These six macros are defined by @file{safe-ctype.h} and provide
101additional character classes which are useful when doing lexical
102analysis of C or similar languages. They are true for the following
103sets 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*/
sewardjde4a1d02002-03-22 01:27:54 +0000116
sewardj9a2ce3d2008-10-27 09:54:14 +0000117#if 0 /* in valgrind */
sewardjde4a1d02002-03-22 01:27:54 +0000118#include "ansidecl.h"
sewardj4f2683a2008-10-26 11:53:30 +0000119#include <safe-ctype.h>
120#include <stdio.h> /* for EOF */
sewardj9a2ce3d2008-10-27 09:54:14 +0000121#endif /* ! in valgrind */
122
123#include "vg_libciface.h"
124
125#include "safe-ctype.h"
sewardj4f2683a2008-10-26 11:53:30 +0000126
127#if EOF != -1
128 #error "<safe-ctype.h> requires EOF == -1"
129#endif
sewardjde4a1d02002-03-22 01:27:54 +0000130
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. */
sewardj4f2683a2008-10-26 11:53:30 +0000146#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 */
sewardjde4a1d02002-03-22 01:27:54 +0000153
sewardj4f2683a2008-10-26 11:53:30 +0000154#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 */
sewardjde4a1d02002-03-22 01:27:54 +0000160
161/* Are we ASCII? */
sewardj4f2683a2008-10-26 11:53:30 +0000162#if HOST_CHARSET == HOST_CHARSET_ASCII
sewardjde4a1d02002-03-22 01:27:54 +0000163
164const 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
196const 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
225const 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
sewardj4f2683a2008-10-26 11:53:30 +0000255# 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