strcpy, wcscpy, _mbscpy

Článek
06/09/2015

Zkopíruje řetězec.Bezpečnější verze těchto funkcí jsou k dispozici; viz strcpy_s, wcscpy_s, _mbscpy_s.

Důležité
_mbscpy nelze použít v aplikacích, které jsou spuštěny ve prostředí 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
Zdrojový řetězec zakončený hodnotou null.

Vrácená hodnota

Každá z těchto funkcí vrací cílový řetězec.Není rezervována žádná vrácená hodnota pro indikaci chyby.

Poznámky

Funkce strcpy zkopíruje strSource, včetně ukončujícího znaku null, do umístění zadaného pomocí parametru strDestination.Chování strcpy není definováno, pokud se zdrojový a cílový řetězec překrývají.

Poznámka k zabezpečení
Jelikož strcpy nekontroluje dostatek místa v strDestination předtím, než zkopíruje strSource, jde o potenciální příčinu přetečení vyrovnávací paměti.Proto je doporučeno místo toho používat strcpy_s.

wcscpy a _mbscpy jsou širokoznaká a vícebajtová verze strcpy.Argumenty a vrácené hodnoty wcscpy jsou širokoznaké řetězce. Hodnoty _mbscpy jsou vícebajtové znakové řetězce.Tyto tři funkce se chovají identicky jinak.

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

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_tcscpy	strcpy	_mbscpy	wcscpy

Požadavky

Rutina	Požadované záhlaví
strcpy	<string.h>
wcscpy	<string.h> nebo <wchar.h>
_mbscpy	<mbstring.h>

Další informace o kompatibilitě naleznete v tématu 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 );
}