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

CKTIS / C

wcsncpy — copie limitée de caractères larges

wcsncpy copie des éléments wchar_t et complète les résultats plus courts avec des zéros, sans garantir la terminaison de la chaîne.

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

Syntaxe

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

wcsncpy, déclaré dans <wchar.h>, copie de s2 vers s1. La limite n compte les éléments wchar_t, et non les octets. La fonction renvoie s1.

Si la source est plus courte, des éléments L'\0' sont ajoutés jusqu’à ce que exactement n éléments aient été écrits. Si les n premiers éléments ne contiennent aucun zéro, le résultat n’est pas terminé.

La destination doit pouvoir contenir n éléments ; la source doit être lisible jusqu’à son premier zéro ou sur n éléments. Le chevauchement des zones copiées entraîne un comportement indéfini. La limite ne vérifie pas la capacité de la destination.

Exemples

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

Résultat

padding: 1 1
prefix: 1 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