newlib-2.4.0: wide character strings

git-svn-id: svn://kolibrios.org@6557 a494cfbc-eb01-0410-851d-a64ba20cac60

contrib/sdk/sources/newlib/libc/string/wcpcpy.c

@@ -0,0 +1,41 @@
+/*
+FUNCTION
+	<<wcpcpy>>---copy a wide-character string returning a pointer to its end
+
+ANSI_SYNOPSIS
+	#include <wchar.h>
+	wchar_t *wcpcpy(wchar_t *<[s1]>, const wchar_t *<[s2]>);
+
+TRAD_SYNOPSIS
+	wchar_t *wcpcpy(<[s1]>, <[s2]>
+	wchar_t *__restrict <[s1]>;
+	const wchar_t *__restrict <[s2]>;
+
+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 *
+_DEFUN (wcpcpy, (s1, s2),
+	wchar_t *__restrict s1 _AND
+	_CONST wchar_t *__restrict s2)
+{
+  while ((*s1++ = *s2++))
+    ;
+  return --s1;
+}