CKTIS / C
wcscpy — copiare una stringa di caratteri wide
wcscpy copia una stringa wchar_t, compreso il suo terminatore. Il buffer di destinazione deve essere abbastanza grande e le aree copiate non devono sovrapporsi.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <wchar.h>
wchar_t *wcscpy(wchar_t * restrict s1, const wchar_t * restrict s2);wcscpy, dichiarata in <wchar.h>, copia la stringa da s2 a s1, compreso il L'\0' finale. Restituisce s1, non la lunghezza della copia.
La destinazione deve essere scrivibile e contenere almeno wcslen(s2) + 1 elementi di tipo wchar_t, non byte. La sorgente deve essere terminata. Un buffer troppo piccolo, puntatori non validi o aree copiate sovrapposte causano un comportamento indefinito.
La funzione non riceve la capacità del buffer e non esegue conversioni di codifica. L’esempio riserva spazio anche per il terminatore; stampa la lunghezza e il risultato del confronto tra il puntatore restituito e dst.
Esempi
#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;
}Risultato
length=5, same_pointer=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.