wcstoimax or wcstoumax Subroutine

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.

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

Parameters

Item Description
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.