_mbsnbicmp, _mbsnbicmp_l

Artículo
04/10/2013

Compara los bytes de n de dos cadenas de multibyte- carácter, omitiendo el caso.

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

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

Parámetros

string1, string2
Cadenas terminadas en null a comparar.
count
Número de bytes que se va a comparar.

Valor devuelto

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

Valor devuelto	Descripción
< 0	subcadena de string1 menos que la subcadena de string2.
0	subcadena de string1 idéntica a la subcadena de string2.
> 0	subcadena de string1 mayor que la de string2.

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

Comentarios

La función de _mbsnbicmp lexicográficamente compara, como máximo, los primeros bytes de count de string1 y string2.La comparación se realiza sin tener en cuenta el caso; _mbsnbcmp es una versión con distinción entre mayúsculas y minúsculas de _mbsnbicmp.Finaliza la comparación si un carácter null de terminación se consigue en cualquier cadena antes de que se comparan los caracteres de count.Si las cadenas son iguales cuando un carácter null de terminación se consigue en cualquier cadena antes de que se comparan los caracteres de count, la cadena más corta es menos.

_mbsnbicmp es similar a _mbsnicmp, salvo que compara las cadenas por bytes en lugar de los caracteres.

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

_mbsnbicmp reconoce secuencias de multibyte- carácter como página de códigos multibyte actualmente en uso.No afecta a la configuración regional actual.

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

Asignaciones de la rutina de Genérico- texto