strcpy, wcscpy, _mbscpy

Artigo
06/09/2015

Copia uma cadeia de caracteres. Versões mais seguras dessas funções estão disponíveis; consulte strcpy_s, wcscpy_s, _mbscpy_s.

Importante

_mbscpy não pode ser usado em aplicativos que executam no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /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
Cadeia de caracteres de destino.
strSource
Cadeia de caracteres de origem terminada com Null.

Valor de retorno

Cada uma dessas funções retorna a cadeia de caracteres de destino. Nenhum valor de retorno é reservado para indicar um erro.

Comentários

A função de strcpy copia strSource, incluindo o caractere terminador nulo, o local especificado por strDestination. O comportamento de strcpy será indefinido se as cadeias de caracteres de origem e de destino se sobrepuserem.

Observação de segurança
Como strcpy não verifica se há espaço suficiente em strDestination antes que copia strSource, é uma causa potencial de excesso de buffer.Consequentemente, recomendamos que você use strcpy_s em vez disso.

wcscpy e _mbscpy são versões, respectivamente, ampla de caracteres e de multibyte- caractere de strcpy. Os argumentos e o valor de retorno de wcscpy são cadeias de caracteres largos; _mbscpy são cadeias de caracteres de vários bytes. Essas três funções se comportam de forma idêntica.

No C++, essas funções têm as sobrecargas de modelo que invocam as correspondentes seguras mais recentes dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Mapeamentos da rotina de texto genérico

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tcscpy	strcpy	_mbscpy	wcscpy

Requisitos

Rotina	Cabeçalho necessário
strcpy	<string.h>
wcscpy	<string.h> ou <wchar.h>
_mbscpy	<mbstring.h>

Para obter informações adicionais sobre compatibilidade, consulte Compatibilidade.

Exemplo

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