_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 に設定されます。 このエラー コードとその他のエラー コードの詳細については、「、、、、、」_sys_nerrを参照してくださいerrno。 _sys_errlist_doserrno

この関数は _mbcjmstojis 、Shift JIS 文字を JIS 文字に変換します。 先行バイトが 0x81 – 0x9F または 0xE0 – 0xFC の範囲にあり、後続バイトが 0x40 – 0x7E または 0x80 – 0xFC の範囲にある場合にのみ、文字が変換されます。 その範囲内の一部のコード ポイントには文字が割り当てられないため、変換できません。

値 c は上位 8 のビットが変換される文字の先行バイトを表し、下位の 8 ビットが後続バイトを表す、16 ビットの値です。

出力値は、ロケールの LC_CTYPE カテゴリ設定の設定によって影響を受けます。 詳細については、setlocaleを参照してください。 _l サフィックスが付いていないこれらの関数のバージョンでは、このロケールに依存する動作に現在のロケールを使用します。_l サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。 詳細については、「 Locale」を参照してください。

以前のバージョンでは、 _mbcjistojms_mbcjmstojisそれぞれ呼び出jistojmsjmstojisされました。 _mbcjistojms、_mbcjistojms_l、代_mbcjmstojis_l_mbcjmstojisわりに使用する必要があります。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

必要条件

ルーチンによって返される値 必須ヘッダー
_mbcjistojms <mbstring.h>
_mbcjistojms_l <mbstring.h>
_mbcjmstojis <mbstring.h>
_mbcjmstojis_l <mbstring.h>

互換性の詳細については、「 Compatibility」を参照してください。

関連項目

データ変換
_ismbb ルーチン