Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

Guardian Native C Library Calls (t - z) wcstol(3)
RETURN VALUES
The wcstol() function returns the converted value of long integer if the expected form is found. If
no conversion could be performed, a value of 0 (zero) is returned. If the converted value is out-
side the range of representable values, LONG_MAX or LONG_MIN is returned (according to
the sign of the value).
If the endptr parameter is not a null pointer, wcstol() stores a pointer to the final sequence of
unrecognized characters in *endptr except when the subject sequence is empty or invalid. In this
case, wcstol() stores the nptr pointer in the *endptr parameter.
Since 0 (zero), LONG_MIN, and LONG_MAX are returned in the event of an error and are also
valid returns if the wcstol() function is successful, applications should set errno to 0 (zero)
before calling the wcstol() function, and check errno after return from the wcstol() function. If
errno is nonzero, an error occurred. Additionally, if 0 (zero) is returned, applications should
check if 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 wcstol() function sets errno to the corresponding
value.
[EINVAL] The base parameter has a value less than 0 or greater than 36.
The nptr parameter is a null pointer.
[ERANGE] The converted value is outside the range of representable values.
RELATED INFORMATION
Functions: atoi(3), strtol(3), scanf(3), wcstod(3), iswalnum(3).
527192-007 Hewlett-Packard Company 7−79