_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 configuración regional- independiente.
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- 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 definida para la configuración regional actual (vea la siguiente lista de constantes de manifiesto y resultados asociados 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 secuencias de Multibyte- carácter.
La página de códigos multibyte también afecta al procesamiento de multibyte- carácter 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 multibyte- carácter 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:
_MB_CP_ANSI Utilice la página de códigos ANSI obtenida del sistema operativo en el inicio del programa.
_MB_CP_LOCALE Utilice la página de códigos actual de la configuración regional obtenida de una llamada anterior a setlocale.
_MB_CP_OEM Utilice la página de códigos OEM obtenida del sistema operativo en el inicio del programa.
_MB_CP_SBCS Utilice la página de códigos de solo- byte. 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- compatible (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.