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.