_ismbclegal, _ismbclegal_l, _ismbcsymbol, _ismbcsymbol_l

Comprueba si un carácter multibyte es un carácter o símbolo válido.

Importante

Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para obtener más información, vea Funciones de CRT no admitidas en aplicaciones de la Plataforma universal de Windows.

Sintaxis

int _ismbclegal(
   unsigned int c
);
int _ismbclegal_l(
   unsigned int c,
   _locale_t locale
);
int _ismbcsymbol(
   unsigned int c
);
int _ismbcsymbol_l(
   unsigned int c,
   _locale_t locale
);

Parámetros

c
Carácter que se va a probar.

locale
Configuración regional que se va a usar.

Valor devuelto

Cada una de estas rutinas devuelve un valor distinto de cero si el carácter satisface la condición de prueba. De lo contrario, devuelven 0. Si c<= 255 y hay una rutina correspondiente _ismbb (por ejemplo, _ismbcalnum corresponde a _ismbbalnum), el resultado es el valor devuelto de la rutina correspondiente _ismbb .

Comentarios

Cada una de estas funciones prueba si un carácter multibyte dado cumple una condición determinada.

Las versiones de estas funciones con el sufijo _l son idénticas salvo que usan la configuración regional pasada en lugar de la configuración regional de su comportamiento dependiente de la configuración regional. Para obtener más información, vea Locale.

Routine	Condición de prueba	Ejemplo de la página de códigos 932
_ismbclegal	Multibyte válido	Devuelve un valor distinto de cero si y solo si el primer byte de c está dentro de los intervalos 0x81 - 0x9F o 0xE0 - 0xFC, y el segundo byte está dentro de los intervalos 0x40 - 0x7E o 0x80 - FC.
_ismbcsymbol	Símbolo multibyte	Devuelve un valor distinto de cero si y solo si 0x8141<=c<=0x81AC.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas de texto genérico

Rutina Tchar.h	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_istlegal	Siempre devuelve false	_ismbclegal	Siempre devuelve false.
_istlegal_l	Siempre devuelve false	_ismbclegal_l	Siempre devuelve false.

Requisitos

Routine	Encabezado necesario
_ismbclegal, _ismbclegal_l	<mbstring.h>
_ismbcsymbol, _ismbcsymbol_l	<mbstring.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Consulte también

Clasificación de caracteres
_ismbc Rutinas
is, isw rutinas
_ismbb Rutinas