CKTIS / C
strndup — dynamicky alokovaná kopie s omezenou délkou
strndup vytvoří nezávislý řetězec z nejvýše prvních size znaků pole a přidá nulový terminátor. Výsledek zkontrolujte a uvolněte pomocí free.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <string.h>
char *strndup(const char *s, size_t size);strndup, deklarovaná v <string.h>, vytvoří kopii v paměti alokované, jako by byla použita funkce malloc. Z s zkopíruje nejvýše size znaků a skončí dříve, pokud narazí na \0. Výsledek vždy končí znakem \0; limit tento terminátor nezahrnuje.
Zdroj nemusí být ukončen nulovým znakem, pokud obsahuje alespoň size čitelných znaků. Jinak se musí v přístupné oblasti paměti nacházet terminátor dříve, než je dosaženo limitu. Limit neopraví neplatný ukazatel. Pokud kopírování skončilo dříve, nepředpokládejte, že má výsledek kapacitu size + 1.
Při selhání alokace funkce vrátí NULL. Před použitím výsledek zkontrolujte a úspěšně vytvořenou kopii uvolněte pomocí free. Na rozdíl od strdup omezuje strndup počet kopírovaných znaků.
Funkce patří do C23. Příznak kompilátoru v repozitáři nedokládá její dostupnost v produkčním běhovém prostředí; jsou potřeba také vhodné hlavičkové soubory a podpora knihovny. Příklad záměrně používá pole bez terminátoru.
Pří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ýsledek
hel
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.