CKTIS / C
strcat — een tekenreeks toevoegen
strcat uit <string.h> voegt een brontekenreeks toe aan een doeltekenreeks. De functie vereist een voldoende grote buffer en controleert de capaciteit ervan niet.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
char *strcat(char * restrict s1, const char * restrict s2);strcat(s1, s2) vervangt de afsluitende \0 in s1 door een kopie van s2, inclusief diens \0. De functie retourneert s1, niet een pointer naar het einde van het resultaat.
Beide argumenten moeten naar geldige, nulbeëindigde tekenreeksen wijzen. De doelbuffer moet beschrijfbaar zijn en ten minste strlen(s1) + strlen(s2) + 1 bytes kunnen bevatten. Overlappende objecten die bij het kopiëren betrokken zijn, veroorzaken ongedefinieerd gedrag.
De functie krijgt geen bufferomvang mee en biedt geen bescherming tegen overlopen. Een te kleine buffer veroorzaakt ongedefinieerd gedrag, geen veilige afkapping. Herhaald toevoegen kan inefficiënt zijn: bij elke aanroep wordt het einde van de doeltekenreeks opnieuw opgezocht.
Voorbeelden
#include <stdio.h>
#include <string.h>
int main(void)
{
char text[12] = "Hello";
const char suffix[] = ", C!";
strcat(text, suffix);
puts(text);
return 0;
}
Resultaat
Hello, C!
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.