CKTIS / C
strncat — toevoegen met een limiet op bronbytes
strncat voegt maximaal n bronbytes toe aan een tekenreeks en voegt '\0' toe. De parameter n is niet de capaciteit van de doelbuffer.
Versie: 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 uit <string.h> voegt maximaal n bytes uit s2 toe aan s1 en stopt eerder bij '\0'. De functie overschrijft de bestaande terminator en voegt een nieuwe toe. Ze retourneert s1, geen lengte of status over afkappen.
s1 moet naar een schrijfbare, nul-beëindigde tekenreeks wijzen. De bron moet n leesbare bytes of een eerdere terminator bevatten. Onvoldoende ruimte of overlappende gebieden tijdens het kopiëren leidt tot ongedefinieerd gedrag.
n begrenst de brongegevens, niet de grootte van het resultaat. Gebruik strlen(s1) + n + 1 niet om de capaciteit te controleren zonder op overflow te testen: bij rekenen met gehele getallen zonder teken kan overflow een te kleine waarde opleveren. Als capacity de capaciteit van de doelbuffer in bytes is en strlen(s1) < capacity, dan garandeert n <= capacity - strlen(s1) - 1 voldoende ruimte voor maximaal n toe te voegen bytes en de nieuwe terminator. Bereken voor een correct beëindigde array dst de resterende ruimte als sizeof dst - strlen(dst) - 1; gebruik deze formule niet met sizeof van een pointer. Bij n == 0 blijft de tekenreeks ongewijzigd, maar de pointers moeten nog steeds geldig zijn.
Voorbeelden
#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;
}
Resultaat
Hi there!
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.