CKTIS / C
strcpy — een tekenreeks kopiëren
strcpy kopieert een tekenreeks inclusief de afsluitende '\0'. De aanroeper moet voldoende ruimte voor de bestemming bieden en ervoor zorgen dat de objecten elkaar niet overlappen.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
char *strcpy(char * restrict s1, const char * restrict s2);strcpy, gedeclareerd in <string.h>, kopieert de tekenreeks van s2 naar s1, inclusief de afsluitende '\0'. De functie retourneert s1, niet het aantal gekopieerde tekens.
De bron moet een geldige, nul-getermineerde tekenreeks bevatten. De bestemming moet beschrijfbaar zijn en minimaal strlen(s2) + 1 bytes kunnen bevatten. De functie krijgt geen bufferlengte mee en wijst geen geheugen toe. Een te kleine buffer of overlappende gekopieerde objecten veroorzaakt ongedefinieerd gedrag; verwacht geen foutcode.
In het voorbeeld bevat sizeof source het null-teken, dus destination is groot genoeg. De afzonderlijke arrays overlappen niet. puts drukt de kopie af en voegt een newline toe.
Voorbeelden
#include <stdio.h>
#include <string.h>
int main(void)
{
const char source[] = "Hello";
char destination[sizeof source];
strcpy(destination, source);
puts(destination);
return 0;
}
Resultaat
Hello
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.