wcstol(3C)wcstol(3C)NAMEwcstol(), wcstoll(), wcstoul(), wcstoull() - convert wide character
string to long integer
SYNOPSIS
Remarks
These functions are compliant with the XPG4 Worldwide Portability
Interface wide-character formatting functions. They parallel the 8-bit
character formatting functions defined in strtol(3C).
DESCRIPTION
or converts the wide character string pointed to by nptr to or repre‐
sentation, respectively. or converts the wide character string pointed
to by nptr to or representation, respectively. The wide character
string is scanned up to the first wide character inconsistent with the
base. Leading "white-space" wide characters (as defined by in
wctype(3C)) are ignored. If no conversion can take place, zero is
returned.
If base is greater than or equal to 2 and less than or equal to 36, it
is used as the base for conversion. After an optional leading sign,
leading zeros are ignored, and or is ignored if base is 16.
If base is zero, the wide character string itself determines the base
as follows: after an optional leading sign, a leading zero indicates
octal conversion; a leading or indicates hexadecimal conversion. Oth‐
erwise, decimal conversion is used.
If the value of endptr is not a pointer to the wide character terminat‐
ing the scan is returned in the location pointed to by endptr. If no
integer can be formed, the location pointed to by endptr is set to
nptr, and zero is returned.
Definitions for these functions and the type are provided in the header
file.
EXTERNAL INFLUENCES
Locale
The category determines how wide character codes are interpreted.
International Code Set Support
Single- and multi-byte character code sets are supported.
RETURN VALUE
Upon successful completion, both functions return the converted value,
if any.
If the correct value would cause overflow:
returns or (according to the sign of the value), and sets
to
returns and sets to
returns or (according to the sign of the value), and sets
to
returns and sets to
For all other errors, zero is returned and is set to indicate the
error.
ERRORS
and fail and is set, if any of the following conditions are encoun‐
tered:
The value of base is not supported.
The value to be returned would have caused overflow.
AUTHOR
These interfaces were developed by OSF and HP.
SEE ALSOwctype(3C), wcstod(3C), wcstoimax(3C), scanf(3S), thread_safety(5),
glossary(9).
STANDARDS CONFORMANCEwcstol(3C)
