| 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)
- string transformation
#include <string.h>size_tstrxfrm(char *restricts1,const char *restricts2,size_tn);
Thestrxfrm() function transforms the string pointed to bys2 and places theresulting string into the array pointed to bys1. The transformation issuch that ifstrcmp(3C) is applied to two transformed strings, it returns avalue greater than, equal to or less than0, corresponding to theresult ofstrcoll(3C) applied to the same two original strings. No more thann bytes are placed into the resulting array pointed to bys1,including the terminating null byte. Ifn is0,s1 ispermitted to be a null pointer. If copying takes place between objects thatoverlap, the behavior is undefined.
Thestrxfrm() function does not change the setting oferrno if successful.
Since no return value is reserved to indicate an error, an applicationwishing to check for error situations should seterrno to 0, thencallstrxfrm(), then checkerrno.
Upon successful completion,strxfrm() returns the length of the transformed string (notincluding the terminating null byte). If the value returned isn ormore, the contents of the array pointed to bys1 are indeterminate.
On error,strxfrm() may seterrno but no return value is reservedto indicate the error.
The transformation function is such that two transformed strings can be orderedbystrcmp(3C) as appropriate to collating sequence information in the program's locale(categoryLC_COLLATE).
The fact that whenn is0,s1 is permitted to bea null pointer, is useful to determine the size of thes1array prior to making the transformation.
Example 1 A sample of using thestrxfm() function.
The value of the following expression is the size of the arrayneeded to hold the transformation of the string pointed to bys.
1 + strxfrm(NULL, s, 0);
LC_COLLATE database forlocale
Seeattributes(5) for descriptions of the following attributes:
|
Thestrxfrm() function can be used safely in a multithreaded application, aslong assetlocale(3C) is not being called to change the locale.
localedef(1),setlocale(3C),strcmp(3C),strcoll(3C),wscoll(3C),attributes(5),environ(5),standards(5)
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices |   |