_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l

Mengonversi antara karakter Japan Industry Standard (JIS) dan Japan Microsoft (JMS).

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

unsigned int _mbcjistojms(
   unsigned int c
);
unsigned int _mbcjistojms_l(
   unsigned int c,
   _locale_t locale
);
unsigned int _mbcjmstojis(
   unsigned int c
);
unsigned int _mbcjmstojis_l(
   unsigned int c,
   _locale_t locale
);

Parameter

c
Karakter yang akan dikonversi.

locale
Lokal untuk digunakan.

Nilai hasil

Pada lokal Jepang, fungsi-fungsi ini mengembalikan karakter yang dikonversi atau mengembalikan 0 jika tidak ada konversi yang memungkinkan. Pada lokal non-Jepang, fungsi-fungsi ini mengembalikan karakter yang diteruskan.

Keterangan

Fungsi ini _mbcjistojms mengonversi karakter Japan Industry Standard (JIS) menjadi karakter Microsoft Kanji (Shift JIS). Karakter hanya dikonversi jika byte prospek dan jejak berada dalam rentang 0x21 - 0x7E. Jika byte prospek atau percobaan berada di luar rentang ini, errno diatur ke EILSEQ. Untuk informasi selengkapnya tentang kode kesalahan ini dan lainnya, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.

Fungsi ini _mbcjmstojis mengonversi karakter Shift JIS menjadi karakter JIS. Karakter dikonversi hanya jika byte prospek berada dalam rentang 0x81 - 0x9F atau 0xE0 - 0xFC dan byte jejak berada dalam rentang 0x40 - 0x7E atau 0x80 - 0xFC. Beberapa titik kode dalam rentang tersebut tidak memiliki karakter yang ditetapkan, sehingga tidak dapat dikonversi.

Nilai c harus berupa nilai 16-bit yang 8 bit atasnya mewakili byte utama karakter untuk dikonversi dan 8 bit yang lebih rendah mewakili byte jejak.

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

Dalam versi sebelumnya, _mbcjistojms dan _mbcjmstojis masing-masing dipanggil jistojms dan jmstojis, . _mbcjistojms, _mbcjistojms_l, _mbcjmstojis dan _mbcjmstojis_l harus digunakan sebagai gantinya.

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

Persyaratan

Rutin	Header yang diperlukan
_mbcjistojms	<mbstring.h>
_mbcjistojms_l	<mbstring.h>
_mbcjmstojis	<mbstring.h>
_mbcjmstojis_l	<mbstring.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Baca juga

Konversi data
_ismbb Rutinitas