strcat wcscat, _mbscat

Artigo
08/25/2010

Acrescente uma seqüência de caracteres.Versões mais seguras dessas funções estão disponível; consulte strcat_s wcscat_s, _mbscat_s.

char *strcat(
   char *strDestination,
   const char *strSource 
);
wchar_t *wcscat(
   wchar_t *strDestination,
   const wchar_t *strSource 
);
unsigned char *_mbscat(
   unsigned char *strDestination,
   const unsigned char *strSource 
);
template <size_t size>
char *strcat(
   char (&strDestination)[size],
   const char *strSource 
); // C++ only
template <size_t size>
wchar_t *wcscat(
   wchar_t (&strDestination)[size],
   const wchar_t *strSource 
); // C++ only
template <size_t size>
unsigned char *_mbscat(
   unsigned char (&strDestination)[size],
   const unsigned char *strSource 
); // C++ only

Parâmetros

strDestination
Seqüência de caracteres terminada com caractere nulo 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 (strDestination). Nenhum valor retornado é reservado para indicar um erro.

Comentários

The strcat função anexa strSource para strDestination e termina a seqüência de caracteres resultante com um caractere nulo. O caractere inicial de strSource substitui o caractere nulo de terminação de strDestination. O comportamento de strcat é indefinido se sobreponham as seqüências de caracteres de fonte e destino.

Observação de segurança:
Porque strcat não verifica a existência de espaço suficiente no strDestination antes de acrescentá strSource, ele é uma causa potencial de saturações de buffer. Considere o uso de strncat em vez disso.

wcscat e _mbscatsão versões de caractere largo e caracteres de multibyte de strcat. Os argumentos e o valor retornado do wcscat são caractere largos strings; as de _mbscat 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