Retro68/gcc/newlib/libc/string/wcpcpy.c

36 lines
813 B
C
Raw Normal View History

2017-04-11 21:13:36 +00:00
/*
FUNCTION
<<wcpcpy>>---copy a wide-character string returning a pointer to its end
2018-12-28 15:30:48 +00:00
SYNOPSIS
2017-04-11 21:13:36 +00:00
#include <wchar.h>
wchar_t *wcpcpy(wchar_t *<[s1]>, const wchar_t *<[s2]>);
2017-04-11 21:13:36 +00:00
DESCRIPTION
The <<wcpcpy>> function copies the wide-character string pointed to by
<[s2]> (including the terminating null wide-character code) into the
array pointed to by <[s1]>. If copying takes place between objects that
overlap, the behaviour is undefined.
RETURNS
This function returns a pointer to the end of the destination string,
thus pointing to the trailing '\0'.
PORTABILITY
<<wcpcpy>> is a GNU extension.
No supporting OS subroutines are required.
*/
#include <_ansi.h>
#include <wchar.h>
wchar_t *
2018-12-28 15:30:48 +00:00
wcpcpy (wchar_t *__restrict s1,
const wchar_t *__restrict s2)
2017-04-11 21:13:36 +00:00
{
while ((*s1++ = *s2++))
;
return --s1;
}