Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

strndup — dinamično dodeljena kopija z omejeno dolžino

strndup ustvari samostojen niz iz največ prvih size znakov polja in doda ničelni zaključek. Preverite rezultat in ga sprostite s funkcijo free.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

strndup, deklarirana v <string.h>, ustvari kopijo v pomnilniku, dodeljenem, kot da bi uporabili malloc. Iz s kopira največ size znakov in se ustavi prej, če naleti na \0. Rezultat se vedno konča z \0; omejitev tega zaključnega znaka ne vključuje.

Vir ni treba, da je zaključen z ničelnim znakom, če vsebuje vsaj size berljivih znakov. Sicer mora biti zaključni znak v dostopnem delu pomnilnika, še preden je dosežena omejitev. Omejitev ne popravi neveljavnega kazalca. Če se je kopiranje ustavilo prej, ne predpostavljajte, da ima rezultat kapaciteto size + 1.

Če dodelitev pomnilnika ne uspe, funkcija vrne NULL. Pred uporabo preverite rezultat, uspešno ustvarjeno kopijo pa sprostite s funkcijo free. Za razliko od strdup funkcija strndup omeji število kopiranih znakov.

Funkcija je del C23. Zastavica prevajalnika v repozitoriju ne dokazuje, da je na voljo v produkcijskem izvajalnem okolju; potrebna sta tudi ustrezna glava in podpora knjižnice. Primer namenoma uporablja polje brez zaključnega znaka.

Primeri

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

Rezultat

hel

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri