| 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 a wide-character code to a character (restartable)
#include <stdio.h>size_twcrtomb(char *restricts,wchar_twc,mbstate_t *restrictps);
Ifs is a null pointer, thewcrtomb() function is equivalent tothe call:
wcrtomb(buf, L'\0', ps)
wherebuf is an internal buffer.
Ifs is not a null pointer, thewcrtomb() function determines thenumber of bytes needed to represent the character that corresponds to thewide-character given bywc (including any shift sequences), and stores the resultingbytes in the array whose first element is pointed to bys. AtmostMB_CUR_MAX bytes are stored. Ifwc is a null wide-character,a null byte is stored, preceded by any shift sequence needed torestore the initial shift state. The resulting state described is the initialconversion state.
Ifps is a null pointer, thewcrtomb() function uses its owninternalmbstate_t object, which is initialized at program startup to the initialconversion state. Otherwise, thembstate_t object pointed to byps is used to completely describe the current conversion state of theassociated character sequence. Solaris will behave as if no function defined inthe Solaris Reference Manual callswcrtomb().
The behavior of this function is affected by theLC_CTYPE category ofthe current locale. Seeenviron(5).
Thewcrtomb() function returns the number of bytes stored in the arrayobject (including any shift sequences). Whenwc is not a validwide-character, an encoding error occurs. In this case, the function storesthe value of the macrosEILSEQ inerrno and returns(size_t)-1; theconversion state is undefined.
Thewcrtomb() function may fail if:
Theps argument points to an object that contains an invalid conversion state.
Invalid wide-character code is detected.
Ifps is not a null pointer,wcrtomb() uses thembstate_t objectpointed to byps and the function can be used safely inmultithreaded applications, as long assetlocale(3C) is not being called to changethe locale. Ifps is a null pointer,wcrtomb() uses its internalmbstate_t object and the function is Unsafe in multithreaded applications.
Seeattributes(5) for descriptions of the following attributes:
|
mbsinit(3C),setlocale(3C),attributes(5),standards(5),environ(5)
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices | ![]() ![]() |