strcpy， wcscpy， _mbscpy

發行項
03/26/2013

複製資料。更多這些函式的可用安全版本，請參閱 strcpy_s，wcscpy_s _mbscpy_s 。

重要

_mbscpy 不能用於 Windows 執行階段執行的應用程式。如需詳細資訊，請參閱 CRT 函式不支援使用 /ZW。

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

參數

strDestination
目的資料。
strSource
innull 結尾的來源字串。

傳回值

這些函式都會傳回的字串。傳回值不會保留表示錯誤。

備註

strcpy 函式複製 strSource，包括結束的 null 字元，將由 strDestination指定的位置。如果來源和目的資料重疊， strcpy 行為是未定義。

安全性提示
因為 strcpy 不會檢查 strDestination 的足夠的空間，在它複製 strSource之前，它是緩衝區滿溢的一個可能的原因。因此，建議您使用 strcpy_s 。

wcscpy 和 _mbscpy 分別為，則為 strcpy，寬字元和多位元組字元版本。 wcscpy 的參數和回傳值是寬字元字串，而 _mbscpy 則是多位元組字元字串。這三個函式其餘部分的運作相同。

在 C++ 中，這些函式有多載樣板可以調用更新、更安全的這些函式的相對版本。如需詳細資訊，請參閱安全範本多載。

泛用文字常式對應

TCHAR.H 常式	未定義 _UNICODE & _MBCS	已定義 _MBCS	已定義 _UNICODE
_tcscpy	strcpy	_mbscpy	wcscpy

需求

程序	必要的標頭檔
strcpy	<string.h>
wcscpy	<string.h> 或 <wchar.h>
_mbscpy	<mbstring.h>

如需其他相容性資訊，請參閱相容性。

範例

// 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 );
}