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

CKTIS / C

strndup — cópia dinâmica com comprimento limitado

strndup cria uma cadeia independente a partir de, no máximo, os primeiros size caracteres de um array e acrescenta um terminador nulo. Verifique o resultado e liberte-o com free.

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

Sintaxe

#include <string.h>
char *strndup(const char *s, size_t size);

strndup, declarada em <string.h>, cria uma cópia em memória alocada como se fosse por malloc. Copia, no máximo, size caracteres de s, parando antes se encontrar \0. O resultado termina sempre com \0; o limite não inclui esse terminador.

A origem não tem de estar terminada em nulo se contiver pelo menos size caracteres legíveis. Caso contrário, tem de existir um terminador na zona de memória acessível antes de se atingir o limite. O limite não corrige um ponteiro inválido. Não suponha que o resultado tem capacidade size + 1 se a cópia tiver parado antes.

Se a alocação falhar, a função devolve NULL. Verifique o resultado antes de o utilizar e liberte com free uma cópia criada com sucesso. Ao contrário de strdup, strndup limita o número de caracteres copiados.

A função faz parte de C23. A opção do compilador no repositório não comprova a sua disponibilidade no ambiente de execução de produção; também são necessários cabeçalhos adequados e suporte da biblioteca. O exemplo utiliza deliberadamente um array sem terminador.

Exemplos

#define _POSIX_C_SOURCE 200809L
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main(void)
{
    const char data[] = {'h', 'e', 'l', 'l', 'o'};
    char *copy = strndup(data, 3);
    if (copy == NULL) return EXIT_FAILURE;
    puts(copy);
    free(copy);
    return EXIT_SUCCESS;
}

Resultado

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