Compartilhar via


strcpy wcscpy, _mbscpy

Copie uma seqüência.Versões mais seguras dessas funções estão disponível; consulte strcpy_s wcscpy_s, _mbscpy_s.

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
    Seqüência de caracteres de destino.

  • strSource
    Seqüência de caracteres terminada com caractere nulo de fonte.

Valor de retorno

Cada uma dessas funções retornará a seqüência de caracteres de destino.Nenhum valor retornado é reservado para indicar um erro.

Comentários

The strcpy cópias de função strSource, incluindo o caractere nulo terminação, para o local especificado por strDestination. O comportamento de strcpy é indefinido se sobreponham as seqüências de caracteres de fonte e destino.

Observação de segurança:

Porque strcpy não verifica a existência de espaço suficiente no strDestination antes de copiar strSource, ele é uma causa potencial de saturações de buffer. Considere o uso de strcpy_s em vez disso.

wcscpy e _mbscpysão versões de caractere largo e caracteres de multibyte de strcpy. Os argumentos e o valor retornado do wcscpy são caractere largos strings; as de _mbscpy são seqüências de caractere de multibyte. Especifique estas três funções identicamente outro comportam.

No C++, essas funções têm sobrecargas de modelo que invocam as suas similares do mais recentes, seguras dessas funções.Para obter mais informações, consulte Proteger overloads de modelo.

Mapeamentos de rotina de texto genérica

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 compatibilidade, consulte Compatibilidade na introdução.

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];

   // Note that 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; consider using strcpy_s instead
   strcat( string, "strcpy " );           // C4996
   // Note: strcat is deprecated; consider using strcat_s instead
   strcat( string, "and " );              // C4996
   strcat( string, "strcat!" );           // C4996
   printf( "String = %s\n", string );
}

String = Hello world from strcpy and strcat!

Equivalente do NET Framework

sistema::String::Copy

Consulte também

Referência

Manipulação de seqüência de caracteres (CRT)

strcat wcscat, _mbscat

strcmp wcscmp, _mbscmp

strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

strncmp, wcsncmp, _mbsncmp, _mbsncmp_l

funções 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