strcat, wcscat, _mbscat

Anexa una cadena. Existen versiones más seguras de estas funciones disponibles; consulte strcat_s, wcscat_s, _mbscat_s.

Importante

_mbscat_s no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para obtener más información, vea Funciones de CRT no admitidas en aplicaciones de la Plataforma universal de Windows.

Sintaxis

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
Cadena de destino terminada en NULL.

strSource
Cadena de origen terminada en NULL.

Valor devuelto

Cada una de estas funciones devuelve la cadena de destino (strDestination). No se reserva ningún valor devuelto para indicar un error.

Comentarios

La función strcat anexa strSource a strDestination y termina la cadena resultante con un carácter nulo. El carácter inicial de strSource sobrescribe el carácter nulo de terminación de strDestination. El comportamiento de strcat no se define si las cadenas de origen y de destino se superponen.

Importante

Dado que strcat no comprueba si hay espacio suficiente en strDestination antes de anexar strSource, podría dar lugar a saturaciones del búfer. Considere usar strncat en su lugar.

wcscat y _mbscat son versiones de caracteres anchos y multibyte de strcat. Los argumentos y el valor devuelto de son cadenas de wcscat caracteres anchos. Los argumentos y el valor devuelto de son cadenas de _mbscat caracteres multibyte. Estas tres funciones se comportan exactamente igual.

En C++, estas funciones tienen sobrecargas de plantilla que invocan los homólogos seguros más recientes de estas funciones. Para obtener más información, consulte Sobrecargas de plantillas seguras.

Asignaciones de rutinas de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tcscat	strcat	_mbscat	wcscat

Requisitos

Routine	Encabezado necesario
strcat	<string.h>
wcscat	<string.h> o <wchar.h>
_mbscat	<mbstring.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

Vea el ejemplo de strcpy.

Consulte también

Manipulación de cadenas
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