Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

strncpy — cópia com preenchimento por zeros

strncpy escreve n bytes e preenche com zeros os dados mais curtos. Não garante que o resultado termine com '\0'.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <string.h>
char *strncpy(char * restrict s1, const char * restrict s2, size_t n);

strncpy, declarada em <string.h>, copia de s2 para s1 e devolve s1. Se encontrar '\0' antes do limite n, preenche o resultado com zeros até perfazer exatamente n bytes.

Se os primeiros n bytes da origem não contiverem '\0', o resultado não tem terminador. n não verifica automaticamente a capacidade: o destino tem de poder armazenar n bytes, e a origem tem de ser legível até ao primeiro '\0' ou durante n bytes. A sobreposição das regiões causa comportamento indefinido.

Não passes um resultado sem terminador a %s sem limite. O exemplo mostra o preenchimento e o truncamento; %.*s limita a leitura de truncated.

Exemplos

#include <stdio.h>
#include <string.h>

int main(void)
{
    char padded[5];
    char truncated[3];

    strncpy(padded, "Hi", sizeof padded);
    strncpy(truncated, "Hello", sizeof truncated);

    printf("padded: %s; zero padding: %d %d %d\n",
           padded, padded[2] == '\0', padded[3] == '\0',
           padded[4] == '\0');
    printf("truncated: %.*s\n", (int)sizeof truncated, truncated);
    return 0;
}

Resultado

padded: Hi; zero padding: 1 1 1
truncated: Hel

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes