_mbsnbicmp, _mbsnbicmp_l

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Compara n bytes de dos cadenas de caracteres multibyte, sin distinción de mayúsculas y minúsculas.

System_CAPS_ICON_important.jpg Importante

Esta API no se puede usar en aplicaciones que se ejecutan en Windows en tiempo de ejecución. Para más información, vea Funciones de CRT no admitidas con /ZW.

int _mbsnbicmp(  
   const unsigned char *string1,  
   const unsigned char *string2,  
   size_t count   
);  

Parámetros

string1, string2
Cadenas terminadas en NULL que se van a comparar.

count
Número de bytes que se van a comparar.

El valor devuelto indica la relación entre las subcadenas.

Valor devueltoDescripción
< 0La subcadena string1 es menor que la subcadena string2.
0La subcadena string1 es idéntica a la subcadena string2.
> 0La subcadena string1 es mayor que la subcadena string2.

Si se produce un error, _mbsnbcmp devuelve _NLSCMPERROR, que se define en String.h y Mbstring.h.

La función _mbsnbicmp realiza una comparación ordinal de, a lo sumo, los primeros count bytes de string1 y string2. La comparación se realiza mediante la conversión de cada carácter a minúscula. _mbsnbcmp es una versión de _mbsnbicmp que distingue entre mayúsculas y minúsculas. La comparación finaliza si se llega a un carácter nulo de terminación en una de las cadenas antes de que se comparen count caracteres. Si las cadenas son iguales cuando se llega a un carácter nulo de terminación en una de las cadenas antes de que se comparen count caracteres, la cadena más corta es menor.

_mbsnbicmpes similar a _mbsnicmp, salvo que compara cadenas hasta count bytes en lugar de caracteres.

Dos cadenas que contienen caracteres situados entre la 'Z' y 'a' en la tabla ASCII ('[','\', ']', ' ^', '_' y '`') se comparan de forma distinta, dependiendo de su caso. Por ejemplo, las dos cadenas "ABCDE" y "ABCD^" se comparan de una manera si la comparación es en minúscula ("abcde" > "abcd^") y de otra si es en mayúscula ("ABCDE" < "ABCD^").

_mbsnbicmpreconoce secuencias de caracteres multibyte según la página de códigos multibyte actualmente en uso. La configuración regional actual no le afecta.

Si el valor string1 o string2 es un puntero nulo, _mbsnbicmp invoca el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, la función devuelve _NLSCMPERROR y establece en errno en EINVAL.

Asignaciones de rutina de texto genérico

Rutina Tchar.h_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_tcsnicmp_strnicmp_mbsnbicmp_wcsnicmp
_tcsnicmp_l_strnicmp_l_mbsnbicmp_l_wcsnicmp_l
RutinaEncabezado necesario
_mbsnbicmp<mbstring.h>

Para obtener más información sobre compatibilidad, vea Compatibility.

Vea el ejemplo de _mbsnbcmp, _mbsnbcmp_l.

No es aplicable. Para llamar a la función estándar de C, use PInvoke. Para obtener más información, vea Ejemplos de invocación de plataforma.

Manipulación de cadenas
_mbsnbcat, _mbsnbcat_l
_mbsnbcmp, _mbsnbcmp_l
_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l

Mostrar: