strcat, wcscat, _mbscat

Artigo
02/25/2013

Acrescente uma cadeia de caracteres.Versões mais seguros 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 de CRT não suportadas com /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 NULL- finalizada de destino.
strSource
Cadeia de caracteres NULL- finalizada de origem.

Valor de retorno

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

Comentários

A função de strcat acrescenta strSource a strDestination e termina 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 caracteres de origem e de destino sobrepostos.

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

wcscat e _mbscat são versões de largo- caractere e o caractere multibyte- de strcat.Os argumentos e o valor de retorno de wcscat são cadeias de caracteres de largo- caractere; essas de _mbscat são cadeias de caracteres de multibyte- caractere.Essas três funções se comportam de forma idêntica.

Em C++, essas funções têm as sobrecargas de modelo que chamam as novas contrapartes mais seguros, essas funções.Para obter mais informações, consulte Proteger Overloads de modelo.

Mapeamentos da rotina de Genérico- texto