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/wcsxfrm.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/wcsxfrm.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/wcsxfrm.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/wcsxfrm.html on line 8

wcscxfrm()

Transform one wide-character string into another, to a given length

Synopsis:

#include <wchar.h>

int wcscfrm( wchar_t * ws1,
             const wchar_t * ws2,
             size_t n );

Arguments:

ws1
The string that you want to transform.
ws2
The string that you want to place in dst.
n
The maximum number of characters to transform.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The wcsxfrm() function transforms the string pointed to by ws2 to the buffer pointed to by ws1, to a maximum of n wide-characters, including the terminating null. The two strings shouldn't overlap.

A call to wcscmp() returns the same result for two strings transformed by wcsxfrm() as wcscoll() would return for the original versions of the strings.


Note: This function doesn't report errors in its returns; set errno to 0, call wcsxfrm(), and then check errno again.

Returns:

The length of the transformed wide-character string. If this value is greater than n, the contents of ws1 are indeterminate.

Classification:

ANSI, POSIX 1003.1

wcscxfrm()

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

setlocale(), strxfrm()


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/wcsxfrm.html on line 139

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/wcsxfrm.html on line 139