1 /* Shared general utility routines for GDB, the GNU debugger.
3 Copyright (C) 1986-2017 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 #include "common-defs.h"
21 #include "common-utils.h"
22 #include "host-defs.h"
25 /* The xmalloc() (libiberty.h) family of memory management routines.
27 These are like the ISO-C malloc() family except that they implement
28 consistent semantics and guard against typical memory management
31 /* NOTE: These are declared using PTR to ensure consistency with
32 "libiberty.h". xfree() is GDB local. */
39 /* See libiberty/xmalloc.c. This function need's to match that's
40 semantics. It never returns NULL. */
44 val = malloc (size); /* ARI: malloc */
46 malloc_failure (size);
52 xrealloc (PTR ptr, size_t size) /* ARI: PTR */
56 /* See libiberty/xmalloc.c. This function need's to match that's
57 semantics. It never returns NULL. */
62 val = realloc (ptr, size); /* ARI: realloc */
64 val = malloc (size); /* ARI: malloc */
66 malloc_failure (size);
72 xcalloc (size_t number, size_t size)
76 /* See libiberty/xmalloc.c. This function need's to match that's
77 semantics. It never returns NULL. */
78 if (number == 0 || size == 0)
84 mem = calloc (number, size); /* ARI: xcalloc */
86 malloc_failure (number * size);
94 return xcalloc (1, size);
101 free (ptr); /* ARI: free */
105 xmalloc_failed (size_t size)
107 malloc_failure (size);
110 /* Like asprintf/vasprintf but get an internal_error if the call
114 xstrprintf (const char *format, ...)
119 va_start (args, format);
120 ret = xstrvprintf (format, args);
126 xstrvprintf (const char *format, va_list ap)
129 int status = vasprintf (&ret, format, ap);
131 /* NULL is returned when there was a memory allocation problem, or
132 any other error (for instance, a bad format string). A negative
133 status (the printed length) with a non-NULL buffer should never
134 happen, but just to be sure. */
135 if (ret == NULL || status < 0)
136 internal_error (__FILE__, __LINE__, _("vasprintf call failed"));
141 xsnprintf (char *str, size_t size, const char *format, ...)
146 va_start (args, format);
147 ret = vsnprintf (str, size, format, args);
148 gdb_assert (ret < size);
154 /* See documentation in common-utils.h. */
157 string_printf (const char* fmt, ...)
163 size = vsnprintf (NULL, 0, fmt, vp);
166 std::string str (size, '\0');
168 /* C++11 and later guarantee std::string uses contiguous memory and
169 always includes the terminating '\0'. */
171 vsprintf (&str[0], fmt, vp);
177 /* See documentation in common-utils.h. */
180 string_vprintf (const char* fmt, va_list args)
186 size = vsnprintf (NULL, 0, fmt, vp);
189 std::string str (size, '\0');
191 /* C++11 and later guarantee std::string uses contiguous memory and
192 always includes the terminating '\0'. */
193 vsprintf (&str[0], fmt, args);
199 savestring (const char *ptr, size_t len)
201 char *p = (char *) xmalloc (len + 1);
203 memcpy (p, ptr, len);
208 /* The bit offset of the highest byte in a ULONGEST, for overflow
211 #define HIGH_BYTE_POSN ((sizeof (ULONGEST) - 1) * HOST_CHAR_BIT)
213 /* True (non-zero) iff DIGIT is a valid digit in radix BASE,
214 where 2 <= BASE <= 36. */
217 is_digit_in_base (unsigned char digit, int base)
219 if (!isalnum (digit))
222 return (isdigit (digit) && digit < base + '0');
224 return (isdigit (digit) || tolower (digit) < base - 10 + 'a');
228 digit_to_int (unsigned char c)
233 return tolower (c) - 'a' + 10;
236 /* As for strtoul, but for ULONGEST results. */
239 strtoulst (const char *num, const char **trailer, int base)
241 unsigned int high_part;
246 /* Skip leading whitespace. */
247 while (isspace (num[i]))
250 /* Handle prefixes. */
253 else if (num[i] == '-')
259 if (base == 0 || base == 16)
261 if (num[i] == '0' && (num[i + 1] == 'x' || num[i + 1] == 'X'))
269 if (base == 0 && num[i] == '0')
275 if (base < 2 || base > 36)
281 result = high_part = 0;
282 for (; is_digit_in_base (num[i], base); i += 1)
284 result = result * base + digit_to_int (num[i]);
285 high_part = high_part * base + (unsigned int) (result >> HIGH_BYTE_POSN);
286 result &= ((ULONGEST) 1 << HIGH_BYTE_POSN) - 1;
287 if (high_part > 0xff)
290 result = ~ (ULONGEST) 0;
300 result = result + ((ULONGEST) high_part << HIGH_BYTE_POSN);
307 /* See documentation in common-utils.h. */
310 skip_spaces (char *chp)
314 while (*chp && isspace (*chp))
319 /* A const-correct version of the above. */
322 skip_spaces (const char *chp)
326 while (*chp && isspace (*chp))
331 /* See documentation in common-utils.h. */
334 skip_to_space (const char *chp)
338 while (*chp && !isspace (*chp))
343 /* See documentation in common-utils.h. */
346 skip_to_space (char *chp)
348 return (char *) skip_to_space ((const char *) chp);
351 /* See common/common-utils.h. */
354 free_vector_argv (std::vector<char *> &v)
362 /* See common/common-utils.h. */
365 stringify_argv (const std::vector<char *> &args)
369 if (!args.empty () && args[0] != NULL)
378 /* Erase the last whitespace. */
379 ret.erase (ret.end () - 1);