| Skip Navigation Links | |
| Exit Print View | |
 | man pages section 3: Basic Library Functions Oracle Solaris 11 Information Library |
| Skip Navigation Links | |
| Exit Print View | |
| man pages section 3: Basic Library Functions Oracle Solaris 11 Information Library |
enable_extended_FILE_stdio(3C)
posix_spawnattr_getschedparam(3C)
posix_spawnattr_getschedpolicy(3C)
posix_spawnattr_getsigdefault(3C)
posix_spawnattr_getsigignore_np(3C)
posix_spawnattr_getsigmask(3C)
posix_spawnattr_setschedparam(3C)
posix_spawnattr_setschedpolicy(3C)
posix_spawnattr_setsigdefault(3C)
posix_spawnattr_setsigignore_np(3C)
posix_spawnattr_setsigmask(3C)
posix_spawn_file_actions_addclose(3C)
posix_spawn_file_actions_addclosefrom_np(3C)
posix_spawn_file_actions_adddup2(3C)
posix_spawn_file_actions_addopen(3C)
posix_spawn_file_actions_destroy(3C)
posix_spawn_file_actions_init(3C)
pthread_attr_getdetachstate(3C)
pthread_attr_getinheritsched(3C)
pthread_attr_getschedparam(3C)
pthread_attr_getschedpolicy(3C)
pthread_attr_setdetachstate(3C)
pthread_attr_setinheritsched(3C)
pthread_attr_setschedparam(3C)
pthread_attr_setschedpolicy(3C)
pthread_barrierattr_destroy(3C)
pthread_barrierattr_getpshared(3C)
pthread_barrierattr_setpshared(3C)
pthread_condattr_getpshared(3C)
pthread_condattr_setpshared(3C)
pthread_cond_reltimedwait_np(3C)
pthread_key_create_once_np(3C)
pthread_mutexattr_getprioceiling(3C)
pthread_mutexattr_getprotocol(3C)
pthread_mutexattr_getpshared(3C)
pthread_mutexattr_getrobust(3C)
pthread_mutexattr_setprioceiling(3C)
pthread_mutexattr_setprotocol(3C)
pthread_mutexattr_setpshared(3C)
pthread_mutexattr_setrobust(3C)
pthread_mutex_getprioceiling(3C)
pthread_mutex_reltimedlock_np(3C)
pthread_mutex_setprioceiling(3C)
pthread_rwlockattr_destroy(3C)
pthread_rwlockattr_getpshared(3C)
pthread_rwlockattr_setpshared(3C)
pthread_rwlock_reltimedrdlock_np(3C)
pthread_rwlock_reltimedwrlock_np(3C)
pthread_rwlock_timedrdlock(3C)
pthread_rwlock_timedwrlock(3C)
rctlblk_get_enforced_value(3C)
- convert wide character string to long integer
#include <wchar.h>longwcstol(const wchar_t *restrictnptr,wchar_t **restrictendptr,intbase);
long longwcstoll(const wchar_t *restrictnptr,wchar_t **restrictendptr,intbase);
#include <widec.h>longwstol(const wchar_t *nptr,wchar_t **endptr,intbase);
longwatol(wchar_t *nptr);
long longwatoll(wchar_t *nptr);
intwatoi(wchar_t *nptr);
Thewcstol() andwcstoll() functions convert the initial portion of the widecharacter string pointed to bynptr tolong andlong long representation, respectively.They first decompose the input string into three parts:
an initial, possibly empty, sequence of white-space wide-character codes (as specified byiswspace(3C))
a subject sequence interpreted as an integer represented in some radix determined by the value ofbase
a final wide character string of one or more unrecognised wide character codes, including the terminating null wide-character code of the input wide character string
They then attempt to convert the subject sequence to an integer, andreturn the result.
If the value ofbase is0, the expected form of thesubject sequence is that of a decimal constant, octal constant or hexadecimalconstant, any of which may be preceded by a `+' or `-'sign. A decimal constant begins with a non-zero digit, and consists of asequence of decimal digits. An octal constant consists of the prefix `0'optionally followed by a sequence of the digits `0' to `7' only.A hexadecimal constant consists of the prefix `0x' or `0X' followed bya sequence of the decimal digits and letters `a' (or `A') to`f' (or `F') with values 10 to 15 respectively.
If the value ofbase is between2 and36, the expectedform of the subject sequence is a sequence of letters and digitsrepresenting an integer with the radix specified bybase, optionally precededby a `+' or `-' sign, but not including an integer suffix. Theletters from `a' (or `A') to `z' (or `Z') inclusive areascribed the values 10 to 35; only letters whose ascribed values areless than that ofbase are permitted. If the value ofbaseis16, the wide-character code representations of `0x' or `0X' may optionally precedethe sequence of letters and digits, following the sign if present.
The subject sequence is defined as the longest initial subsequence of theinput wide character string, starting with the first non-white-space wide-character code, thatis of the expected form. The subject sequence contains no wide-character codesif the input wide character string is empty or consists entirely of white-spacewide-character code, or if the first non-white-space wide-character code is other thana sign or a permissible letter or digit.
If the subject sequence has the expected form and the value ofbase is0, the sequence of wide-character codes starting with the firstdigit is interpreted as an integer constant. If the subject sequence hasthe expected form and the value ofbase is between2 and36, it is used as the base for conversion, ascribing to eachletter its value as given above. If the subject sequence begins witha minus sign (-), the value resulting from the conversion is negated.A pointer to the final wide character string is stored in theobject pointed to byendptr, provided thatendptr is not anull pointer.
If the subject sequence is empty or does not have the expectedform, no conversion is performed; the value ofnptr is stored inthe object pointed to byendptr, provided thatendptr is nota null pointer.
These functions do not change the setting oferrno if successful.
Since 0, {LONG_MIN} or {LLONG_MIN}, and {LONG_MAX} or {LLONG_MAX} are returned onerror and are also valid returns on success, an application wanting tocheck for error situations should seterrno to 0, call one of thesefunctions, then checkerrno.
Thewstol() function is equivalent towcstol().
Thewatol() function is equivalent towstol(str,(wchar_t **)NULL, 10).
Thewatoll() function is the long-long (double long) version ofwatol().
Thewatoi() function is equivalent to(int)watol( ).
Upon successful completion, these functions return the converted value, if any. Ifno conversion could be performed, 0 is returned anderrno may beset to indicate the error. If the correct value is outside therange of representable values, {LONG_MIN}, {LONG_MAX}, {LLONG_MIN}, or {LLONG_MAX} is returned (according tothe sign of the value), anderrno is set toERANGE.
These functions will fail if:
The value ofbase is not supported.
The value to be returned is not representable.
These functions may fail if:
No conversion could be performed.
Seeattributes(5) for descriptions of the following attributes:
|
iswalpha(3C),iswspace(3C),scanf(3C),wcstod(3C),attributes(5),standards(5)
Truncation fromlong long tolong can take place upon assignment or byan explicit cast.
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices |   |