_setmbcp

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Définit une nouvelle page de codes multioctets.

int _setmbcp(  
   int codepage   
);  

Paramètres

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

Retourne 0 si la page de codes est correctement définie. Si une valeur de page de code non valide est fournie pour codepage, retourne –&1; et le paramètre de la page de code est inchangé. Jeux de errno à EINVAL si un échec d’allocation de mémoire se produit.

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

La page de codes multioctets affecte également le traitement des caractères multioctets par les routines de bibliothèque Runtime suivants :

fonctions _exec_mktemp_stat
_fullpath_spawn (fonctions)_tempnam
_makepath_splitpathtmpnam

En outre, toutes les routines de la bibliothèque Runtime qui reçoivent des caractères multioctets argv ou envp arguments en tant que paramètres de programme (tels que les _exec et _spawn familles) traiter ces chaînes en fonction de la page de codes multioctets. Par conséquent, ces routines sont également affectés par un appel à _setmbcp qui modifie la page de codes multioctets.

Le codepage argument peut être défini à une des valeurs suivantes :

  • _MB_CP_ANSIPage de codes ANSI utilisation obtenue à partir du système d’exploitation au démarrage du programme.

  • _MB_CP_LOCALEUtilisation de page de codes de paramètres régionaux actuels obtenu à partir d’un appel précédent à setlocale.

  • _MB_CP_OEMPage de codes OEM d’utiliser obtenu à partir du système d’exploitation au démarrage du programme.

  • _MB_CP_SBCSUtilisez la page de codes mono-octet. Lorsque la page de codes est définie sur _MB_CP_SBCS, une routine comme _ismbblead retourne toujours false.

  • N’importe quel autre code valide page valeur, que la valeur soit ANSI, OEM ou une autre page de code d’exploitation-système-pris en charge (sauf UTF-7 et UTF-8, qui ne sont pas pris en charge).

RoutineEn-tête requis
_setmbcp<mbctype.h>

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

_getmbcp
SetLocale, _wsetlocale

Afficher: