Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri