Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

wcsncpy — copia limitada de caracteres anchos

wcsncpy copia elementos wchar_t y rellena con ceros los resultados más cortos, pero no garantiza la terminación de la cadena.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

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

wcsncpy, de <wchar.h>, copia de s2 a s1. El límite n cuenta elementos wchar_t, no bytes. La función devuelve s1.

Si la fuente es más corta, se añaden elementos L'\0' hasta que se hayan escrito exactamente n elementos. Si los primeros n elementos no contienen ningún cero, el resultado no queda terminado.

El destino debe tener espacio para n elementos; la fuente debe poder leerse hasta su primer cero o durante n elementos. Si las regiones copiadas se solapan, el comportamiento es indefinido. El límite no comprueba la capacidad del destino.

Ejemplos

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

Resultado

padding: 1 1
prefix: 1 1

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes