Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje