| /* |
| FUNCTION |
| <<wcsxfrm>>---locale-specific wide-character string transformation |
| |
| INDEX |
| wcsxfrm |
| |
| ANSI_SYNOPSIS |
| #include <wchar.h> |
| int wcsxfrm(wchar_t *<[stra]>, const wchar_t * <[strb]>, size_t <[n]>); |
| |
| TRAD_SYNOPSIS |
| #include <wchar.h> |
| size_t wcsxfrm(<[stra]>, <[strb]>, <[n]>) |
| wchar_t *<[stra]>; |
| wchar_t *<[strb]>; |
| size_t <[n]> |
| |
| DESCRIPTION |
| <<wcsxfrm>> transforms the wide-character string pointed to by |
| <[strb]> to the wide-character string pointed to by <[stra]>, |
| Comparing two transformed wide strings with <<wcscmp>> should return |
| the same result as comparing the original strings with <<wcscoll>>. |
| No more than <[n]> wide characters are transformed, including the |
| trailing null character. |
| |
| If <[n]> is 0, <[stra]> may be a NULL pointer. |
| |
| The current implementation of <<wcsxfrm>> simply uses <<wcslcpy>> |
| and does not support any language-specific transformations. |
| |
| RETURNS |
| <<wcsxfrm>> returns the length of the transformed wide character |
| string. if the return value is greater or equal to <[n]>, the |
| content of <[stra]> is undefined. |
| |
| PORTABILITY |
| <<wcsxfrm>> is ISO/IEC 9899/AMD1:1995 (ISO C). |
| */ |
| |
| #include <_ansi.h> |
| #include <wchar.h> |
| |
| size_t |
| _DEFUN (wcsxfrm, (a, b, n), |
| wchar_t *a _AND |
| _CONST wchar_t *b _AND |
| size_t n) |
| |
| { |
| return wcslcpy (a, b, n); |
| } |