strcat, wcscat, _mbscat

Artículo
04/10/2013

Anexa una cadena.Versiones más seguras de estas funciones están disponibles; vea strcat_s, wcscat_s, _mbscat_s.

Importante
_mbscat_s no se puede utilizar en las aplicaciones que se ejecutan en tiempo de ejecución de Windows.Para obtener más información, vea Funciones CRT no compatibles con /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
Cadena terminada en null de destino.
strSource
Cadena terminada en null de origen.

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 de 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 null de terminación de strDestination.El comportamiento de strcat es indefinido si las cadenas de origen y de destino se superponen.

Nota sobre la seguridad
Dado que strcat no comprueba el espacio suficiente en strDestination antes de anexar strSource, es una causa potencial de saturaciones del búfer.Considere utilizar strncat en su lugar.

wcscat y _mbscat son versiones de caracteres anchos y de multibyte- carácter de strcat.Los argumentos y el valor devuelto de wcscat son cadenas de caracteres; las de _mbscat son cadenas de multibyte- carácter.Estas tres funciones se comportan exactamente igual de otra manera.

En C++, estas funciones tienen sobrecargas de plantilla que se invoque según el nuevo, garantiza que sus homólogos de estas funciones.Para obtener más información, vea Sobrecargas de plantilla de seguridad.

Asignaciones de la rutina de Genérico- texto