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);

Parámetros

Valor de retorno

Notas

En uso típico, count es el número de elementos en el arreglo destino.

Aunque el truncamiento para ajustarse al búfer destino es un riesgo de seguridad y por lo tanto una violación de restricción en tiempo de ejecución para wcsncpy_s, es posible obtener el comportamiento de truncamiento especificando count igual al tamaño del arreglo destino menos uno: copiará los primeros count caracteres anchos y agregará el terminador ancho nulo como siempre:

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

Ejemplo

#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

Referencias

Véase también