strcpy, wcscpy, _mbscpy

Makale
06/09/2015

Bir dizeyi kopyalar.Bu işlevlerin daha güvenli sürümleri mevcuttur; bkz. strcpy_s, wcscpy_s, _mbscpy_s.

Önemli
_mbscpy, Windows Çalışma Zamanı içinde yürütülen uygulamalarda kullanılmaz.Daha fazla bilgi için bkz /ZW ile desteklenmeyen CRT işlevleri.

char *strcpy(
   char *strDestination,
   const char *strSource 
);
wchar_t *wcscpy(
   wchar_t *strDestination,
   const wchar_t *strSource 
);
unsigned char *_mbscpy(
   unsigned char *strDestination,
   const unsigned char *strSource 
);
template <size_t size>
char *strcpy(
   char (&strDestination)[size],
   const char *strSource 
); // C++ only
template <size_t size>
wchar_t *wcscpy(
   wchar_t (&strDestination)[size],
   const wchar_t *strSource 
); // C++ only
template <size_t size>
unsigned char *_mbscpy(
   unsigned char (&strDestination)[size],
   const unsigned char *strSource 
); // C++ only

Parametreler

strDestination
Hedef dize.
strSource
Null ile sonlandırılmış kaynak dizesi.

Dönüş Değeri

Bu işlevlerden her biri hedef dizesini döndürür.Bir hata gösterecek bir dönüş değeri ayrılmamış.

Notlar

strcpy Kopya işlev strSource, tarafından belirtilen konuma sondaki boş karakter içeren strDestination.Kaynak ve hedef dizeleri örtüştürürse strcpy davranışı tanımsızdır.

Güvenlik Notu
Çünkü strcpy yeterli alana denetlemez strDestination , kopyalamadan önce strSource, olası bir nedeni arabellek taşmaları olur.Bu nedenle, kullanmanızı öneririz strcpy_s yerine.

wcscpyve _mbscpy , sırasıyla, geniş karakter ve çok baytlı karakter sürümleri şunlardır: strcpy.Bağımsız değişkenler ve wcscpy dönüş değeri geniş karakterli dizelerdir; _mbscpy dizeleri çok baytlı karakter dizeleridir.Bu üç işlev, aynı şekilde davranır.

C++ dilinde, bu işlevlerin daha yeni ve güvenli karşıtlarını başlatan şablon aşırı yüklemeleri vardır.Daha fazla bilgi için bkz. Güvenli Şablon Aşırı Yüklemeleri.

Genel Metin Yordam Eşleşmeleri

TCHAR.H yordamı	_UNICODE & _MBCS tanımlanmamış	_MBCS tanımlanmış	_UNICODE tanımlanmış
_tcscpy	strcpy	_mbscpy	wcscpy

Gereksinimler

Yordam	Gerekli başlık
strcpy	<string.h>
wcscpy	<string.h> or <wchar.h>
_mbscpy	<mbstring.h>

Ek uyumluluk bilgileri için bkz. Uyumluluk.

Örnek

// crt_strcpy.c
// compile with: /W3
// This program uses strcpy
// and strcat to build a phrase.

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

int main( void )
{
   char string[80];

   // If you change the previous line to
   //   char string[20];
   // strcpy and strcat will happily overrun the string
   // buffer.  See the examples for strncpy and strncat
   // for safer string handling.

   strcpy( string, "Hello world from " ); // C4996
   // Note: strcpy is deprecated; use strcpy_s instead
   strcat( string, "strcpy " );           // C4996
   // Note: strcat is deprecated; use strcat_s instead
   strcat( string, "and " );              // C4996
   strcat( string, "strcat!" );           // C4996
   printf( "String = %s\n", string );
}