_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，如果可能，还可应用下列转换之一。

例程	转换
_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>

有关兼容性的详细信息，请参阅 兼容性。

另请参阅

数据转换
_mbcjistojms、_mbcjistojms_l、_mbcjmstojis、_mbcjmstojis_l
_mbctolower、_mbctolower_l、_mbctoupper、_mbctoupper_l
_mbctombb、_mbctombb_l