1 // SPDX-License-Identifier: GPL-2.0-only
2 /* -*- linux-c -*- ------------------------------------------------------- *
4 * Copyright (C) 1991, 1992 Linus Torvalds
5 * Copyright 2007 rPath, Inc. - All Rights Reserved
7 * ----------------------------------------------------------------------- */
10 * Very basic string functions
13 #include <linux/types.h>
14 #include <linux/compiler.h>
15 #include <linux/errno.h>
16 #include <linux/limits.h>
21 #define KSTRTOX_OVERFLOW (1U << 31)
24 * Undef these macros so that the functions that we provide
25 * here will have the correct names regardless of how string.h
26 * may have chosen to #define them.
32 int memcmp(const void *s1, const void *s2, size_t len)
35 asm("repe; cmpsb" CC_SET(nz)
36 : CC_OUT(nz) (diff), "+D" (s1), "+S" (s2), "+c" (len));
41 * Clang may lower `memcmp == 0` to `bcmp == 0`.
43 int bcmp(const void *s1, const void *s2, size_t len)
45 return memcmp(s1, s2, len);
48 int strcmp(const char *str1, const char *str2)
50 const unsigned char *s1 = (const unsigned char *)str1;
51 const unsigned char *s2 = (const unsigned char *)str2;
64 int strncmp(const char *cs, const char *ct, size_t count)
72 return c1 < c2 ? -1 : 1;
80 size_t strnlen(const char *s, size_t maxlen)
83 while (*es && maxlen) {
91 /* Works only for digits and letters, but small and fast */
92 #define TOLOWER(x) ((x) | 0x20)
94 static unsigned int simple_guess_base(const char *cp)
97 if (TOLOWER(cp[1]) == 'x' && isxdigit(cp[2]))
107 * simple_strtoull - convert a string to an unsigned long long
108 * @cp: The start of the string
109 * @endp: A pointer to the end of the parsed string will be placed here
110 * @base: The number base to use
112 unsigned long long simple_strtoull(const char *cp, char **endp, unsigned int base)
114 unsigned long long result = 0;
117 base = simple_guess_base(cp);
119 if (base == 16 && cp[0] == '0' && TOLOWER(cp[1]) == 'x')
122 while (isxdigit(*cp)) {
125 value = isdigit(*cp) ? *cp - '0' : TOLOWER(*cp) - 'a' + 10;
128 result = result * base + value;
137 long simple_strtol(const char *cp, char **endp, unsigned int base)
140 return -simple_strtoull(cp + 1, endp, base);
142 return simple_strtoull(cp, endp, base);
146 * strlen - Find the length of a string
147 * @s: The string to be sized
149 size_t strlen(const char *s)
153 for (sc = s; *sc != '\0'; ++sc)
159 * strstr - Find the first substring in a %NUL terminated string
160 * @s1: The string to be searched
161 * @s2: The string to search for
163 char *strstr(const char *s1, const char *s2)
173 if (!memcmp(s1, s2, l2))
181 * strchr - Find the first occurrence of the character c in the string s.
182 * @s: the string to be searched
183 * @c: the character to search for
185 char *strchr(const char *s, int c)
187 while (*s != (char)c)
193 static inline u64 __div_u64_rem(u64 dividend, u32 divisor, u32 *remainder)
203 if (upper >= divisor) {
204 d.v32[1] = upper / divisor;
207 asm ("divl %2" : "=a" (d.v32[0]), "=d" (*remainder) :
208 "rm" (divisor), "0" (d.v32[0]), "1" (upper));
212 static inline u64 __div_u64(u64 dividend, u32 divisor)
216 return __div_u64_rem(dividend, divisor, &remainder);
219 static inline char _tolower(const char c)
224 static const char *_parse_integer_fixup_radix(const char *s, unsigned int *base)
228 if (_tolower(s[1]) == 'x' && isxdigit(s[2]))
235 if (*base == 16 && s[0] == '0' && _tolower(s[1]) == 'x')
241 * Convert non-negative integer string representation in explicitly given radix
243 * Return number of characters consumed maybe or-ed with overflow bit.
244 * If overflow occurs, result integer (incorrect) is still returned.
246 * Don't you dare use this function.
248 static unsigned int _parse_integer(const char *s,
250 unsigned long long *p)
252 unsigned long long res;
259 unsigned int lc = c | 0x20; /* don't tolower() this line */
262 if ('0' <= c && c <= '9')
264 else if ('a' <= lc && lc <= 'f')
272 * Check for overflow only if we are within range of
273 * it in the max base we support (16)
275 if (unlikely(res & (~0ull << 60))) {
276 if (res > __div_u64(ULLONG_MAX - val, base))
277 rv |= KSTRTOX_OVERFLOW;
279 res = res * base + val;
287 static int _kstrtoull(const char *s, unsigned int base, unsigned long long *res)
289 unsigned long long _res;
292 s = _parse_integer_fixup_radix(s, &base);
293 rv = _parse_integer(s, base, &_res);
294 if (rv & KSTRTOX_OVERFLOW)
308 * kstrtoull - convert a string to an unsigned long long
309 * @s: The start of the string. The string must be null-terminated, and may also
310 * include a single newline before its terminating null. The first character
311 * may also be a plus sign, but not a minus sign.
312 * @base: The number base to use. The maximum supported base is 16. If base is
313 * given as 0, then the base of the string is automatically detected with the
314 * conventional semantics - If it begins with 0x the number will be parsed as a
315 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
316 * parsed as an octal number. Otherwise it will be parsed as a decimal.
317 * @res: Where to write the result of the conversion on success.
319 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
320 * Used as a replacement for the obsolete simple_strtoull. Return code must
323 int kstrtoull(const char *s, unsigned int base, unsigned long long *res)
327 return _kstrtoull(s, base, res);
330 static int _kstrtoul(const char *s, unsigned int base, unsigned long *res)
332 unsigned long long tmp;
335 rv = kstrtoull(s, base, &tmp);
338 if (tmp != (unsigned long)tmp)
345 * boot_kstrtoul - convert a string to an unsigned long
346 * @s: The start of the string. The string must be null-terminated, and may also
347 * include a single newline before its terminating null. The first character
348 * may also be a plus sign, but not a minus sign.
349 * @base: The number base to use. The maximum supported base is 16. If base is
350 * given as 0, then the base of the string is automatically detected with the
351 * conventional semantics - If it begins with 0x the number will be parsed as a
352 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
353 * parsed as an octal number. Otherwise it will be parsed as a decimal.
354 * @res: Where to write the result of the conversion on success.
356 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
357 * Used as a replacement for the simple_strtoull.
359 int boot_kstrtoul(const char *s, unsigned int base, unsigned long *res)
362 * We want to shortcut function call, but
363 * __builtin_types_compatible_p(unsigned long, unsigned long long) = 0.
365 if (sizeof(unsigned long) == sizeof(unsigned long long) &&
366 __alignof__(unsigned long) == __alignof__(unsigned long long))
367 return kstrtoull(s, base, (unsigned long long *)res);
369 return _kstrtoul(s, base, res);