strcpy, wcscpy, _mbscpy

Makale
03/27/2013

Bir dizeye kopyalar.Bu işlevlerin daha güvenli sürümlerinde kullanılabilir; see strcpy_s, wcscpy_s, _mbscpy_s.

Önemli
_mbscpyyürütün uygulamalarda kullanılamaz Windows Çalışma Zamanı.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

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
Kaynak boşlukla sonlandırılmış dize.

Dönüş Değeri

Bu işlevlerden her biri hedef dizesini döndürür.Hiçbir değer döndürmeyen bir hatayı göstermek için ayrılmıştır.

Notlar

strcpy Kopya işlev strSource, tarafından belirtilen konuma sondaki boş karakter dahil olmak üzere strDestination.Davranışını strcpy kaynak ve hedef dizeleri üst üste gelirse tanımsızdır.

Güvenlik Notu
Çünkü strcpy için 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ümleridir strcpy.Bağımsız değişkenleri ve dönüş değeri wcscpy geniş karakter dizesidir; _mbscpy çok baytlı karakter dizeleridir.Bu üç işlevi aynı şekilde aksi davranır.

Bu işlevleri C++'da, bu işlevlerin daha yeni ve güvenli karşılıkları çağırmak şablon aşırı yükleme vardır.Daha fazla bilgi için bkz. Güvenli şablon aşırı yükleme.

Genel metin eşlemeleri yordamına girildi

TCHAR.H yordamına girildi	_UNICODE & _mbcs tanımlanmamış	Tanımlanan _mbcs	Tanımlanan _UNICODE
_tcscpy	strcpy	_mbscpy	wcscpy

Gereksinimler

Yordamı	Gerekli başlık
strcpy	<string.h>
wcscpy	<string.h> veya <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 );
}