table of contents
KSTRTOL(9) | Basic C Library Functions | KSTRTOL(9) |
NAME¶
kstrtol - convert a string to a long
SYNOPSIS¶
int kstrtol(const char * s, unsigned int base, long * res);
ARGUMENTS¶
s
The start of the string. The string must be
null-terminated, and may also include a single newline before its terminating
null. The first character may also be a plus sign or a minus sign.
base
The number base to use. The maximum supported base is 16.
If base is given as 0, then the base of the string is automatically detected
with the conventional semantics - If it begins with 0x the number will be
parsed as a hexadecimal (case insensitive), if it otherwise begins with 0, it
will be parsed as an octal number. Otherwise it will be parsed as a
decimal.
res
Where to write the result of the conversion on
success.
DESCRIPTION¶
Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error. Used as a replacement for the obsolete simple_strtoull. Return code must be checked.
COPYRIGHT¶
June 2024 | Kernel Hackers Manual 3.10 |