Exportar (0) Imprimir
Expandir todo
and
div
eof
not
or
xor
Expandir Minimizar
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

_mbsnbicmp, _mbsnbicmp_l

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

Nota importante 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 con /ZW.

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

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 devuelto

Descripción

< 0

La subcadena string1 es menor que la subcadena string2.

0

La subcadena string1 es idéntica a la subcadena string2.

> 0

La 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 compara lexicográficamente, como máximo, los primeros count bytes de string1 y string2. La comparación se realiza sin distinción de mayúsculas y minúsculas; _mbsnbcmp es una versión con distinción de mayúsculas y minúsculas de _mbsnbicmp. 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 que compara las cadenas por bytes en lugar de los 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 cadenas “ABCDE” y “ABCD^” se comparan de una forma si la comparación se hace en minúsculas (“abcde” > “abcd^") y de otra forma (“ABCDE” < “ABCD^") si se hace en mayúsculas.

_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 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

Rutina

Encabezado necesario

_mbsnbicmp

<mbstring.h>

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

Consulte 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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft