_mbccpy, _mbccpy_l

Copia um caractere multibyte de uma cadeia de caracteres para outra. Versões mais seguras dessas funções estão disponíveis; confira _mbccpy_s, _mbccpy_s_l.

Importante

Esta API não pode ser usada em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.

Sintaxe

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 da cópia.

src
Caracteres multibyte para copiar.

locale
Localidade a usar.

Comentários

A função _mbccpy copia um caractere multibyte de src para dest.

Essa função valida seus parâmetros. Se _mbccpy for passado um ponteiro nulo para dest ou src, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, errno será definido como EINVAL.

_mbccpy usa a localidade atual para qualquer comportamento que dependa da localidade. _mbccpy_l é idêntico a _mbccpy, exceto que _mbccpy_l usa a localidade passada para qualquer comportamento dependente de localidade. Para obter mais informações, consulte Localidade.

Observação de Segurança Use uma cadeia de caracteres terminada em nulo. A cadeia de caracteres terminada em nulo não deve exceder o tamanho do buffer de destino. Para obter mais informações, confira Como evitar sobrecargas de buffer. Os problemas de estouro de buffer são um método frequente de ataque ao sistema, resultando em uma elevação de privilégio sem garantia.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_tccpy	É mapeado para um macro ou uma função embutida	_mbccpy	É mapeado para um macro ou uma função embutida
_tccpy_l	N/D	_mbccpy_l	N/D

Requisitos

Rotina	Cabeçalho necessário
_mbccpy	<mbctype.h>
_mbccpy_l	<mbctype.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Localidade
Interpretação de sequências de caracteres multibyte
_mbclen, mblen, _mblen_l