2 * Copyright (c) 1990 The Regents of the University of California.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. [rescinded 22 July 1999]
14 * 4. Neither the name of the University nor the names of its contributors
15 * may be used to endorse or promote products derived from this software
16 * without specific prior written permission.
18 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 @deftypefn Supplemental {long int} strtol (const char *@var{string}, char **@var{endptr}, int @var{base})
34 @deftypefnx Supplemental {unsigned long int} strtoul (const char *@var{string}, char **@var{endptr}, int @var{base})
36 The @code{strtol} function converts the string in @var{string} to a
37 long integer value according to the given @var{base}, which must be
38 between 2 and 36 inclusive, or be the special value 0. If @var{base}
39 is 0, @code{strtol} will look for the prefixes @code{0} and @code{0x}
40 to indicate bases 8 and 16, respectively, else default to base 10.
41 When the base is 16 (either explicitly or implicitly), a prefix of
42 @code{0x} is allowed. The handling of @var{endptr} is as that of
43 @code{strtod} above. The @code{strtoul} function is the same, except
44 that the converted value is unsigned.
56 #ifdef HAVE_SYS_PARAM_H
57 #include <sys/param.h>
60 #ifdef NEED_DECLARATION_ERRNO
63 #include "safe-ctype.h"
65 /* FIXME: It'd be nice to configure around these, but the include files are too
66 painful. These macros should at least be more portable than hardwired hex
70 #define ULONG_MAX ((unsigned long)(~0L)) /* 0xFFFFFFFF */
74 #define LONG_MAX ((long)(ULONG_MAX >> 1)) /* 0x7FFFFFFF */
78 #define LONG_MIN ((long)(~LONG_MAX)) /* 0x80000000 */
82 * Convert a string to a long integer.
84 * Ignores `locale' stuff. Assumes that the upper and lower case
85 * alphabets and digits are each contiguous.
88 strtol(const char *nptr, char **endptr, register int base)
90 register const char *s = nptr;
91 register unsigned long acc;
93 register unsigned long cutoff;
94 register int neg = 0, any, cutlim;
97 * Skip white space and pick up leading +/- sign if any.
98 * If base is 0, allow 0x for hex and 0 for octal, else
99 * assume decimal; if base is already 16, allow 0x.
103 } while (ISSPACE(c));
109 if ((base == 0 || base == 16) &&
110 c == '0' && (*s == 'x' || *s == 'X')) {
116 base = c == '0' ? 8 : 10;
119 * Compute the cutoff value between legal numbers and illegal
120 * numbers. That is the largest legal value, divided by the
121 * base. An input number that is greater than this value, if
122 * followed by a legal input character, is too big. One that
123 * is equal to this value may be valid or not; the limit
124 * between valid and invalid numbers is then based on the last
125 * digit. For instance, if the range for longs is
126 * [-2147483648..2147483647] and the input base is 10,
127 * cutoff will be set to 214748364 and cutlim to either
128 * 7 (neg==0) or 8 (neg==1), meaning that if we have accumulated
129 * a value > 214748364, or equal but the next digit is > 7 (or 8),
130 * the number is too big, and we will return a range error.
132 * Set any if any `digits' consumed; make it negative to indicate
135 cutoff = neg ? -(unsigned long)LONG_MIN : LONG_MAX;
136 cutlim = cutoff % (unsigned long)base;
137 cutoff /= (unsigned long)base;
138 for (acc = 0, any = 0;; c = *s++) {
142 c -= ISUPPER(c) ? 'A' - 10 : 'a' - 10;
147 if (any < 0 || acc > cutoff || (acc == cutoff && c > cutlim))
156 acc = neg ? LONG_MIN : LONG_MAX;
161 *endptr = (char *) (any ? s - 1 : nptr);