_mbsnbicmp, _mbsnbicmp_l

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

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.

Valor devuelto

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

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

Comentarios

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.

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

Dos cadenas que contienen caracteres situados entre la 'Z' y la 'a' en la tabla ASCII ('[', '\', ']', '^', '_' y '`') se comparan de forma distinta. 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^").

_mbsnbicmp reconoce las secuencias de caracteres multibyte de acuerdo con la página de códigos multibyte actualmente en uso. La configuración regional actual no le afecta.

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

Asignaciones de rutina de texto genérico

Requisitos

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

Ejemplo

Consulte el ejemplo de _mbsnbcmp, _mbsnbcmp_l.

Equivalente en .NET Framework

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.

Vea también

Referencia

Manipulación de cadenas (CRT)

_mbsnbcat, _mbsnbcat_l

_mbsnbcmp, _mbsnbcmp_l

_stricmp, _wcsicmp, _mbsicmp, _stricmp_l, _wcsicmp_l, _mbsicmp_l