1*38fd1498Szrj /* Hex character manipulation support.
2*38fd1498Szrj Copyright (C) 1995-2018 Free Software Foundation, Inc.
3*38fd1498Szrj
4*38fd1498Szrj This file is part of the libiberty library.
5*38fd1498Szrj Libiberty is free software; you can redistribute it and/or
6*38fd1498Szrj modify it under the terms of the GNU Library General Public
7*38fd1498Szrj License as published by the Free Software Foundation; either
8*38fd1498Szrj version 2 of the License, or (at your option) any later version.
9*38fd1498Szrj
10*38fd1498Szrj Libiberty is distributed in the hope that it will be useful,
11*38fd1498Szrj but WITHOUT ANY WARRANTY; without even the implied warranty of
12*38fd1498Szrj MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13*38fd1498Szrj Library General Public License for more details.
14*38fd1498Szrj
15*38fd1498Szrj You should have received a copy of the GNU Library General Public
16*38fd1498Szrj License along with libiberty; see the file COPYING.LIB. If
17*38fd1498Szrj not, write to the Free Software Foundation, Inc., 51 Franklin Street - Fifth Floor,
18*38fd1498Szrj Boston, MA 02110-1301, USA. */
19*38fd1498Szrj
20*38fd1498Szrj #include <stdio.h> /* for EOF */
21*38fd1498Szrj #ifdef HAVE_CONFIG_H
22*38fd1498Szrj #include "config.h"
23*38fd1498Szrj #endif
24*38fd1498Szrj #include "libiberty.h"
25*38fd1498Szrj #include "safe-ctype.h" /* for HOST_CHARSET_ASCII */
26*38fd1498Szrj
27*38fd1498Szrj #if EOF != -1
28*38fd1498Szrj #error "hex.c requires EOF == -1"
29*38fd1498Szrj #endif
30*38fd1498Szrj
31*38fd1498Szrj /*
32*38fd1498Szrj
33*38fd1498Szrj @deftypefn Extension void hex_init (void)
34*38fd1498Szrj
35*38fd1498Szrj Initializes the array mapping the current character set to
36*38fd1498Szrj corresponding hex values. This function must be called before any
37*38fd1498Szrj call to @code{hex_p} or @code{hex_value}. If you fail to call it, a
38*38fd1498Szrj default ASCII-based table will normally be used on ASCII systems.
39*38fd1498Szrj
40*38fd1498Szrj @end deftypefn
41*38fd1498Szrj
42*38fd1498Szrj @deftypefn Extension int hex_p (int @var{c})
43*38fd1498Szrj
44*38fd1498Szrj Evaluates to non-zero if the given character is a valid hex character,
45*38fd1498Szrj or zero if it is not. Note that the value you pass will be cast to
46*38fd1498Szrj @code{unsigned char} within the macro.
47*38fd1498Szrj
48*38fd1498Szrj @end deftypefn
49*38fd1498Szrj
50*38fd1498Szrj @deftypefn Extension {unsigned int} hex_value (int @var{c})
51*38fd1498Szrj
52*38fd1498Szrj Returns the numeric equivalent of the given character when interpreted
53*38fd1498Szrj as a hexadecimal digit. The result is undefined if you pass an
54*38fd1498Szrj invalid hex digit. Note that the value you pass will be cast to
55*38fd1498Szrj @code{unsigned char} within the macro.
56*38fd1498Szrj
57*38fd1498Szrj The @code{hex_value} macro returns @code{unsigned int}, rather than
58*38fd1498Szrj signed @code{int}, to make it easier to use in parsing addresses from
59*38fd1498Szrj hex dump files: a signed @code{int} would be sign-extended when
60*38fd1498Szrj converted to a wider unsigned type --- like @code{bfd_vma}, on some
61*38fd1498Szrj systems.
62*38fd1498Szrj
63*38fd1498Szrj @end deftypefn
64*38fd1498Szrj
65*38fd1498Szrj @undocumented _hex_array_size
66*38fd1498Szrj @undocumented _hex_bad
67*38fd1498Szrj @undocumented _hex_value
68*38fd1498Szrj
69*38fd1498Szrj */
70*38fd1498Szrj
71*38fd1498Szrj
72*38fd1498Szrj /* Are we ASCII? */
73*38fd1498Szrj #if HOST_CHARSET == HOST_CHARSET_ASCII
74*38fd1498Szrj
75*38fd1498Szrj const unsigned char _hex_value[_hex_array_size] =
76*38fd1498Szrj {
77*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* NUL SOH STX ETX */
78*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* EOT ENQ ACK BEL */
79*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* BS HT LF VT */
80*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* FF CR SO SI */
81*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* DLE DC1 DC2 DC3 */
82*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* DC4 NAK SYN ETB */
83*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* CAN EM SUB ESC */
84*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* FS GS RS US */
85*38fd1498Szrj
86*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* SP ! " # */
87*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* $ % & ' */
88*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* ( ) * + */
89*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* , - . / */
90*38fd1498Szrj 0, 1, 2, 3, /* 0 1 2 3 */
91*38fd1498Szrj 4, 5, 6, 7, /* 4 5 6 7 */
92*38fd1498Szrj 8, 9, _hex_bad, _hex_bad, /* 8 9 : ; */
93*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* < = > ? */
94*38fd1498Szrj
95*38fd1498Szrj _hex_bad, 10, 11, 12, /* @ A B C */
96*38fd1498Szrj 13, 14, 15, _hex_bad, /* D E F G */
97*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* H I J K */
98*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* L M N O */
99*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* P Q R S */
100*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* T U V W */
101*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* X Y Z [ */
102*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* \ ] ^ _ */
103*38fd1498Szrj
104*38fd1498Szrj _hex_bad, 10, 11, 12, /* ` a b c */
105*38fd1498Szrj 13, 14, 15, _hex_bad, /* d e f g */
106*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* h i j k */
107*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* l m n o */
108*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* p q r s */
109*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* t u v w */
110*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* x y z { */
111*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad, /* | } ~ DEL */
112*38fd1498Szrj
113*38fd1498Szrj /* The high half of unsigned char, all values are _hex_bad. */
114*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
115*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
116*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
117*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
118*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
119*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
120*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
121*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
122*38fd1498Szrj
123*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
124*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
125*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
126*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
127*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
128*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
129*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
130*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
131*38fd1498Szrj
132*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
133*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
134*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
135*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
136*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
137*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
138*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
139*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
140*38fd1498Szrj
141*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
142*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
143*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
144*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
145*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
146*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
147*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
148*38fd1498Szrj _hex_bad, _hex_bad, _hex_bad, _hex_bad,
149*38fd1498Szrj };
150*38fd1498Szrj #define HEX_TABLE_INITIALIZED
151*38fd1498Szrj
152*38fd1498Szrj #else
153*38fd1498Szrj
154*38fd1498Szrj unsigned char _hex_value[_hex_array_size];
155*38fd1498Szrj
156*38fd1498Szrj #endif /* not ASCII */
157*38fd1498Szrj
158*38fd1498Szrj void
hex_init(void)159*38fd1498Szrj hex_init (void)
160*38fd1498Szrj {
161*38fd1498Szrj #ifndef HEX_TABLE_INITIALIZED
162*38fd1498Szrj int i;
163*38fd1498Szrj
164*38fd1498Szrj for (i=0; i<_hex_array_size; i++)
165*38fd1498Szrj {
166*38fd1498Szrj switch (i)
167*38fd1498Szrj {
168*38fd1498Szrj case '0': _hex_value[i] = 0; break;
169*38fd1498Szrj case '1': _hex_value[i] = 1; break;
170*38fd1498Szrj case '2': _hex_value[i] = 2; break;
171*38fd1498Szrj case '3': _hex_value[i] = 3; break;
172*38fd1498Szrj case '4': _hex_value[i] = 4; break;
173*38fd1498Szrj case '5': _hex_value[i] = 5; break;
174*38fd1498Szrj case '6': _hex_value[i] = 6; break;
175*38fd1498Szrj case '7': _hex_value[i] = 7; break;
176*38fd1498Szrj case '8': _hex_value[i] = 8; break;
177*38fd1498Szrj case '9': _hex_value[i] = 9; break;
178*38fd1498Szrj
179*38fd1498Szrj case 'a': case 'A': _hex_value[i] = 10; break;
180*38fd1498Szrj case 'b': case 'B': _hex_value[i] = 11; break;
181*38fd1498Szrj case 'c': case 'C': _hex_value[i] = 12; break;
182*38fd1498Szrj case 'd': case 'D': _hex_value[i] = 13; break;
183*38fd1498Szrj case 'e': case 'E': _hex_value[i] = 14; break;
184*38fd1498Szrj case 'f': case 'F': _hex_value[i] = 15; break;
185*38fd1498Szrj
186*38fd1498Szrj default:
187*38fd1498Szrj _hex_value[i] = _hex_bad;
188*38fd1498Szrj break;
189*38fd1498Szrj }
190*38fd1498Szrj }
191*38fd1498Szrj #endif
192*38fd1498Szrj }
193