_setmbcp
Establece una nueva página de códigos multibyte.
int _setmbcp(
int codepage
);
Parámetros
- codepage
Nueva paginación de código para las rutinas multibyte de la configuración regional.
Valor devuelto
Devuelve 0 si la página de códigos se establece correctamente.Si un valor no válido de la página de códigos se proporciona para codepage, devuelve – 1 y la paginación de código no cambia.Establece errno a EINVAL si un error de asignación de memoria aparece.
Comentarios
La función de _setmbcp especifica una nueva página de códigos multibyte.De forma predeterminada, el sistema en tiempo de ejecución establece automáticamente la página de códigos multibyte a la página de códigos ANSI del sistema-valor predeterminado.La paginación de código multibyte afecta a todas las rutinas multibyte que no son dependientes de la configuración regional.Sin embargo, es posible dar instrucciones _setmbcp para utilizar la página de códigos definido para la configuración regional actual (vea la siguiente lista de constantes de manifiesto y resultados asociado de comportamiento).Para obtener una lista de las rutinas multibyte dependientes de la página de códigos de la configuración regional en lugar de la página de códigos multibyte, vea Interpretación de las secuencias de caracteres multibyte.
La página de códigos multibyte también afecta al procesamiento de caracteres multibyte por las rutinas de biblioteca en tiempo de ejecución siguientes:
Además, todas las rutinas de biblioteca en tiempo de ejecución que reciben el carácter multibyte argv o argumentos del envp como parámetros (como las familias de _exec y de _spawn ) procesan estas cadenas según la página de códigos multibyte.Por tanto, estas rutinas también se ven afectadas por una llamada a _setmbcp que cambie la página de códigos multibyte.
El argumento de codepage se puede establecer en cualquiera de los valores siguientes:
página de códigos ANSI del uso de_MB_CP_ANSIobtenida del sistema operativo en el inicio del programa.
uso de_MB_CP_LOCALEla página de códigos actual de la configuración regional obtenida de una llamada anterior a setlocale.
página de códigos OEM del uso de_MB_CP_OEMobtenida del sistema operativo en el inicio del programa.
página de códigos de un solo byte de uso de_MB_CP_SBCS.Cuando la página de códigos se establece en _MB_CP_SBCS, una rutina como _ismbblead siempre devuelve false.
Cualquier otro valor válido de la página de códigos, independientemente de si el valor es el ANSI, el OEM, u otra página de códigos funcionamiento-sistema-admitida (excepto UTF-7 y UTF-8, que no se admiten).
Requisitos
rutina |
Encabezado necesario |
|---|---|
_setmbcp |
<mbctype.h> |
Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.