Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

Guardian Native C Library Calls (t - z) wcstoumax(3)
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).
527192-018 Hewlett-Packard Company 7−179