Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje