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

Technical Reference: Base Operating System and Extensions, Volume 2

wcstoimax or wcstoumax Subroutine

Purpose

Converts a wide-character string to an integer type.

Syntax

#include <stddef.h>
#include <inttypes.h>

intmax_t wcstoimax (nptr, endptr, base)
const wchar_t *restrict nptr;
wchar_t **restrict endptr;
int base;

uintmax_t wcstoumax (nptr, endptr, base)
const wchar_t *restrict  nptr;
wchar_t **restrict endptr;
int base;

Description

The wcstoimax or wcstoumax subroutines are equivalent to the wcstol, wcstoll, wcstoul, and wcstoull subroutines, respectively, except that the initial portion of the wide string is converted to intmax_t and uintmax_t representation, respectively.

Parameters

nptr Points to the wide-character string.
endptr Points to the object where the final wide-character string is stored.
base Determines the subject sequence interpreted as an integer.

Return Values

The wcstoimax or wcstoumax 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 wcstol or wcstoll Subroutine.

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

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