strcpy, wcscpy, _mbscpy

Článek
03/26/2013

Zkopíruje řetězec.Bezpečnější verze tyto funkce jsou k dispozici; see strcpy_s, wcscpy_s, _mbscpy_s.

Důležité
_mbscpynelze použít v aplikacích, které jsou spuštěny v Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /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

Parametry

strDestination
Cílový řetězec.
strSource
Řetězec zakončený hodnotou Null zdroje.

Vrácená hodnota

Každá z těchto funkcí vrací řetězec cílové.Žádné vrácená hodnota je vyhrazena udávající chybu.

Poznámky

strcpy Funkční kopie strSource, včetně ukončující znak null k umístění, které je zadáno ve strDestination.Chování strcpy není definován, je-li překrytí řetězce zdrojové a cílové.

Poznámka k zabezpečení
Protože strcpy nehledá dostatečný prostor v strDestination před strSource, je možná příčina chyby přetečení vyrovnávací paměti.Proto doporučujeme používat strcpy_s místo.

wcscpya _mbscpy , jsou verze širokého znaku a vícebajtové znakové sady strcpy.Argumenty a vrácené hodnoty wcscpy jsou řetězci širokého znaku; u _mbscpy jsou vícebajtové znakové řetězce.Tyto tři funkce chovat identicky jinak.

V jazyce C++ mají tyto funkce šablony přetížení, které vyvolávají novější, bezpečné protějšky těchto funkcí.Další informace naleznete v tématu Přetížení šablony zabezpečení.

Mapování rutiny obecného textu

TCHAR.Byla zahájena rutina h	_UNICODE & _MBCS není definováno	_MBCS, definice	_UNICODE definována
_tcscpy	strcpy	_mbscpy	wcscpy

Požadavky

Byla zahájena rutina	Požadované záhlaví
strcpy	<string.h>
wcscpy	<string.h> nebo <wchar.h>
_mbscpy	<mbstring.h>

Další informace o kompatibilitě, viz Kompatibilita.

Příklad

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