STRTOIMAX(3C) Standard C Library Functions STRTOIMAX(3C)
NAME
strtoimax, strtoumax - convert string to integer type
SYNOPSIS
#include <inttypes.h>
intmax_t strtoimax(
const char *restrict nptr,
char **restrict endptr,
int base);
uintmax_t strtoumax(
const char *restrict nptr,
char **restrict endptr,
int base);
DESCRIPTION
These functions are equivalent to the
strtol(),
strtoll(),
strtoul(),
and
strtoull() functions, except that the initial portion of the
string is converted to
intmax_t and
uintmax_t representation,
respectively.
RETURN VALUES
These functions return the converted value, if any.
If no conversion could be performed, 0 is returned.
If the correct value is outside the range of representable values,
{
INTMAX_MAX}, {
INTMAX_MIN}, or {
UINTMAX_MAX} is returned (according
to the return type and sign of the value, if any), and
errno is set
to
ERANGE.
ERRORS
These functions will fail if:
ERANGE The value to be returned is not representable.
These functions may fail if:
EINVAL The value of
base is not supported.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
SEE ALSO
strtol(3C),
strtoul(3C),
attributes(7),
standards(7) November 1, 2003 STRTOIMAX(3C)
