_mbsbtype, _mbsbtype_l

Mengembalikan jenis byte dalam string.

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 _mbsbtype(
   const unsigned char *mbstr,
   size_t count
);
int _mbsbtype_l(
   const unsigned char *mbstr,
   size_t count,
   _locale_t locale
);

Parameter

mbstr
Alamat urutan karakter multibyte.

count
Byte offset dari kepala string.

locale
Lokal untuk digunakan.

Nilai hasil

_mbsbtype dan _mbsbtype_l mengembalikan nilai bilangan bulat yang menunjukkan hasil pengujian pada byte yang ditentukan. Konstanta manifes dalam tabel berikut didefinisikan dalam Mbctype.h.

Nilai hasil	Jenis byte
_MBC_SINGLE (0)	Karakter byte tunggal. Misalnya, di halaman kode 932, _mbsbtype mengembalikan 0 jika byte yang ditentukan berada dalam rentang 0x20 - 0x7E atau 0xA1 - 0xDF.
_MBC_LEAD (1)	Memimpin byte karakter multibyte. Misalnya, di halaman kode 932, _mbsbtype mengembalikan 1 jika byte yang ditentukan berada dalam rentang 0x81 - 0x9F atau 0xE0 - 0xFC.
_MBC_TRAIL (2)	Byte berikutnya dari karakter multibyte. Misalnya, di halaman kode 932, _mbsbtype mengembalikan 2 jika byte yang ditentukan berada dalam rentang 0x40 - 0x7E atau 0x80 - 0xFC.
_MBC_ILLEGAL (-1)	NULL string, karakter tidak valid, atau byte null yang ditemukan sebelum byte saat offset count di mbstr.

Keterangan

Fungsi menentukan _mbsbtype jenis byte dalam string karakter multibyte. Fungsi ini hanya memeriksa byte saat offset count dalam mbstr, mengabaikan karakter yang tidak valid sebelum byte yang ditentukan.

Nilai output dipengaruhi oleh pengaturan LC_CTYPE pengaturan kategori lokal. Untuk informasi selengkapnya, lihat setlocale . Versi fungsi ini tanpa _l akhiran menggunakan lokal saat ini untuk perilaku dependen lokal ini; versi dengan _l akhiran identik kecuali menggunakan parameter lokal yang diteruskan sebagai gantinya. Untuk informasi selengkapnya, lihat Lokal.

Jika string input adalah NULL, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, errno diatur ke EINVAL dan fungsi mengembalikan _MBC_ILLEGAL.

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

Persyaratan

Rutin	Header yang diperlukan	Header opsional
_mbsbtype	<mbstring.h>	<mbctype.h>*
_mbsbtype_l	<mbstring.h>	<mbctype.h>*

* Untuk konstanta manifes yang digunakan sebagai nilai pengembalian.

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Baca juga

Klasifikasi byte