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