Exportar (0) Imprimir
Expandir todo
div
EOF
Expandir Minimizar
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

_mbsnbcat, _mbsnbcat_l

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.

Nota importante 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

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.

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

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

Rutina de Tchar.h

_UNICODE y _MBCS no definidos

_MBCS definido

_UNICODE definido

_tcsncat

strncat

_mbsnbcat

wcsncat

_tcsncat_l

_strncat_l

_mbsnbcat_l

_wcsncat_l

Rutina

Encabezado necesario

_mbsnbcat

<mbstring.h>

_mbsnbcat_l

<mbstring.h>

Para obtener más información de compatibilidad, vea Compatibilidad en la Introducción.

No es aplicable Para llamar a la función estándar de C, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft