CKTIS / C
strncat — dodavanje uz ograničenje broja bajtova izvora
strncat dodaje najviše n bajtova izvora u niz i dodaje '\0'. Parametar n ne predstavlja kapacitet odredišnog međuspremnika.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <string.h>
char *strncat(char * restrict s1, const char * restrict s2, size_t n);strncat iz <string.h> dodaje najviše n bajtova iz s2 u s1, a staje ranije ako naiđe na '\0'. Prepisuje postojeći završni znak i dodaje novi. Vraća s1, a ne duljinu ni informaciju o skraćivanju.
s1 mora pokazivati na zapisiv niz završen nul-znakom. Izvor mora omogućiti čitanje n bajtova ili sadržavati raniji završni znak. Nedovoljno prostora ili preklapanje područja tijekom kopiranja uzrokuje nedefinirano ponašanje.
n ograničava podatke izvora, a ne veličinu rezultata. Pri provjeri kapaciteta nemojte računati strlen(s1) + n + 1 bez provjere preljeva: u aritmetici s brojevima bez predznaka preljev može dati premalu vrijednost. Ako je capacity kapacitet odredišnog međuspremnika u bajtovima i vrijedi strlen(s1) < capacity, tada n <= capacity - strlen(s1) - 1 jamči dovoljno prostora za najviše n dodanih bajtova i novi završni znak. Za polje dst koje sadrži pravilno završen niz izračunajte preostali prostor kao sizeof dst - strlen(dst) - 1; nemojte upotrebljavati ovu formulu uz sizeof pokazivača. Uz n == 0 niz ostaje nepromijenjen, ali pokazivači i dalje moraju biti valjani.
Primjeri
#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;
}
Rezultat
Hi there!
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.