CKTIS / C
strncat — pripojenie s obmedzením počtu bajtov zdroja
strncat pripojí k reťazcu najviac n bajtov zdroja a pridá '\0'. Parameter n neudáva kapacitu cieľového bufferu.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
char *strncat(char * restrict s1, const char * restrict s2, size_t n);strncat z <string.h> pripojí k s1 najviac n bajtov z s2; skončí skôr, ak narazí na '\0'. Prepíše existujúci ukončovací znak a pridá nový. Vracia s1, nie dĺžku ani informáciu o skrátení.
s1 musí ukazovať na zapisovateľný reťazec ukončený nulovým znakom. Zdroj musí poskytovať n čitateľných bajtov alebo skorší ukončovací znak. Nedostatok miesta alebo prekrývajúce sa oblasti počas kopírovania vedú k nedefinovanému správaniu.
n obmedzuje zdrojové údaje, nie veľkosť výsledku. Pri kontrole kapacity nepočítajte strlen(s1) + n + 1 bez kontroly pretečenia: pri aritmetike s číslami bez znamienka môže pretečenie viesť k príliš malej hodnote. Ak capacity označuje kapacitu cieľového bufferu v bajtoch a platí strlen(s1) < capacity, potom n <= capacity - strlen(s1) - 1 zaručuje dostatok miesta až pre n pripojených bajtov a nový ukončovací znak. Pri správne ukončenom poli dst vypočítajte zostávajúce miesto ako sizeof dst - strlen(dst) - 1; tento vzorec nepoužívajte s sizeof ukazovateľa. Pri n == 0 zostane reťazec nezmenený, ukazovatele však stále musia byť platné.
Prí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ýsledok
Hi there!
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.