WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

wcscpy — eine Wide-Character-Zeichenkette kopieren

wcscpy kopiert eine wchar_t-Zeichenkette einschließlich ihres Abschlusszeichens. Der Zielpuffer muss groß genug sein; die kopierten Speicherbereiche dürfen sich nicht überlappen.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <wchar.h>
wchar_t *wcscpy(wchar_t * restrict s1, const wchar_t * restrict s2);

wcscpy, deklariert in <wchar.h>, kopiert die Zeichenkette von s2 nach s1, einschließlich des abschließenden L'\0'. Die Funktion gibt s1 zurück, nicht die Länge der Kopie.

Das Ziel muss beschreibbar sein und mindestens wcslen(s2) + 1 Elemente vom Typ wchar_t aufnehmen können, nicht Bytes. Die Quelle muss terminiert sein. Ein zu kleiner Puffer, ungültige Zeiger oder überlappende kopierte Speicherbereiche führen zu undefiniertem Verhalten.

Die Funktion erhält keine Pufferkapazität und führt keine Zeichenkodierungskonvertierung durch. Das Beispiel reserviert auch Platz für das Abschlusszeichen; es gibt die Länge und das Ergebnis des Vergleichs des zurückgegebenen Zeigers mit dst aus.

Beispiele

#include <stdio.h>
#include <wchar.h>

int main(void)
{
    const wchar_t src[] = L"Hello";
    wchar_t dst[sizeof src / sizeof src[0]];

    wchar_t *result = wcscpy(dst, src);
    printf("length=%zu, same_pointer=%d\n",
           wcslen(dst), result == dst);
    return 0;
}

Ergebnis

length=5, same_pointer=1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen