WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

wcsncpy — begrenztes Kopieren weiter Zeichen

wcsncpy kopiert wchar_t-Elemente und füllt kürzere Ergebnisse mit Nullzeichen auf, garantiert aber keine Terminierung als Zeichenkette.

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

Syntax

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

wcsncpy aus <wchar.h> kopiert von s2 nach s1. Die Grenze n zählt wchar_t-Elemente, nicht Bytes. Die Funktion gibt s1 zurück.

Ist die Quelle kürzer, werden so lange L'\0'-Elemente angefügt, bis genau n Elemente geschrieben wurden. Enthalten die ersten n Elemente kein Nullzeichen, ist das Ergebnis nicht terminiert.

Das Ziel muss Platz für n Elemente bieten; die Quelle muss bis zu ihrem ersten Nullzeichen oder für n Elemente lesbar sein. Überlappende Kopierbereiche führen zu undefiniertem Verhalten. Die Grenze prüft nicht die Kapazität des Ziels.

Beispiele

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

int main(void)
{
    wchar_t padded[4];
    wchar_t cut[2];

    wcsncpy(padded, L"AB", 4);
    wcsncpy(cut, L"ABC", 2);

    printf("padding: %d %d\n",
           padded[2] == L'\0', padded[3] == L'\0');
    printf("prefix: %d %d\n", cut[0] == L'A', cut[1] == L'B');
    return 0;
}

Ergebnis

padding: 1 1
prefix: 1 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