_setmbcp

  • Articolo

Imposta una nuova tabella codici multibyte.

Sintassi

int _setmbcp(
   int codepage
);

Parametri

codepage
Nuova impostazione della tabella codici per le routine multibyte indipendenti dalle impostazioni locali.

Valore restituito

Restituisce 0 se la tabella codici è impostata correttamente. Se viene specificato un valore della tabella codici non valido per codepage, restituisce -1 e l'impostazione della tabella codici non è modificata. Imposta errno su EINVAL se si verifica un errore di allocazione di memoria.

Osservazioni:

La funzione _setmbcp specifica una nuova tabella codici multibyte. Per impostazione predefinita, il sistema di runtime imposta automaticamente la tabella codici multibyte sulla tabella codici ANSI predefinita del sistema. L'impostazione della tabella codici multibyte influisce su tutte le routine multibyte che non dipendono dalle impostazioni locali. Tuttavia, è possibile indicare _setmbcp di usare la tabella codici definita per le impostazioni locali correnti (vedere l'elenco seguente di costanti manifesto e risultati del comportamento associati). Per un elenco delle routine multibyte dipendenti dalla tabella codici delle impostazioni locali anziché dalla tabella codici multibyte, vedere Interpretazione delle sequenze di caratteri multibyte.

L'argomento codepage può essere impostato su uno dei valori seguenti:

  • _MB_CP_ANSI Per usare la tabella codici ANSI ottenuta dal sistema operativo all'avvio del programma.

  • _MB_CP_LOCALE Usare la tabella codici delle impostazioni locali corrente ottenuta da una chiamata precedente a setlocale.

  • _MB_CP_OEM Per usare la tabella codici OEM ottenuta dal sistema operativo all'avvio del programma.

  • _MB_CP_SBCS Per usare la tabella codici a byte singolo. Quando la tabella codici è impostata su _MB_CP_SBCS, una routine come _ismbblead restituisce sempre false.

  • _MB_CP_UTF8 Usare UTF-8. Quando la tabella codici è impostata su _MB_CP_UTF8, una routine come _ismbblead restituisce sempre false.

  • Qualsiasi altro valore valido della tabella codici, indipendentemente dal fatto che il valore sia ansi, OEM o un'altra tabella codici supportata dal sistema operativo (ad eccezione di UTF-7, che non è supportata).

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Ciclo Intestazione obbligatoria
_setmbcp <mbctype.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Vedi anche

_getmbcp
setlocale, _wsetlocale