2 * Convert integer string representation to an integer.
3 * If an integer doesn't fit into specified type, -E is returned.
5 * Integer starts with optional sign.
6 * kstrtou*() functions do not accept sign "-".
8 * Radix 0 means autodetection: leading "0x" implies radix 16,
9 * leading "0" implies radix 8, otherwise radix is 10.
10 * Autodetection hints work after optional sign, but not before.
12 * If -E is returned, result is not touched.
16 #include <linux/kernel.h>
17 #include <linux/types.h>
20 #define KSTRTOX_OVERFLOW (1U << 31)
22 const char *_parse_integer_fixup_radix(const char *s, unsigned int *base)
26 if (_tolower(s[1]) == 'x' && isxdigit(s[2]))
33 if (*base == 16 && s[0] == '0' && _tolower(s[1]) == 'x')
39 * Convert non-negative integer string representation in explicitly given radix
41 * Return number of characters consumed maybe or-ed with overflow bit.
42 * If overflow occurs, result integer (incorrect) is still returned.
44 * Don't you dare use this function.
46 unsigned int _parse_integer(const char *s, unsigned int base, unsigned long long *p)
48 unsigned long long res;
58 if ('0' <= *s && *s <= '9')
60 else if ('a' <= _tolower(*s) && _tolower(*s) <= 'f')
61 val = _tolower(*s) - 'a' + 10;
68 * Check for overflow only if we are within range of
69 * it in the max base we support (16)
71 if (unlikely(res & (~0ull << 60))) {
72 if (res > ULLONG_MAX - val / base)
75 res = res * base + val;
81 rv |= KSTRTOX_OVERFLOW;
85 static int _kstrtoull(const char *s, unsigned int base, unsigned long long *res)
87 unsigned long long _res;
90 s = _parse_integer_fixup_radix(s, &base);
91 rv = _parse_integer(s, base, &_res);
92 if (rv & KSTRTOX_OVERFLOW)
106 * kstrtoull - convert a string to an unsigned long long
107 * @s: The start of the string. The string must be null-terminated, and may also
108 * include a single newline before its terminating null. The first character
109 * may also be a plus sign, but not a minus sign.
110 * @base: The number base to use. The maximum supported base is 16. If base is
111 * given as 0, then the base of the string is automatically detected with the
112 * conventional semantics - If it begins with 0x the number will be parsed as a
113 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
114 * parsed as an octal number. Otherwise it will be parsed as a decimal.
115 * @res: Where to write the result of the conversion on success.
117 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
118 * Used as a replacement for the obsolete simple_strtoull. Return code must
121 int kstrtoull(const char *s, unsigned int base, unsigned long long *res)
125 return _kstrtoull(s, base, res);
129 * kstrtoll - convert a string to a long long
130 * @s: The start of the string. The string must be null-terminated, and may also
131 * include a single newline before its terminating null. The first character
132 * may also be a plus sign or a minus sign.
133 * @base: The number base to use. The maximum supported base is 16. If base is
134 * given as 0, then the base of the string is automatically detected with the
135 * conventional semantics - If it begins with 0x the number will be parsed as a
136 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
137 * parsed as an octal number. Otherwise it will be parsed as a decimal.
138 * @res: Where to write the result of the conversion on success.
140 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
141 * Used as a replacement for the obsolete simple_strtoull. Return code must
144 int kstrtoll(const char *s, unsigned int base, long long *res)
146 unsigned long long tmp;
150 rv = _kstrtoull(s + 1, base, &tmp);
153 if ((long long)-tmp > 0)
157 rv = kstrtoull(s, base, &tmp);
160 if ((long long)tmp < 0)
167 /* Internal, do not use. */
168 int _kstrtoul(const char *s, unsigned int base, unsigned long *res)
170 unsigned long long tmp;
173 rv = kstrtoull(s, base, &tmp);
176 if (tmp != (unsigned long long)(unsigned long)tmp)
182 /* Internal, do not use. */
183 int _kstrtol(const char *s, unsigned int base, long *res)
188 rv = kstrtoll(s, base, &tmp);
191 if (tmp != (long long)(long)tmp)
198 * kstrtouint - convert a string to an unsigned int
199 * @s: The start of the string. The string must be null-terminated, and may also
200 * include a single newline before its terminating null. The first character
201 * may also be a plus sign, but not a minus sign.
202 * @base: The number base to use. The maximum supported base is 16. If base is
203 * given as 0, then the base of the string is automatically detected with the
204 * conventional semantics - If it begins with 0x the number will be parsed as a
205 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
206 * parsed as an octal number. Otherwise it will be parsed as a decimal.
207 * @res: Where to write the result of the conversion on success.
209 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
210 * Used as a replacement for the obsolete simple_strtoull. Return code must
213 int kstrtouint(const char *s, unsigned int base, unsigned int *res)
215 unsigned long long tmp;
218 rv = kstrtoull(s, base, &tmp);
221 if (tmp != (unsigned long long)(unsigned int)tmp)
228 * kstrtoint - convert a string to an int
229 * @s: The start of the string. The string must be null-terminated, and may also
230 * include a single newline before its terminating null. The first character
231 * may also be a plus sign or a minus sign.
232 * @base: The number base to use. The maximum supported base is 16. If base is
233 * given as 0, then the base of the string is automatically detected with the
234 * conventional semantics - If it begins with 0x the number will be parsed as a
235 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
236 * parsed as an octal number. Otherwise it will be parsed as a decimal.
237 * @res: Where to write the result of the conversion on success.
239 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
240 * Used as a replacement for the obsolete simple_strtoull. Return code must
243 int kstrtoint(const char *s, unsigned int base, int *res)
248 rv = kstrtoll(s, base, &tmp);
251 if (tmp != (long long)(int)tmp)
257 int kstrtou16(const char *s, unsigned int base, u16 *res)
259 unsigned long long tmp;
262 rv = kstrtoull(s, base, &tmp);
265 if (tmp != (unsigned long long)(u16)tmp)
271 int kstrtos16(const char *s, unsigned int base, s16 *res)
276 rv = kstrtoll(s, base, &tmp);
279 if (tmp != (long long)(s16)tmp)
285 int kstrtou8(const char *s, unsigned int base, u8 *res)
287 unsigned long long tmp;
290 rv = kstrtoull(s, base, &tmp);
293 if (tmp != (unsigned long long)(u8)tmp)
299 int kstrtos8(const char *s, unsigned int base, s8 *res)
304 rv = kstrtoll(s, base, &tmp);
307 if (tmp != (long long)(s8)tmp)
314 * kstrtobool - convert common user inputs into boolean values
318 * This routine returns 0 iff the first character is one of 'Yy1Nn0', or
319 * [oO][NnFf] for "on" and "off". Otherwise it will return -EINVAL. Value
320 * pointed to by res is updated upon finding a match.
322 int kstrtobool(const char *s, bool *res)