CKTIS / C
strncat — připojení s omezením počtu bajtů zdroje
strncat připojí k řetězci nejvýše n bajtů zdroje a přidá '\0'. Parametr n neudává kapacitu cílového bufferu.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <string.h>
char *strncat(char * restrict s1, const char * restrict s2, size_t n);strncat z <string.h> připojí k s1 nejvýše n bajtů z s2; skončí dříve, pokud narazí na '\0'. Přepíše stávající ukončovací znak a přidá nový. Vrací s1, nikoli délku ani informaci o zkrácení.
s1 musí ukazovat na zapisovatelný řetězec ukončený nulovým znakem. Zdroj musí poskytovat n čitelných bajtů nebo dřívější ukončovací znak. Nedostatek místa nebo překrývající se oblasti při kopírování vedou k nedefinovanému chování.
n omezuje zdrojová data, nikoli velikost výsledku. Při kontrole kapacity nepočítejte strlen(s1) + n + 1 bez kontroly přetečení: při aritmetice s čísly bez znaménka může přetečení vést k příliš malé hodnotě. Pokud capacity označuje kapacitu cílového bufferu v bajtech a platí strlen(s1) < capacity, pak n <= capacity - strlen(s1) - 1 zaručuje dostatek místa až pro n připojených bajtů a nový ukončovací znak. U správně ukončeného pole dst vypočítejte zbývající místo jako sizeof dst - strlen(dst) - 1; tento vzorec nepoužívejte s sizeof ukazatele. Při n == 0 zůstane řetězec nezměněný, ukazatele však stále musí být platné.
Příklady
#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;
}
Výsledek
Hi there!
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.