CKTIS / C
strndup — dynamiczna kopia z ograniczeniem długości
strndup tworzy niezależny napis z najwyżej size początkowych znaków tablicy, dodając terminator zerowy. Wynik wymaga sprawdzenia i zwolnienia przez free.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <string.h>
char *strndup(const char *s, size_t size);strndup, zadeklarowana w <string.h>, tworzy kopię w pamięci przydzielonej jak przez malloc. Kopiuje najwyżej size znaków z s, kończąc wcześniej na \0. Wynik zawsze ma terminator \0; limit nie obejmuje tego terminatora.
Źródło nie musi być zakończone zerem, jeśli zawiera co najmniej size dostępnych do odczytu znaków. W przeciwnym razie terminator musi wystąpić w dostępnym obszarze przed osiągnięciem limitu. Limit nie naprawia nieprawidłowego wskaźnika. Nie zakładaj, że wynik ma pojemność size + 1, gdy kopiowanie zakończyło się wcześniej.
Przy nieudanej alokacji funkcja zwraca NULL. Sprawdź wynik przed użyciem i zwolnij udaną kopię przez free. W odróżnieniu od strdup, strndup ogranicza liczbę kopiowanych znaków.
Funkcja należy do C23. Flaga kompilatora w repozytorium nie potwierdza dostępności w produkcyjnej bibliotece wykonawczej; potrzebne są również odpowiednie nagłówki i biblioteka. Przykład celowo używa tablicy bez terminatora.
Przykłady
#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;
}
Wynik
hel
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.