Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje