Partilhar via


_setmbcp

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 é conjunto com êxito.Se for fornecido um valor de página de código inválido de codepage, retornará – 1 e a configuração de página de código não é alterada. Define errno para EINVAL Se ocorrer uma falha de alocação de memória.

Comentários

The _setmbcp função especifica uma nova página de código multibyte. Por padrão, o em time de execução sistema define automaticamente a página de código multibyte na 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 são dependente da localidade.No entanto, é possível instruir _setmbcp Para usar a página de código definida para a localidade corrente (consulte a seguinte lista de constantes de manifesto e resultados do comportamento associado). Para obter uma lista das rotinas multibyte que dependem da página de código local em vez da página de código multibyte, consulte Interpretação de seqüências de caractere multibyte.

A página de código multibyte também afeta o processamento de caractere multibyte pelo seguinte em time de execução rotinas de biblioteca:

funções _exec

_mktemp

_stat

_fullpath

funções _spawn

_tempnam

_makepath

_splitpath

tmpnam

Além disso, todas sistema autônomo rotinas da biblioteca de time de execução que recebem caractere multibyte argv ou envp argumentos sistema autônomo parâmetros do programa (sistema autônomo o _exec e _spawn famílias) processam essas cadeias de caractere de acordo com para a página de código multibyte. Portanto, essas rotinas também são afetadas por uma telefonar para _setmbcp que altera a página de código multibyte.

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

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

  • _MB_CP_LOCALE   Usar a página de código da localidade corrente obtida de uma telefonar anterior setlocale.

  • _MB_CP_OEM   Página de código OEM uso 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 sistema autônomo _MB_CP_SBCS, uma rotina, sistema autônomo _ismbblead sempre retorna false.

  • Qualquer Outros código válido página valor, o valor seja um ANSI, OEM ou Outros página de código operacional-sistema-suportado (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