Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

_mbsnbicmp, _mbsnbicmp_l

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

Nota importante 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 
);

string1, string2

Cadenas terminadas en null a comparar.

count

Número de bytes que se va a comparar.

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.

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

Rutina de 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 de compatibilidad, vea Compatibilidad en la Introducción.

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

Adiciones de comunidad

AGREGAR
Mostrar: