CKTIS / C
wcscpy — copier une chaîne de caractères larges
wcscpy copie une chaîne wchar_t, y compris son caractère de fin. Le tampon de destination doit être assez grand et les zones copiées ne doivent pas se chevaucher.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <wchar.h>
wchar_t *wcscpy(wchar_t * restrict s1, const wchar_t * restrict s2);wcscpy, déclarée dans <wchar.h>, copie la chaîne de s2 vers s1, y compris le L'\0' final. Elle renvoie s1, et non la longueur de la copie.
La destination doit être modifiable et pouvoir contenir au moins wcslen(s2) + 1 éléments de type wchar_t, et non des octets. La source doit être terminée. Un tampon trop petit, des pointeurs invalides ou des zones copiées qui se chevauchent entraînent un comportement indéfini.
La fonction ne reçoit aucune capacité de tampon et n’effectue aucune conversion d’encodage. L’exemple réserve aussi de la place pour le caractère de fin ; il affiche la longueur et le résultat de la comparaison entre le pointeur renvoyé et dst.
Exemples
#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;
}Résultat
length=5, same_pointer=1
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.