_mbsnbcat, _mbsnbcat_l

Artículo
04/10/2013

Anexe, como máximo, los primeros bytes de n de una cadena de multibyte- carácter a otra.Versiones más seguras de estas funciones están disponibles; vea _mbsnbcat_s, _mbsnbcat_s_l.

Importante
Esta API 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.

unsigned char *_mbsnbcat(
   unsigned char *dest,
   const unsigned char *src,
   size_t count 
);
unsigned char *_mbsnbcat_l(
   unsigned char *dest,
   const unsigned char *src,
   size_t count,
   _locale_t locale
);
template <size_t size>
unsigned char *_mbsnbcat(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count 
); // C++ only
template <size_t size>
unsigned char *_mbsnbcat_l(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count,
   _locale_t locale
); // C++ only

Parámetros

dest
Cadena terminada en null de destino de multibyte- carácter.
src
Cadena terminada en null de origen de multibyte- carácter.
count
Número de bytes de src a anexar a dest.
locale
Configuración regional a utilizar.

Valor devuelto

_mbsnbcat devuelve un puntero a la cadena de destino.No se reserva ningún valor devuelto para indicar un error.

Comentarios

La función de _mbsnbcat anexa, como máximo, los primeros bytes de count de src a dest.Si el byte inmediatamente antes del carácter null en dest es un byte inicial, byte inicial de src sobrescribe este byte inicial.Si no, byte inicial de src sobrescribe el carácter null de terminación de dest.Si un byte null aparece en src antes de que se anexen los bytes de count, _mbsnbcat anexa todos los bytes de src, hasta el carácter null.Si count es mayor que la longitud de src, la longitud de src se utiliza en lugar de count.La cadena resultante se termina con un carácter nulo.Si la copia tiene lugar entre cadenas superpuestas, el comportamiento es indefinido.

El valor de salida se ve afectado por el valor de la categoría de LC_CTYPE de configuración regional; vea setlocale para obtener más información.La versión de _mbsnbcat de la función utiliza la configuración regional actual para este comportamiento configuración regional-dependiente; la versión de _mbsnbcat_l es idéntica salvo que utilizan el parámetro locale pasado en su lugar.Para obtener más información, vea Configuración regional.

Uso de Security Note una cadena terminada en null.La cadena terminada en null no debe superar el tamaño del búfer de destino.Para obtener más información, vea Para evitar las saturaciones del búfer.

Si dest o src es NULL, la función generará un error no válido de parámetro, tal y como se describe en Validación de parámetros.Si se utiliza el error, la función devuelve EINVAL y establece errno a EINVAL.

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