_setmbcp
Définit une nouvelle page de codes multioctets.
int _setmbcp(
int codepage
);
Paramètres
- codepage
Nouveaux paramètres de la page de codes pour les routines multioctets indépendantes des paramètres régionaux.
Valeur de retour
Retourne 0 si la page de codes est définie avec succès.Si une valeur valide de page de codes est fournie pour codepage, retourne - 1 et les paramètres de la page de code reste inchangé.Définit errno à EINVAL si une défaillance d'allocation de mémoire se produit.
Notes
La fonction d' _setmbcp spécifie une nouvelle page de codes multioctets.Par défaut, le système runtime définit automatiquement la page de codes multioctets dans la page de codes ANSI de système-valeur par défaut.Les paramètres de la page multioctets de code affectent toutes les routines multioctets qui ne sont pas dépendant de paramètres régionaux.Toutefois, il est possible de demander à _setmbcp pour utiliser la page de codes définie pour les paramètres régionaux (consultez la liste suivante des constantes manifestes et de résultats associés de comportement).Pour une liste des routines multioctets qui dépendent de la page de codes des paramètres régionaux plutôt que la page de codes multioctets, consultez l' Interprétation des séquences de caractères multioctets.
La page de codes multioctets affecte également gérer à caractères multioctets par les routines de la bibliothèque Runtime suivantes :
En outre, les routines de la bibliothèque Runtime qui acceptent argv à caractères multioctets ou des arguments de programme d' envp à mesure que les paramètres (tels que les familles d' _exec et d' _spawn ) traitent ces chaînes en fonction de la page de codes multioctets.Par conséquent, ces routines sont également affectées par un appel à _setmbcp qui modifie la page de codes multioctets.
L'argument d' codepage peut être définie à l'une des valeurs suivantes :
page de codes ANSI de utilisation d'_MB_CP_ANSIobtenue du système d'exploitation au démarrage du programme.
utilisation d'_MB_CP_LOCALEla page de codes actuelle des paramètres régionaux obtenue à partir d'un appel précédent à setlocale.
page de codes OEM d'utilisation d'_MB_CP_OEMobtenue du système d'exploitation au démarrage du programme.
page de codes codée sur un octet d'utilisation d'_MB_CP_SBCS.Lorsque la page de codes est définie à _MB_CP_SBCS, une routine telle que _ismbblead retourne toujours la valeur false.
Une autre valeur de page de codes non valide, que la valeur est ANSI, OEM, ou toute autre page de codes fonctionnement-système-prise en charge (sauf UTF-7 et UTF-8, qui ne sont pas pris en charge).
Configuration requise
routine |
en-tête requis |
|---|---|
_setmbcp |
<mbctype.h> |
Pour plus d'informations de compatibilité, consultez compatibilité dans l'introduction.