| 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)
- wide-character string operations
#include <wchar.h> int wcscasecmp(const wchar_t *ws1, const wchar_t *ws2);
int wcsncasecmp(const wchar_tws1*, const wchar_tws2*, size_tn);
wchar_t *wcscat(wchar_t *ws1,const wchar_t *ws2);
wchar_t *wcsncat(wchar_t *restrictws1,const wchar_t *restrictws2,size_tn);
intwcscmp(const wchar_t *ws1,const wchar_t *ws2);
intwcsncmp(const wchar_t *ws1,const wchar_t *ws2,size_tn);
wchar_t *wcscpy(wchar_t *ws1,const wchar_t *ws2);
wchar_t *wcscpy(wchar_t *restrictws1, const wchar_t *restrictws2);
wchar_t *wcsncpy(wchar_t *restrictws1,const wchar_t *restrictws2,size_tn);
wchar_t *wcpncpy(wchar_t restrict *ws1, const wchar_t *restrictws2, size_tn);
wchar_t *wcsdup(const wchar_t *s);
size_twcslen(const wchar_t *ws);
size_t wcsnlen(const wchar_t *ws, size_tmaxlen);
wchar_t *wcschr(const wchar_t *ws,wchar_twc);
wchar_t *wcsrchr(const wchar_t *ws,wchar_twc);
wchar_t *wcspbrk(const wchar_t *ws1,const wchar_t *ws2);
wchar_t *wcswcs(const wchar_t *ws1,const wchar_t *ws2);
size_twcsspn(const wchar_t *ws1,const wchar_t *ws2);
size_twcscspn(const wchar_t *ws1,const wchar_t *ws2);
wchar_t *wcstok(wchar_t *restrictws1,const wchar_t *restrictws2);
wchar_t *wcstok(wchar_t *ws1,const wchar_t *ws2,wchar_t **ptr);
#include <widec.h>wchar_t *wscat(wchar_t *ws1,const wchar_t *ws2);
wchar_t *wsncat(wchar_t *ws1,const wchar_t *ws2,size_tn);
intwscmp(const wchar_t *ws1,const wchar_t *ws2);
intwsncmp(const wchar_t *ws1,const wchar_t *ws2,size_tn);
wchar_t *wscpy(wchar_t *ws1,const wchar_t *ws2);
wchar_t *wsncpy(wchar_t *ws1,const wchar_t *ws2,size_tn);
size_twslen(const wchar_t *ws);
wchar_t *wschr(const wchar_t *ws,wchat_twc);
wchar_t *wsrchr(const wchar_t *ws,wchat_twc);
wchar_t *wspbrk(const wchar_t *ws1,const wchar_t *ws2);
size_twsspn(const wchar_t *ws1,const wchar_t *ws2);
size_twscspn(const wchar_t *ws1,const wchar_t *ws2);
wchar_t *wstok(wchar_t *ws1,const wchar_t *ws2);
wchar_t *windex(const wchar_t *ws,wchar_twc);
wchar_t *wrindex(const wchar_t *ws,wchar_twc);
#include <wchar.h>const wchar_t *wcschr(const wchar_t *ws,wchar_twc);
const wchar_t *wcspbrk(const wchar_t *ws1,const wchar_t *ws2);
const wchar_t *wcsrchr(const wchar_t *ws,wchar_twc);
#include <cwchar>wchar_t *std::wcschr(wchar_t *ws,wchar_twc);
wchar_t *std::wcspbrk(wchar_t *ws1,const wchar_t *ws2);
wchar_t *std::wcsrchr(wchar_t *ws,wchar_twc);
These functions operate on wide-character strings terminated bywchar_tNULL characters. Duringappending or copying, these routines do not check for an overflow conditionof the receiving string. In the following,ws,ws1, andws2 pointto wide-character strings terminated by awchar_t NULL.
Thewcscasecmp() function is the wide-character equivalent of thestrcasecmp(3C) function. Itcompares the wide-character string pointed to byws1 to the wide-character stringpointed to byws2, ignoring case differences. It returns 0 if thewide-character strings atws1 is equal tows2 except for case differences.It returns a positive integer ifws1 is greater thanws2 anda negative integer ifws1 is smaller thanws2, ignoring case.
Thewcsncasecmp() function is the wide-character equivalent of thestrncasecmp(3C) function. Itcompares at mostn wide-characters from the wide-character string pointed to byws1to the wide-character string pointed to byws2, while ignoring differences incase. It returns 0 if the wide-character strings atws1 andws2,truncated to at most lengthn, are equal except for case distinctions. Itreturns a positive integer if truncatedws1 is greater thanws2 anda negative integer if truncatedws1 is smaller thanws2, ignoring case.
Thewcscat() andwscat() functions append a copy of the wide-character stringpointed to byws2 (including the terminating null wide-character code) to theend of the wide-character string pointed to byws1. The initial wide-character codeofws2 overwrites the null wide-character code at the end ofws1.If copying takes place between objects that overlap, the behavior is undefined.Both functions returns1; no return value is reserved to indicate an error.
Thewcsncat() andwsncat() functions append not more thann wide-character codes(a null wide-character code and wide-character codes that follow it are notappended) from the array pointed to byws2 to the end of thewide-character string pointed to byws1. The initial wide-character code ofws2overwrites the null wide-character code at the end ofws1. A terminatingnull wide-character code is always appended to the result. Both functions returnws1;no return value is reserved to indicate an error.
Thewcscmp() andwscmp() functions compare the wide-character string pointed to byws1 to the wide-character string pointed to byws2. The sign ofa non-zero return value is determined by the sign of the difference betweenthe values of the first pair of wide-character codes that differ inthe objects being compared. Upon completion, both functions return an integer greaterthan, equal to, or less than zero, if the wide-character string pointedto byws1 is greater than, equal to, or less than the wide-characterstring pointed to byws2.
Thewcsncmp() andwsncmp() functions compare not more thann wide-character codes(wide-character codes that follow a null wide character code are not compared)from the array pointed to byws1 to the array pointed to byws2. The sign of a non-zero return value is determined by thesign of the difference between the values of the first pair ofwide-character codes that differ in the objects being compared. Upon successful completion,both functions return an integer greater than, equal to, or less than zero,if the possibly null-terminated array pointed to byws1 is greater than,equal to, or less than the possibly null-terminated array pointed to byws2.
Thewcscpy(),wscpy(), andwcpcpy() functions copy the wide-character string pointed tobyws2 (including the terminating null wide-character code) into the array pointedto byws1. If copying takes place between objects that overlap, the behavioris undefined.
Thewcscpy() andwscpy() functions returnws1. Thewcpcpy() function returns apointer to the terminating null wide-character code copied intows1.
Thewcsncpy(),wsncpy(), andwcpncpy() functions copy not more thann wide-charactercodes (wide-character codes that follow a null wide character code are notcopied) from the array pointed to byws2 to the array pointed tobyws1. If copying takes place between objects that overlap, the behavioris undefined.
If the array pointed to byws2 is a wide-character string thatis shorter thann wide-character codes, null wide-character codes are appended tothe copy in the array pointed to byws1, until a totaln wide-character codes are written. Thewcsncpy() andwsncpy() functions returnws1. Thewcpncpy() function returns a pointer to the last wide character written.
Thewcsdup() function is the wide-character equivalent of thestrdup(3C) function. Itreturns a pointer to a new wide-character string whose initial contents is aduplicate of the wide-character string pointed to bys. Memory for thenew wide-character string is allocated withmalloc(3C) and can be freed with acall tofree(3C). A null pointer is returned anderrno set toENOMEM if there is insufficient memory available for the duplicate string.
Thewcslen() andwslen() functions compute the number of wide-character codes inthe wide-character string to whichws points, not including the terminating nullwide-character code. Both functions returnws; no return value is reserved to indicatean error.
Thewcsnlen() is the wide-character equivalent of thestrnlen(3C) function. It returnsthe number of wide-characters in the string pointed to byws, notincluding the terminating null wide-character code but at mostmaxlen, while neverlooking beyond the firstmaxlen characters. It returnsmaxlen if there isno terminating null wide-character code among the firstmaxlen wide characters pointed tobyws.
Thewcschr() andwschr() functions locate the first occurrence ofwc inthe wide-character string pointed to byws. The value ofwc mustbe a character representable as a typewchar_t and must be awide-character code corresponding to a valid character in the current locale. Theterminating null wide-character code is considered to be part of the wide-characterstring. Upon completion, both functions return a pointer to the wide-character code,or a null pointer if the wide-character code is not found.
Thewcsrchr() andwsrchr() functions locate the last occurrence ofwc inthe wide-character string pointed to byws. The value ofwc mustbe a character representable as a typewchar_t and must be awide-character code corresponding to a valid character in the current locale. Theterminating null wide-character code is considered to be part of the wide-characterstring. Upon successful completion, both functions return a pointer to the wide-charactercode, or a null pointer ifwc does not occur in the wide-characterstring.
Thewindex() andwrindex() functions behave the same aswschr() andwsrchr(),respectively.
Thewcspbrk() andwspbrk() functions locate the first occurrence in the widecharacter string pointed to byws1 of any wide-character code from thewide-character string pointed to byws2. Upon successful completion, the function returns apointer to the wide-character code, or a null pointer if no wide-charactercode fromws2 occurs inws1.
Thewcswcs() function locates the first occurrence in the wide-character string pointedto byws1 of the sequence of wide-character codes (excluding the terminatingnull wide-character code) in the wide-character string pointed to byws2. Upon successfulcompletion, the function returns a pointer to the located wide-character string, ora null pointer if the wide-character string is not found. Ifws2points to a wide-character string with zero length, the function returnsws1.
Thewcsspn() andwsspn() functions compute the length of the maximum initialsegment of the wide-character string pointed to byws1 which consists entirelyof wide-character codes from the wide-character string pointed to byws2. Bothfunctions return the lengthws1; no return value is reserved to indicatean error.
Thewcscspn() andwscspn() functions compute the length of the maximum initialsegment of the wide-character string pointed to byws1 which consists entirelyof wide-character codesnot from the wide-character string pointed to byws2. Bothfunctions return the length of the initial substring ofws1; no returnvalue is reserved to indicate an error.
A sequence of calls to thewcstok() andwstok() functions break thewide-character string pointed to byws1 into a sequence of tokens, eachof which is delimited by a wide-character code from the wide-character stringpointed to byws2.
The third argument points to a caller-providedwchar_t pointer into which thewcstok() function stores information necessary for it to continue scanning the samewide-character string. This argument is not available with the XPG4 and SUSversions ofwcstok(), nor is it available with thewstok() function. Seestandards(5).
The first call in the sequence hasws1 as its first argument,and is followed by calls with a null pointer as their firstargument. The separator string pointed to byws2 may be different fromcall to call.
The first call in the sequence searches the wide-character string pointed tobyws1 for the first wide-character code that isnot contained inthe current separator string pointed to byws2. If no such wide-charactercode is found, then there are no tokens in the wide-character string pointedto byws1, andwcstok() andwstok() return a null pointer. Ifsuch a wide-character code is found, it is the start of thefirst token.
Thewcstok() andwstok() functions then search from that point for awide-character code thatis contained in the current separator string. If nosuch wide-character code is found, the current token extends to the endof the wide-character string pointed to byws1, and subsequent searches for atoken will return a null pointer. If such a wide-character code isfound, it is overwritten by a null wide character, which terminates thecurrent token. Thewcstok() andwstok() functions save a pointer to the followingwide-character code, from which the next search for a token will start.
Each subsequent call, with a null pointer as the value of thefirst argument, starts searching from the saved pointer and behaves as describedabove.
Upon successful completion, both functions return a pointer to the first wide-charactercode of a token. Otherwise, if there is no token, a nullpointer is returned.
Seeattributes(5) for descriptions of the following attributes:
|
Forwcscat(),wcsncat(),wcscmp(),wcsncmp(),wcscpy(),wcsncpy(),wcslen(),wcschr(),wcsrchr(),wcspbrk(),wcswcs(),wcsspn(),wcscspn(), andwcstok(), seestandards(5).
malloc(3C),string(3C),wcswidth(3C),wcwidth(3C),attributes(5),standards(5)
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices |   |