strcat, wcscat, _mbscat

Artigo
06/09/2015

Acrescenta uma cadeia de caracteres. Versões mais seguras dessas funções estão disponíveis; consulte strcat_s, wcscat_s, _mbscat_s.

Importante

_mbscat_s não pode ser usado em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

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
Cadeia de caracteres de destino terminada com Null.
strSource
Cadeia de caracteres de origem terminada com Null.

Valor de retorno

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

Comentários

A função de strcat acrescenta strSource a strDestination e encerra a cadeia de caracteres resultante com um caractere nulo. O caractere inicial de strSource substituirá o caractere nulo de terminação de strDestination. O comportamento de strcat será indefinido se as cadeias de caracteres de origem e de destino se sobrepuserem.

Observação de segurança
Como strcat não verifica se há espaço suficiente em strDestination antes de anexar strSource, é uma causa potencial de excesso de buffer.Considere usar strncat em vez disso.

wcscat e _mbscat são versões de caracteres largos e de multibyte de strcat. Os argumentos e o valor de retorno de wcscat são cadeias de caracteres largos; _mbscat 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