_setmbcp

  • Artigo

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.

Retornar valor

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 de 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 de página de código multibyte afeta todas as rotinas multibyte que não dependem de 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 uma página de código ANSI, OEM ou outra página de código suportada pelo sistema operacional (exceto UTF-7, que não é suportada).

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

Requisitos

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

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

Confira também

_getmbcp
setlocale, _wsetlocale