Bagikan melalui

_mbsnbicmp, _mbsnbicmp_l

  • Artikel

Membandingkan n byte dari dua string karakter multibyte, dan mengabaikan kasus.

Penting

API ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime. Untuk informasi selengkapnya, lihat Fungsi CRT yang tidak didukung di aplikasi Platform Windows Universal.

Sintaks

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

Parameter

string1, string2
String yang dihentikan null untuk dibandingkan.

count
Jumlah byte yang akan dibandingkan.

Nilai hasil

Nilai pengembalian menunjukkan hubungan antara substring.

Nilai hasil Deskripsi
< 0 string1 substring kurang dari string2 substring.
0 string1 substring identik dengan string2 substring.
> 0 string1 substring lebih besar dari string2 substring.

Pada kesalahan, _mbsnbicmp mengembalikan _NLSCMPERROR, yang ditentukan dalam String.h dan Mbstring.h.

Keterangan

Fungsi ini _mbsnbicmp melakukan perbandingan ordinal paling banyak byte pertama count dan string1 string2. Perbandingan dilakukan dengan mengonversi setiap karakter menjadi huruf kecil; _mbsnbcmp adalah versi peka huruf besar/kecil dari _mbsnbicmp. Perbandingan berakhir jika karakter null yang mengakhiri tercapai dalam salah satu string sebelum count karakter dibandingkan. Jika string sama ketika karakter null yang mengakhiri tercapai dalam salah satu string sebelum count karakter dibandingkan, string yang lebih pendek lebih kecil.

_mbsnbicmp mirip _mbsnbcmpdengan , kecuali membandingkan string hingga count byte alih-alih oleh karakter.

Dua string yang berisi karakter yang terletak antara 'Z' dan 'a' dalam tabel ASCII ('[', '\', ']', '^', '_', dan ''') dibandingkan secara berbeda, tergantung pada kasusnya. Misalnya, dua string "ABCDE" dan "ABCD^" membandingkan satu cara jika perbandingannya adalah huruf kecil ("abcde" > "abcd^") dan cara lain ("ABCDE" < "ABCD^") jika huruf besar.

_mbsnbicmp mengenali urutan karakter multibyte sesuai dengan halaman kode multibyte yang saat ini digunakan. Ini tidak terpengaruh oleh pengaturan lokal saat ini.

Jika atau string1 string2 adalah penunjuk null, _mbsnbicmp panggil handler parameter yang tidak valid seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, fungsi mengembalikan _NLSCMPERROR dan mengatur errno ke EINVAL.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

Rutinitas Tchar.h _UNICODE dan _MBCS tidak ditentukan _MBCS Didefinisikan _UNICODE Didefinisikan
_tcsnicmp _strnicmp _mbsnbicmp _wcsnicmp
_tcsnicmp_l _strnicmp_l _mbsnbicmp_l _wcsnicmp_l

Persyaratan

Rutin Header yang diperlukan
_mbsnbicmp <mbstring.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Lihat contoh untuk _mbsnbcmp, _mbsnbcmp_l.

Lihat juga

Manipulasi string
_mbsnbcat, _mbsnbcat_l
_mbsnbcmp, _mbsnbcmp_l
_stricmp, , _wcsicmp_mbsicmp, _stricmp_l, , _wcsicmp_l,_mbsicmp_l