Partilhar via

strcat, wcscat, _mbscat

  • Artigo

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

Importante

_mbscat_s 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 *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 em nulo.

strSource
Cadeia de caracteres de origem com terminação nula.

Valor retornado

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

Comentários

A função strcat acrescenta strSource para strDestination e encerra a cadeia 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 as cadeias de origem e destino se sobrepõem.

Importante

Já que strcat não verifica se há espaço suficiente em strDestination antes de anexar strSource, isso é uma causa potencial de sobrecargas de buffer. Considere o uso de strncat em seu lugar.

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

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H _UNICODE e _MBCS não definidos _MBCS definido _UNICODE definido
_tcscat strcat _mbscat wcscat

Requisitos

Rotina Cabeçalho necessário
strcat <string.h>
wcscat <string.h> ou <wchar.h>
_mbscat <mbstring.h>

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

Exemplo

Confira o exemplo de strcpy.

Confira também

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