wcscpy, wcscpy_s

1) Kopiert die breite Zeichenkette, auf die src zeigt (einschließlich des abschließenden Null-Breitzeichens), in das Breitzeichen-Array, auf das dest zeigt. Das Verhalten ist undefiniert, wenn das dest -Array nicht groß genug ist. Das Verhalten ist undefiniert, wenn sich die Zeichenketten überlappen.

2) Gleich wie (1) , außer dass es den Rest des Zielarrays mit nicht spezifizierten Werten überschreiben kann und dass die folgenden Fehler zur Laufzeit erkannt werden und die aktuell installierte Constraint-Handler -Funktion aufrufen:

• src oder dest ist ein Nullzeiger
• destsz ist Null oder größer als RSIZE_MAX / sizeof ( wchar_t )
• destsz ist kleiner oder gleich wcsnlen_s ( src, destsz ) , mit anderen Worten, es würde ein Abschneiden auftreten
• Überlappung zwischen Quell- und Zielzeichenfolge würde auftreten

Wie bei allen grenzgeprüften Funktionen ist wcscpy_s nur garantiert verfügbar, wenn __STDC_LIB_EXT1__ durch die Implementierung definiert ist und wenn der Benutzer __STDC_WANT_LIB_EXT1__ auf die Integer-Konstante 1 setzt, bevor <wchar.h> eingebunden wird.

1) gibt eine Kopie von dest zurück

2) gibt bei Erfolg Null zurück, gibt bei Fehler einen Wert ungleich Null zurück. Außerdem wird bei Fehler L ' \0 ' in dest [ 0 ] geschrieben (sofern dest kein Nullzeiger ist oder destsz nicht Null oder größer als RMAX_SIZE / sizeof ( wchar_t ) ist).

#include <locale.h>
#include <stdio.h>
#include <wchar.h>
int main(void)
{
    wchar_t* src = L"犬 means dog";
//  src[0] = L'狗' ; // this would be undefined behavior
    wchar_t dst[wcslen(src) + 1]; // +1 for the null terminator
    wcscpy(dst, src);
    dst[0] = L'狗'; // OK
    setlocale(LC_ALL, "en_US.utf8");
    printf("src = %ls\ndst = %ls\n", src, dst);
}

src = 犬 means dog
dst = 狗 means dog