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