man pages section 3: Basic Library Functions

Exit Print View

Updated: July 2014
 
 

strtoumax(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(5) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe
Standard

See Also

strtol(3C), strtoul(3C), attributes(5), standards(5)