strcpy, wcscpy, _mbscpy

  • Artigo

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

Importante

_mbscpy não pode ser usada em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.

Sintaxe

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 com terminação nula.

Valor retornado

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

Comentários

A função strcpy copia strSource, incluindo o caractere nulo de terminação, para o local especificado pelo strDestination. O comportamento de strcpy é indefinido se as cadeias de origem e destino se sobrepõem.

Importante

Já que strcpy não verifica se há espaço suficiente em strDestination antes de copiar strSource, isso é uma causa potencial de sobrecargas de buffer. Em vez dessa função, recomendamos usar strcpy_s.

wcscpy e _mbscpy são, respectivamente, versões de caracteres largos e de caracteres multibyte de strcpy. Os argumentos e o valor retornado de wcscpy são cadeias de caracteres largos. Os argumentos e o valor retornado de são cadeias de _mbscpy caracteres multibyte. Caso contrário, essas três funções se comportam de forma idêntica.

No C++, essas funções têm sobrecargas de modelo que invocam os equivalentes mais novos e seguros dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H _UNICODE e _MBCS não definidos _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 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 );
}

String = Hello world from strcpy and strcat!

Confira também

Manipulação de cadeia de caracteres
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