strtoimax or strtoumax Subroutine

The strtoimax and strtoumax subroutines return the converted value, if any.

If no conversion could be performed, zero 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 the errno global variable is set to ERANGE.

Purpose

Converts string to integer type.

Syntax

#include <inttypes.h>

intmax_t strtoimax (nptr, endptr, base)
const char *restrict nptr;
char **restrict endptr;
int base;

uintmax_t strtoumax (nptr, endptr, base)
const char *restrict nptr;
char **restrict endptr;
int base;

Description

The strtoimax and strtoumax subroutines are equivalent to the strtol, strtoll, strtoul, and strtoull subroutines, except that the initial portion of the string shall be converted to intmax_t and uintmax_t representation, respectively.

Parameters

Item Description
nptr Points to the string to be converted.
endptr Points to the object where the final string is stored.
base Determines the value of the integer represented in some radix.

Return Values