KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

wcsncpy — begrensd kopiëren van brede tekens

wcsncpy kopieert wchar_t-elementen en vult kortere resultaten aan met nullen, maar garandeert niet dat de tekenreeks wordt beëindigd.

Versie: 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 uit <wchar.h> kopieert van s2 naar s1. De grens n telt wchar_t-elementen, geen bytes. De functie geeft s1 terug.

Is de bron korter, dan worden L'\0'-elementen toegevoegd totdat precies n elementen zijn geschreven. Bevatten de eerste n elementen geen nul, dan is het resultaat niet beëindigd.

De bestemming moet ruimte bieden aan n elementen; de bron moet leesbaar zijn tot de eerste nul of gedurende n elementen. Overlappende kopieergebieden veroorzaken ongedefinieerd gedrag. De grens controleert de capaciteit van de bestemming niet.

Voorbeelden

#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;
}

Resultaat

padding: 1 1
prefix: 1 1

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen