Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła