Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

wcstoumax(3) OSS Library Calls Reference Manual
RETURN VALUES
The wcstoumax( ) function returns the converted value of the uintmax_t integer if the expected
form is found. If no conversion could be performed, a value of 0 (zero) is returned. If the con-
verted value is outside the range of representable values, ULONG_MAX is returned.
If the endptr parameter is not a null pointer, wcstoumax( ) stores a pointer to the final sequence
of unrecognized characters in *endptr, except when the subject sequence is empty or invalid. In
this case, wcstoumax( ) stores the nptr pointer in the *endptr parameter.
Since 0 (zero) and ULONG_MAX are returned in the event of an error and are also valid returns
if the wcstoumax( ) function is successful, applications should set errno to 0 (zero) before cal-
ling the wcstoumax( ) function, and check errno after return from the wcstoumax( ) function. If
errno is nonzero, an error occurred. Additionally, if 0 (zero) is returned, applications should
check whether the endptr parameter equals the nptr parameter. In this case, there was no valid
subject string.
ERRORS
If any of the following conditions occur, the wcstoumax( ) function sets errno to the value that
corresponds to the condition.
EINVAL The base parameter has a value less than 0 or greater than 36, or the nptr param-
eter is a null pointer.
ERANGE The converted value is outside the range of representable values.
RELATED INFORMATION
Functions: atoi(3), iswalnum(3), scanf(3), strtoul(3), wcstod(3), wcstol(3), wctype(3).
8−50 Hewlett-Packard Company 527187-017