Inne nazwy strdup strndup
Dostępne w pakiecie GNU GCC: strdup strndup
Składnia #include
char *strdup(const char *s);
#define _GNU_SOURCE #include
char *strndup(const char *s, size_t n); char *strdupa(const char *s); char *strndupa(const char *s, size_t n);
Argumenty s - łańcuch do kopiowania n - długość łańcucha
Opis Funkcja strdup() zwraca wskaźnik do nowego łańcucha, który stanowi kopię łańcucha s. Pamięć dla nowego łańcucha jest przydzielana za pomocą malloc() i może być zwolniona za pomocą free().
strdup() może być zaimplementowana za pomocą funkcji malloc(), strlen() oraz strcpy() w poniższy sposób: char* strdup(const char* p) { char* np = (char*)malloc(strlen(p)+1); return np ? strcpy(np, p) : np; }
Funkcja strndup() jest podobna, lecz kopiuje co najwyżej n znaków. Jeśli s jest dłuższe niż n, kopiowane jest tylko n znaków i dodawany jest kończący znak NULL.
strdupa i strndupa są podobne, ale korzystają z alloca() do przydzielania pamięci na bufor. Są one dostępne wyłącznie, gdy używany jest pakiet GNU GCC, i dotyczą ich te same ograniczenia, które opisano w alloca().
Wartość zwracana Funkcja strdup() zwraca wskaźnik do skopiowanego łańcucha.W przypadku błędu zwraca wartość NULL, gdy nie jest dostępna dostateczna ilość pamięci, oraz ustawia zmienną errno na ENOMEM.
Zgodne z SVID 3, BSD 4.3.
strndup(), strdupa() i strndupa() są rozszerzeniami GNU.
Zobacz także alloca() calloc() free() malloc() realloc() Wskaźniki