CKTIS / C
strcpy — kopiowanie łańcucha znaków
strcpy kopiuje łańcuch wraz z końcowym '\0'. Wywołujący musi zapewnić odpowiednio duży bufor i brak nakładania obiektów.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <string.h>
char *strcpy(char * restrict s1, const char * restrict s2);strcpy, zadeklarowana w <string.h>, kopiuje łańcuch z s2 do s1, łącznie z końcowym znakiem '\0'. Zwraca s1, a nie liczbę skopiowanych znaków.
Źródło musi zawierać poprawny łańcuch zakończony '\0'. Cel musi być zapisywalny i mieścić co najmniej strlen(s2) + 1 bajtów. Funkcja nie przyjmuje rozmiaru bufora ani nie przydziela pamięci. Za mały bufor lub nakładanie się kopiowanych obiektów powoduje niezdefiniowane zachowanie; nie należy oczekiwać kodu błędu.
W przykładzie sizeof source obejmuje końcowy znak zerowy, więc destination ma wystarczający rozmiar. Oddzielne tablice nie nakładają się. puts wypisuje kopię i dodaje znak nowego wiersza.
Przykłady
#include <stdio.h>
#include <string.h>
int main(void)
{
const char source[] = "Hello";
char destination[sizeof source];
strcpy(destination, source);
puts(destination);
return 0;
}
Wynik
Hello
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.