Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła