_setmbcp

  • Article

Définit une nouvelle page de codes multioctets.

Syntaxe

int _setmbcp(
   int codepage
);

Paramètres

codepage
Nouveau paramètre de page de codes pour les routines multioctets indépendantes des paramètres régionaux.

Valeur retournée

Retourne 0 si la page de codes est correctement définie. Si une valeur de page de codes non valide est fournie pour codepage, retourne -1 et le paramètre de page de codes n’est pas modifié. Affecte à errno la valeur EINVAL en cas d’échec d’allocation de mémoire.

Notes

La fonction _setmbcp spécifie une nouvelle page de codes multioctets. Par défaut, le système de runtime définit automatiquement la page de codes multioctets comme étant la page de codes ANSI par défaut du système. Le paramètre de page de codes multioctets affecte toutes les routines multioctets qui ne dépendent pas des paramètres régionaux. Toutefois, il est possible d’utiliser _setmbcp la page de codes définie pour les paramètres régionaux actuels (consultez la liste suivante des constantes manifestes et des résultats de comportement associés). Pour obtenir la liste des routines multioctets qui dépendent de la page de codes de paramètres régionaux plutôt que de la page de codes multioctets, consultez Interprétation des séquences de caractères multioctets.

L’argument codepage peut être défini avec l’une des valeurs suivantes :

  • _MB_CP_ANSI Utilise la page de codes ANSI obtenue du système d’exploitation au démarrage du programme.

  • _MB_CP_LOCALE Utilisez la page de codes des paramètres régionaux actuels obtenue à partir d’un appel précédent à setlocale.

  • _MB_CP_OEM Utilise la page de codes OEM obtenue du système d’exploitation au démarrage du programme.

  • _MB_CP_SBCS Utilise la page de codes à octet unique. Lorsque la page de codes est définie _MB_CP_SBCSsur , une routine telle que _ismbblead toujours retourne false.

  • _MB_CP_UTF8 Utilisez UTF-8. Lorsque la page de codes est définie _MB_CP_UTF8sur , une routine telle que _ismbblead toujours retourne false.

  • Toute autre valeur de page de codes valide, que la valeur soit une page de codes ANSI, OEM ou autre page de codes prise en charge par le système d’exploitation (sauf UTF-7, qui n’est pas prise en charge).

Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.

Spécifications

Routine En-tête requis
_setmbcp <mbctype.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Voir aussi

_getmbcp
setlocale, _wsetlocale