strcat wcscat, _mbscat
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
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_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 adicionais compatibilidade, consulte Compatibilidade na introdução.
Exemplo
Consulte o exemplo para strcpy.
Equivalente do NET Framework
Consulte também
Referência
Manipulação de seqüência de caracteres (CRT)
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