_mbccpy, _mbccpy_l

Copia un carácter multibyte de una cadena en otra. Hay disponibles versiones más seguras de estas funciones; consulte _mbccpy_s, _mbccpy_s_l.

Importante

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

void _mbccpy(
   unsigned char *dest,
   const unsigned char *src
);
void _mbccpy_l(
   unsigned char *dest,
   const unsigned char *src,
   _locale_t locale
);

Parámetros

dest
Destino de la copia.

src
Carácter multibyte que se va a copiar.

locale
Configuración regional que se va a usar.

Comentarios

La función _mbccpy copia un carácter multibyte de src en dest.

Esta función valida sus parámetros. Si _mbccpy se pasa un puntero nulo para dest o src, se invoca al controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, errno se establece en EINVAL.

_mbccpy usa la configuración regional actual para cualquier comportamiento que dependa de la configuración regional. _mbccpy_l y _mbccpy son exactamente iguales, salvo que _mbccpy_l usa la configuración regional que se pasa para todo comportamiento dependiente de la configuración regional. Para obtener más información, vea Locale.

Nota de seguridad Use una cadena terminada en un valor nulo. El tamaño de la cadena terminada en un valor nulo no debe ser mayor que el del búfer de destino. Para obtener más información, consulte Evitar saturaciones del búfer. Los problemas de saturación del búfer son un método frecuente de ataque del sistema, que produce una elevación de privilegios no justificada.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas de texto genérico

Rutina Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tccpy	Se asigna a una macro o una función insertada	_mbccpy	Se asigna a una macro o una función insertada
_tccpy_l	N/D	_mbccpy_l	N/D

Requisitos

Routine	Encabezado necesario
_mbccpy	<mbctype.h>
_mbccpy_l	<mbctype.h>

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

Consulte también

Configuración regional
Interpretación de secuencias de caracteres de varios bytes
_mbclen, , mblen, _mblen_l