_setmbcp

  • Artigo

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

int _setmbcp(
   int codepage 
);

Parâmetros

  • codepage
    Nova configuração de página de código para rotinas de vários bytes independente de localidade.

Valor de retorno

Retorna 0 se a página de código foi definida com êxito.Se um valor de página de código inválido é fornecido para codepage, retorna – 1 e a configuração de página de código não é alterada.Conjuntos de errno para EINVAL se ocorrer uma falha de alocação de memória.

Comentários

O _setmbcp função 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 de vários bytes que não são dependente da localidade.No entanto, é possível instruir o _setmbcp para usar a página de código definida para o local atual (consulte a seguinte lista de constantes de manifesto e associados a resultados de comportamento).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 seqüências de caracteres Multibyte.

A página de código multibyte também afeta o processamento de caracteres multibyte pelas seguintes rotinas de biblioteca de tempo de execução:

funções de _exec

_mktemp

_stat

_fullpath

funções de _spawn

_tempnam

_makepath

_splitpath

tmpnam

Além disso, todas as rotinas da biblioteca de tempo de execução que recebem os caracteres multibyte argv ou envp argumentos como parâmetros do programa (como o _exec e _spawn famílias) processar essas seqüências de caracteres de acordo com a página de código multibyte.Portanto, essas rotinas também são afetadas por uma chamada para _setmbcp que altera a página de código multibyte.

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

  • _MB_CP_ANSIPágina de código de ANSI uso obtida a partir do sistema operacional na inicialização do programa.

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

  • _MB_CP_OEMPágina de código OEM do uso obtida a partir do sistema operacional na inicialização do programa.

  • _MB_CP_SBCSUse 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.

  • Qualquer outro código válido página valor, independentemente do valor é ANSI, OEM ou outra página de código de suporte operacional--para o sistema (exceto UTF-7 e UTF-8, que não são aceitos).

Requisitos

Rotina

Cabeçalho necessário

_setmbcp

<mbctype.h>

Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.

Consulte também

Referência

_getmbcp

setlocale, wsetlocale