_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l

ひらがなとカタカナの文字変換をします。

重要

この API は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。

構文

unsigned int _mbctohira(
   unsigned int c
);
unsigned int _mbctohira_l(
   unsigned int c,
   _locale_t locale
);
unsigned int _mbctokata(
   unsigned int c
);
unsigned int _mbctokata_l(
   unsigned int c,
   _locale_t locale
);

パラメーター

c
変換するマルチバイト文字。

locale
使用するロケール。

戻り値

これらの各関数は、可能であれば、変換される文字 c を返します。 それ以外の場合は、文字 c をそのまま返します。

解説

_mbctohira 関数および _mbctokata 関数は、文字 c をテストし、可能であれば、次の変換のいずれか 1 つを適用します。

ルーチン	変換
_mbctohira, _mbctohira_l	マルチバイトのカタカナをマルチバイトのひらがなに変換します。
_mbctokata, _mbctokata_l	マルチバイトのひらがなをマルチバイトのカタカナに変換します。

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

以前のバージョンでは、_mbctohira は jtohira、_mbctokata は jtokata という名前でした。 新しいコードには、新しい名前を使用してください。

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

必要条件

ルーチンによって返される値	必須ヘッダー
_mbctohira	<mbstring.h>
_mbctohira_l	<mbstring.h>
_mbctokata	<mbstring.h>
_mbctokata_l	<mbstring.h>

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

関連項目

データ変換
_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l
_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l
_mbctombb, _mbctombb_l