Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje