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)

illumos November 1, 2003 STRTOIMAX(3C)