Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

wcsncpy — copia limitata di caratteri wide

wcsncpy copia elementi wchar_t e riempie con zeri i risultati più brevi, ma non garantisce la terminazione della stringa.

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

Sintassi

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

wcsncpy, da <wchar.h>, copia da s2 a s1. Il limite n conta gli elementi wchar_t, non i byte. La funzione restituisce s1.

Se la sorgente è più corta, vengono aggiunti elementi L'\0' finché non sono stati scritti esattamente n elementi. Se i primi n elementi non contengono zero, il risultato non è terminato.

La destinazione deve poter contenere n elementi; la sorgente deve essere leggibile fino al primo zero oppure per n elementi. La sovrapposizione delle aree copiate causa un comportamento indefinito. Il limite non controlla la capacità della destinazione.

Esempi

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

Risultato

padding: 1 1
prefix: 1 1

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti