strcpy, wcscpy, _mbscpy

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Copia una cadena. Existen versiones más seguras de estas funciones; consulte strcpy_s, wcscpy_s, _mbscpy_s.

System_CAPS_ICON_important.jpg Importante

_mbscpy no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para más información, vea Funciones de CRT no admitidas con /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  

Parámetros

strDestination
Cadena de destino.

strSource
Cadena de origen terminada en NULL.

Cada una de estas funciones devuelve la cadena de destino. No se reserva ningún valor devuelto para indicar un error.

La función strcpy copia strSource, incluido el carácter nulo de terminación, en la ubicación especificada por strDestination. El comportamiento de strcpy no se define si las cadenas de origen y de destino se superponen.

System_CAPS_ICON_important.jpg Importante

Dado que strcpy no comprueba si hay espacio suficiente en strDestination antes de copiar strSource, podría dar lugar a saturaciones del búfer. Por lo tanto, recomendamos que use strcpy_s en su lugar.

wcscpy y _mbscpy son, respectivamente, versiones de caracteres anchos y multibyte de strcpy. Los argumentos y el valor devuelto de wcscpy son cadenas de caracteres anchos; los de _mbscpy son cadenas de caracteres multibyte. Estas tres funciones se comportan exactamente igual.

En C++, estas funciones tienen sobrecargas de plantilla que invocan los homólogos seguros más recientes de estas funciones. Para obtener más información, consulta Secure Template Overloads.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_tcscpystrcpy_mbscpywcscpy
RutinaEncabezado necesario
strcpy<string.h>
wcscpy<string.h> o <wchar.h>
_mbscpy<mbstring.h>

Para obtener más información sobre compatibilidad, vea Compatibilidad.

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

String = Hello world from strcpy and strcat!  

System::String::Copy

Manipulación de cadenas
strcat, wcscat, _mbscat
strcmp, wcscmp, _mbscmp
strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l
strspn, wcsspn, _mbsspn, _mbsspn_l

Mostrar: