strtol(3C)strtol(3C)NAMEstrtol(), atol(), atoll(), atoi(), strtoul(), strtoll(), strtoull()-
convert string to integer
SYNOPSISDESCRIPTION
or converts the character string pointed to by str to or representa‐
tion, respectively. or converts the character string pointed to by str
to or representation, respectively. The string is scanned up to the
first character inconsistent with the base. Leading "white-space"
characters (as defined by in ctype(3C)) are ignored. If no conversion
can take place, zero is returned.
If base is greater than or equal to 2 and less than or equal to 36, it
is used as the base for conversion. After an optional leading sign,
leading zeros are ignored, and or is ignored if base is 16.
If base is zero, the string itself determines the base as follows:
after an optional leading sign, a leading zero indicates octal conver‐
sion; a leading or indicates hexadecimal conversion. Otherwise, deci‐
mal conversion is used.
If the value of ptr is not a pointer to the character terminating the
scan is returned in the location pointed to by ptr. If no integer can
be formed, the location pointed to by ptr is set to str, and zero is
returned.
is equivalent to
is equivalent to
is equivalent to
RETURN VALUE
Upon successful completion, all functions return the converted value,
if any.
If the correct value would cause overflow:
returns or (according to the sign of the value), and sets to
returns and sets to
returns or (according to the sign of the value), and sets to
returns and sets to
returns or (according to the sign of the value), and sets to
For all other errors, zero is returned and is set to indicate the
error.
ERRORS
and fail and is set, if any of the following conditions are encoun‐
tered:
The value of base is not supported.
The value to be returned would have caused overflow.
AUTHOR
These interfaces were developed by OSF and HP.
SEE ALSOctype(3C), strtod(3C), strtoimax(3C), scanf(3S), thread_safety(5),
glossary(9).
STANDARDS CONFORMANCEstrtol(3C)