Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources