CKTIS / C
strncat — dodajanje z omejitvijo bajtov iz vira
strncat nizu doda največ n bajtov iz vira in doda '\0'. Parameter n ne pomeni kapacitete ciljnega medpomnilnika.
Različica: 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> doda v s1 največ n bajtov iz s2; konča se prej, če naleti na '\0'. Prepiše obstoječi zaključni znak in doda novega. Vrne s1, ne dolžine ali informacije o skrajšanju.
s1 mora kazati na zapisljiv niz, zaključen z ničelnim znakom. Vir mora zagotavljati n berljivih bajtov ali zgodnejši zaključni znak. Premalo prostora ali prekrivanje območij med kopiranjem povzroči nedefinirano vedenje.
n omejuje podatke iz vira, ne velikosti rezultata. Pri preverjanju kapacitete ne računajte strlen(s1) + n + 1 brez preverjanja prekoračitve obsega: pri aritmetiki z nepredznačenimi števili lahko prekoračitev da premajhno vrednost. Če je capacity kapaciteta ciljnega medpomnilnika v bajtih in velja strlen(s1) < capacity, potem n <= capacity - strlen(s1) - 1 zagotavlja dovolj prostora za največ n dodanih bajtov in nov zaključni znak. Za tabelo dst s pravilno zaključenim nizom izračunajte preostali prostor kot sizeof dst - strlen(dst) - 1; te formule ne uporabljajte z sizeof kazalca. Pri n == 0 niz ostane nespremenjen, vendar morajo biti kazalci še vedno veljavni.
Primeri
#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!
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.