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