_mbccpy, _mbccpy_l
Copia um caractere de multibyte de uma cadeia de caracteres para outra cadeia de caracteres. Versões mais seguras dessas funções estão disponíveis; consulte _mbccpy_s, _mbccpy_s_l.
Importante
Esta API não pode ser usada em aplicativos que executam no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.
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 impressão.src
Caractere de multibyte a ser copiado.locale
Localidade a ser usada.
Comentários
A função de _mbccpy copia um caractere de multibyte de src para dest.
Essa função valida seus parâmetros. Se _mbccpy for informado um ponteiro nulo para dest ou src, o manipulador de parâmetro inválido será chamado, como descrito em Validação do parâmetro. Se a exceção puder continuar, errno é definido como EINVAL.
_mbccpy usa a localidade atual para qualquer comportamento dependente de local. _mbccpy_l é idêntico a _mbccpy, exceto que _mbccpy_l usa a localidade passada em qualquer comportamento dependente da 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 terminadas em nulo não devem exceder o tamanho do buffer de destino. Para obter mais informações, consulte Evitando saturações de buffer. Problemas de saturação de buffer é um método frequente de ataque do sistema, resultando em elevação injustificável de privilégio.
Mapeamentos da rotina de texto genérico
Rotina Tchar.h |
_UNICODE e _MBCS não definidos |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_tccpy |
Mapeia para a função macro ou embutida |
_mbccpy |
Mapeia para a função macro ou embutida |
_tccpy_l |
n/d |
_mbccpy_l |
n/d |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_mbccpy |
<mbctype.h> |
_mbccpy_l |
<mbctype.h> |
Para obter mais informações sobre compatibilidade, consulte Compatibilidade.
Equivalente ao .NET Framework
Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de chamadas de plataformas.