CKTIS / C
strndup — dynamicky alokovaná kópia s obmedzenou dĺžkou
strndup vytvorí nezávislý reťazec z najviac prvých size znakov poľa a pridá nulový terminátor. Výsledok skontrolujte a uvoľnite pomocou free.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
char *strndup(const char *s, size_t size);strndup, deklarovaná v <string.h>, vytvorí kópiu v pamäti alokovanej tak, ako keby sa použila funkcia malloc. Z s skopíruje najviac size znakov a skončí skôr, ak narazí na \0. Výsledok sa vždy končí znakom \0; limit tento terminátor nezahŕňa.
Zdroj nemusí byť ukončený nulovým znakom, ak obsahuje aspoň size čitateľných znakov. Inak sa musí v prístupnej oblasti pamäte nachádzať terminátor skôr, než sa dosiahne limit. Limit neopraví neplatný ukazovateľ. Ak sa kopírovanie skončilo skôr, nepredpokladajte, že výsledok má kapacitu size + 1.
Pri zlyhaní alokácie funkcia vráti NULL. Pred použitím výsledok skontrolujte a úspešne vytvorenú kópiu uvoľnite pomocou free. Na rozdiel od strdup obmedzuje strndup počet kopírovaných znakov.
Funkcia patrí do C23. Príznak kompilátora v repozitári nedokazuje jej dostupnosť v produkčnom runtime; potrebné sú aj vhodné hlavičkové súbory a podpora knižnice. Príklad zámerne používa pole bez terminátora.
Príklady
#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;
}
Výsledok
hel
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.