_setmbcp
Define uma nova página de código de multibyte.
int _setmbcp(
int codepage
);
Parâmetros
- codepage
Novo composição de código para rotinas com independentes multibyte.
Valor de retorno
Retornará 0 se a página de código é definida com êxito. Se um valor inválido de página de código é fornecido para codepage, 1 será retornado e a composição do código é inalterados. Define errno a EINVAL se uma falha de alocação de memória ocorre.
Comentários
A função de _setmbcp especifica uma nova página de código de multibyte. Por padrão, o sistema de tempo de execução define automaticamente a página de código de multibyte para a página de código ANSI de sistema padrão. A composição de código de multibyte afeta todas as rotinas de multibyte que não é dependente da localidade. No entanto, é possível instruir _setmbcp para usar a página de código definido para a localidade atual (consulte a seguinte lista de manifestas e constantes de resultados associada do comportamento). Para obter uma lista das rotinas multibyte dependentes na página de código da localidade em vez da página de código de multibyte, consulte Interpretação de sequências de caracteres Multibyte-.
A página de código de multibyte também afeta o processamento de multibyte- caractere por seguintes rotinas de biblioteca de tempo de execução:
Além disso, todas as rotinas de biblioteca de tempo de execução que recebem o multibyte- caractere argv ou argumentos de programa de envp como parâmetros (como as famílias de _exec e de _spawn ) processam essas cadeias de caracteres de acordo com a página de código de multibyte. Em virtude disso, essas rotinas também são afetadas por uma chamada a _setmbcp que modifica a página de código de multibyte.
O argumento de 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 atual da localidade obtido de uma chamada a anterior 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 um byte. Quando a página de código é definida como _MB_CP_SBCS, uma rotina como _ismbblead sempre retorna false.
Qualquer outro valor válido da página de código, independentemente do valor é ANSI, OEM, ou outra página de código operar-sistema- suporte (exceto UTF-7 e UTF-8, que não têm suporte).
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
_setmbcp |
<mbctype.h> |
Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.