_setmbcp

Define uma nova página de código multibyte.

Sintaxe

int _setmbcp(
   int codepage
);

Parâmetros

codepage
Nova configuração de página de código para rotinas multibyte independentes da localidade.

Valor retornado

Retorna 0 se a página de código é definida com êxito. Se um valor de página de código inválido for fornecido para codepage, retornará -1 e a configuração da página de código não será alterada. Define errno para EINVAL se ocorre uma falha de alocação de memória.

Comentários

A função _setmbcp especifica uma nova página de código multibyte. Por padrão, o sistema de tempo de execução define automaticamente a página de código multibyte para a página de código ANSI padrão do sistema. A configuração da página de código multibyte afeta todas as rotinas multibyte que não dependem da localidade. No entanto, é possível instruir _setmbcp a usar a página de código definida para a localidade atual (consulte a lista a seguir de constantes de manifesto e resultados de comportamento associados). Para obter uma lista das rotinas multibyte que dependem da página de código de localidade em vez da página de código multibyte, consulte Interpretação de sequências de caracteres multibyte.

O argumento codepage pode ser definido como qualquer um dos seguintes valores:

• _MB_CP_ANSI Use a página de código ANSI obtida do sistema operacional na inicialização do programa.

• _MB_CP_LOCALE Use a página de código da localidade atual obtida de uma chamada anterior para setlocale.

• _MB_CP_OEM Use a página de código OEM obtida do sistema operacional na inicialização do programa.

• _MB_CP_SBCS Use a página de código de byte único. Quando a página de código é definida como _MB_CP_SBCS, uma rotina como _ismbblead sempre retorna false.

• _MB_CP_UTF8 Use UTF-8. Quando a página de código é definida como _MB_CP_UTF8, uma rotina como _ismbblead sempre retorna false.

• Qualquer outro valor de página de código válido, independentemente de o valor ser um ANSI, OEM ou outra página de código com suporte do sistema operacional (exceto UTF-7, que não tem suporte).

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

Requisitos

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

Confira também

_getmbcp
setlocale, _wsetlocale