### wcscpy -- Copy Wide-Character Strings

Format

>     #include <wcstr.h>
>     wchar_t *wcscpy(wchar_t *string1, const wchar_t *string2);

Language Level: XPG4
wcscpy copies the contents of string2 (including the ending wchar_t null character) into string1.

wcscpy operates on null-terminated wchar_t strings; string arguments to this function should contain a wchar_t null character marking the end of the string.

Boundary checking is not performed.

Return Value
wcscpy returns a pointer to string1.

Example
This example copies the contents of source to destination.

    #include <stdio.h>
    #include <wcstr.h>

    #define SIZE    40

    int main(void)
    {
      wchar_t source[ SIZE ] = L"This is the source string";
      wchar_t destination[ SIZE ] = L"And this is the destination string";
      wchar_t * return_string;

      printf( "destination is originally = \"%ls\"\n", destination );
      return_string = wcscpy( destination, source );
      printf( "After wcscpy, destination becomes \"%ls\"\n", return_string);
      return 0;

      /**********************************************************************
         The output should be:

         destination is originally = "And this is the destination string"
         After wcscpy, destination becomes "This is the source string"
      **********************************************************************/
    }

strcpy -- Copy Strings
strdup -- Duplicate String
strncpy -- Copy Strings
wcscat -- Concatenate Wide-Character Strings
wcschr -- Search for Wide Character
wcscmp -- Compare Wide-Character Strings
wcscspn -- Find Offset of First Wide-Character Match
wcslen -- Calculate Length of Wide-Character String
wcsncpy -- Copy Wide-Character Strings
<wcstr.h>