wcsncpy, wcsncpy_s

wchar_t* wcsncpy( wchar_t* dest, const wchar_t* src, size_t count );

wchar_t* wcsncpy( wchar_t* restrict dest, const wchar_t* restrict src, size_t count );

errno_t wcsncpy_s( wchar_t* restrict dest, rsize_t destsz,
                   const wchar_t* restrict src, rsize_t count);

Paramètres

Valeur de retour

Notes

En utilisation typique, count est le nombre d'éléments dans le tableau de destination.

Bien que la troncature pour adapter le tampon de destination soit un risque de sécurité et donc une violation de contrainte d'exécution pour wcsncpy_s, il est possible d'obtenir un comportement de troncature en spécifiant count égal à la taille du tableau de destination moins un : il copiera les count premiers caractères larges et ajoutera le terminateur large nul comme toujours :

size_t count = sizeof dst / sizeof *dst;
wcsncpy_s(dst, count, src, count - 1);

Exemple

#include <locale.h>
#include <stdio.h>
#include <wchar.h>
 
int main(void)
{
    const wchar_t src[] = L"わゐ";
    wchar_t dest[6] = {L'あ', L'い', L'う', L'え', L'お'};
 
    wcsncpy(dest, src, 4); // this will copy わゐ and repeat L'\0' two times
 
    puts("The contents of dest are: ");
    setlocale(LC_ALL, "en_US.utf8");

    const long dest_size = sizeof dest / sizeof *dest;
    for(wchar_t* p = dest; p - dest != dest_size; ++p) {
        *p ? printf("%lc ", *p)
           : printf("\\0 ");
    }
}

The contents of dest are:
わ ゐ \0 \0 お \0

Références

Voir aussi