[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 2

strtoimax or strtoumax Subroutine

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

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

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.

Related Information

The strtol, strtoul, strtoll, strtoull, or atoi Subroutine.

inttypes.h in AIX 5L Version 5.2 Files Reference.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]