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