Subversion Repositories Kolibri OS

Compare Revisions

Regard whitespace Rev 6556 → Rev 6557

/contrib/sdk/sources/newlib/libc/string/wcsxfrm.c
0,0 → 1,53
/*
FUNCTION
<<wcsxfrm>>---locale-specific wide-character string transformation
INDEX
wcsxfrm
 
ANSI_SYNOPSIS
#include <wchar.h>
int wcsxfrm(wchar_t *__restrict <[stra]>,
const wchar_t *__restrict <[strb]>, size_t <[n]>);
 
TRAD_SYNOPSIS
#include <wchar.h>
size_t wcsxfrm(<[stra]>, <[strb]>, <[n]>)
wchar_t *__restrict <[stra]>;
wchar_t *__restrict <[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 *__restrict a _AND
_CONST wchar_t *__restrict b _AND
size_t n)
 
{
return wcslcpy (a, b, n);
}