strcpy() fonksiyonu

Bildirim

char* strcpy(char *dest, const char *src);

char* strcpy(char *restrict dest, const char *restrict src); (C99)

errno_t strcpy_s(char *restrict dest, rsize_t destsz, const char *restrict src); (C11)

Açıklama

Src parametresi ile gösterilen ve boş bir karakter ('\0') ile sonlandırılmış karakter dizisini, dest parametresi ile gösterilen ve boş bir karakter ('\0') ile sonlandırılmış karakter dizisinin yerine kopyalar.

Aşağıdaki koşullardan biri gerçekleştiğinde belirsiz sonuçlar elde edilir:

Eğer dest parametresi kopyalama sonunda elde edilecek karakter dizisini, sonlandırıcı boş karakter ('\0') dahil olmak üzere, alabilecek kadar yeterli bir alana sahip değilse,
Eğer src ve dest parametreleri çakışırsa,
Dest parametresi boş bir karakterle ('\0') sonlandırılmış bir karakter dizisini gösteren bir işaretçi değilse,
Src parametresi bir karakter dizisini gösteren bir işaretçi değilse.

strcpy_s() fonksiyonu ayrıca, hedef dizinin geri kalanını tanımlanmamış değerlerle doldurabilir ve aşağıdaki hatalar çalışma zamanında algılanır ve yüklenmiş olan kısıtlayıcı işlem fonksiyonu çağrılır:

Src veya dest parametre değeri NULL bir işaretçi ise,
Destsz parametre değeri 0 veya RSIZE_MAX değerinden büyük ise,
Destsz parametre değerinin src parametresinin boyutundan küçük veya eşit olması nedeniyle kopyalama işleminde kesinti meydana gelirse,
Src ve Dest parametrelerindeki dizeler arasında örtüşme meydan gelirse.

Parametreler

dest: Üzerine kopyalama yapılacak olan boş bir karakter ('\0') ile sonlandırılmış bir karakter dizisidir.

src: Dest parametresinin üzerine kopyalanacak olan boş bir karakter ('\0') ile sonlandırılmış bir karakter dizisidir.

destsz: Dest parametresine kopyalanacak maksimum karakter sayısıdır.

Dönüş değeri

Dönüş değeri;

Strcpy() fonksiyonu dest parametre değerini geri döndürür.

Strcpy_s() fonksiyonu başarı durumunda 0 değerini, hata durumunda sıfır olmayan değer geri döndürür. Hata durumunda ayrıca, dest NULL bir işaretçi değilse veya destsz sıfır değilse veya RSIZE_MAX değerinden büyük değil ise, dest[0] adresine 0 değerini yazar.

Örnek


#include <stdio.h>
#include <string.h>

int main(void)
{
    char cdizi1[] = "Bilgisayar";
    const char cdizi2[] = "Programlama";

    strcpy(cdizi1, cdizi2);

    printf("cdizi1 bellek içeriği: %s\n", cdizi1);

    return 0;
}

Yukarıdaki örnekte, program aşağıdaki satırları ekrana yazar.

cdizi1 bellek içeriği: Programlama

Program strcpy() fonksiyonu ile bir karakter dizisinin içeriğini diğer bir karakter dizisinin üzerine kopyaladıktan sonra elde edilen yeni karakter dizisini ekrana yazar.

Kaynak kodu


char* strcpy(char *dest, const char *src)
{
  char *ret = dest;
  
  while(*dest++ = *src++);
	
  return ret;
}