_mbcjistojms、 _mbcjistojms_l、 _mbcjmstojis、 _mbcjmstojis_l
日本工業標準 (JIS: Japan Industry Standard) 文字と Japan Microsoft (JMS) 文字の間を変換します。
重要
この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。
構文
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
);
パラメーター
c
変換する文字。
locale
使用するロケール。
戻り値
日本語のロケールで、これらの関数は変換された文字を返すか、または変換可能でない場合は 0 を返します。 日本語以外のロケールで、これらの関数は、渡された文字を返します。
解説
_mbcjistojms 関数は、日本工業標準 (JIS) の文字を Microsoft の漢字 (Shift JIS) 文字に変換します。 先行バイトと後続バイトが範囲 0x21 – 0x7E にある場合にのみ、文字が変換されます。 先行バイトまたは後続バイトがこの範囲外にある場合は、errno は EILSEQ に設定されます。 このエラー コードとその他のエラー コードの詳細については、「 errno、 _doserrno、 _sys_errlist、および _sys_nerr」を参照してください。
_mbcjmstojis関数は、Shift JIS 文字を JIS 文字に変換します。 先行バイトが 0x81 – 0x9F または 0xE0 – 0xFC の範囲にあり、後続バイトが 0x40 – 0x7E または 0x80 – 0xFC の範囲にある場合にのみ、文字が変換されます。 その範囲内の一部のコード ポイントには文字が割り当てられないため、変換できません。
値 c は上位 8 のビットが変換される文字の先行バイトを表し、下位の 8 ビットが後続バイトを表す、16 ビットの値です。
出力値は、ロケールの LC_CTYPE カテゴリ設定の設定によって影響を受けます。 詳細については、setlocaleを参照してください。 _l サフィックスが付いていないこれらの関数のバージョンでは、このロケールに依存する動作に現在のロケールを使用します。_l サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。 詳細については、「 Locale」を参照してください。
以前のバージョンでは、 _mbcjistojms と _mbcjmstojis はそれぞれ jistojms と jmstojisと呼ばれます。 _mbcjistojms、 _mbcjistojms_l、 _mbcjmstojis 、 _mbcjmstojis_l を代わりに使用する必要があります。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー |
|---|---|
_mbcjistojms |
<mbstring.h> |
_mbcjistojms_l |
<mbstring.h> |
_mbcjmstojis |
<mbstring.h> |
_mbcjmstojis_l |
<mbstring.h> |
互換性の詳細については、「 Compatibility」を参照してください。