Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/w/wcstol.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/w/wcstol.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/w/wcstol.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/w/wcstol.html on line 8
Convert a wide-character string into a long integer
#include <wchar.h>
long wcstol( const wchar_t * ptr,
wchar_t ** endptr,
int base );
long long wcstoll( const wchar_t * ptr,
wchar_t ** endptr,
int base );
- ptr
- A pointer to the string to parse.
- endptr
- If this argument isn't NULL, the function stores in it a
pointer to the first unrecognized character found in the string.
- base
- The base of the number being parsed:
- If base is zero, the first characters after the optional sign
determine the base used for the conversion.
If the first characters are 0x or 0X the digits
are treated as hexadecimal.
If the first character is 0, the digits are treated as octal.
Otherwise, the digits are treated as decimal.
- If base isn't zero, it must have a value between 2 and 36.
The letters a-z and A-Z represent the values 10 through 35.
Only those letters whose designated values are less than base
are permitted.
If the value of base is 16, the characters
0x or 0X may optionally precede the sequence
of letters and digits.
libc
Use the -l c option to
qcc
to link against this library.
This library is usually included automatically.
The wcstol() function converts the string pointed to by
ptr into a long;
wcstoll() converts the string into a long long.
These functions recognize strings that contain the following:
- optional white space
- an optional plus or minus sign
- a sequence of digits and letters.
The conversion ends at the first unrecognized wide character.
If endptr isn't NULL, a pointer to the
unrecognized wide character is stored in the object endptr points to.
The converted value.
If the correct value causes an overflow,
LONG_MAX|LONGLONG_MAX or
LONG_MIN|LONGLONG_MIN
is returned according to the sign, and
errno
is set to ERANGE.
If base is out of range, zero is returned and errno is set to EDOM.
- ERANGE
- The value is not representable
- EINVAL
- The value for base is not supported or no conversion could be performed.
ANSI,
POSIX 1003.1
Safety: | |
Cancellation point |
No |
Interrupt handler |
Yes |
Signal handler |
Yes |
Thread |
Yes |
errno
wcrtomb(),
wcsrtombs(),
wcstod(), wcstof(), wcstold(),
wcstoimax(), wcstoumax(),
wcstok(),
wcstombs(),
wcstoul(), wcstoull(),
wctob(),
wctomb()
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/neutrino/lib_ref/w/wcstol.html on line 192
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/neutrino/lib_ref/w/wcstol.html on line 192