CKTIS / C
strncat — dołączanie z limitem bajtów źródła
strncat dołącza najwyżej n bajtów źródła do napisu i dopisuje '\0'. Parametr n nie oznacza pojemności bufora docelowego.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <string.h>
char *strncat(char * restrict s1, const char * restrict s2, size_t n);strncat z <string.h> dołącza do s1 najwyżej n bajtów z s2, kończąc wcześniej przy '\0'. Nadpisuje dotychczasowy terminator i dopisuje nowy. Zwraca s1, nie długość ani informację o obcięciu.
s1 musi wskazywać zapisywalny napis zakończony '\0'. Źródło musi udostępniać n bajtów albo wcześniejszy terminator. Niewystarczające miejsce lub nakładanie się obszarów podczas kopiowania powoduje niezdefiniowane zachowanie.
n ogranicza dane źródłowe, nie rozmiar wyniku. Nie sprawdzaj pojemności przez obliczanie strlen(s1) + n + 1 bez kontroli przepełnienia: arytmetyka bez znaku może dać zaniżony wynik. Jeśli capacity to pojemność bufora docelowego w bajtach i strlen(s1) < capacity, to warunek n <= capacity - strlen(s1) - 1 gwarantuje miejsce na maksymalnie n dołączanych bajtów i nowy terminator. Dla poprawnie zakończonej tablicy dst wolne miejsce oblicza sizeof dst - strlen(dst) - 1; nie stosuj tego wzoru z sizeof wskaźnika. Przy n == 0 napis pozostaje niezmieniony, lecz wskaźniki nadal muszą być poprawne.
Przykłady
#include <stdio.h>
#include <string.h>
int main(void)
{
char dst[10] = "Hi ";
const char src[] = "there!";
size_t room = sizeof dst - strlen(dst) - 1;
strncat(dst, src, room);
puts(dst);
return 0;
}
Wynik
Hi there!
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.