Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

strndup — copia con lunghezza limitata allocata dinamicamente

strndup crea una stringa indipendente dai primi al massimo size caratteri di un array e aggiunge un terminatore nullo. Controlla il risultato e rilascialo con free.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

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

strndup, dichiarata in <string.h>, crea una copia in memoria allocata come se fosse stata usata malloc. Copia al massimo size caratteri da s, fermandosi prima se incontra \0. Il risultato termina sempre con \0; il limite non include questo terminatore.

La sorgente non deve essere terminata da un carattere nullo se contiene almeno size caratteri leggibili. Altrimenti, prima di raggiungere il limite deve esserci un terminatore nell’area di memoria accessibile. Il limite non rende valido un puntatore non valido. Non dare per scontato che il risultato abbia capacità size + 1 se la copia si è fermata prima.

In caso di errore di allocazione, la funzione restituisce NULL. Controlla il risultato prima di usarlo e rilascia con free la copia ottenuta. A differenza di strdup, strndup limita il numero di caratteri copiati.

La funzione fa parte di C23. L’opzione del compilatore nel repository non garantisce che sia disponibile nell’ambiente di esecuzione di produzione; sono necessari anche header adeguati e il supporto della libreria. L’esempio usa intenzionalmente un array senza terminatore.

Esempi

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

Risultato

hel

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti