_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l

Converts between hiragana and katakana characters.

Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported in Universal Windows Platform apps.

Syntax

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
);

Parameters

c
Multibyte character to convert.

locale
Locale to use.

Return value

Each of these functions returns the converted character c, if possible. Otherwise it returns the character c unchanged.

Remarks

The _mbctohira and _mbctokata functions test a character c and, if possible, apply one of the following conversions.

Routines	Converts
_mbctohira, _mbctohira_l	Multibyte katakana to multibyte hiragana.
_mbctokata, _mbctokata_l	Multibyte hiragana to multibyte katakana.

The output value is affected by the setting of the LC_CTYPE category setting of the locale. For more information, see setlocale. The versions of these functions are identical, except that the ones that don't have the _l suffix use the current locale for this locale-dependent behavior and the ones that do have the _l suffix instead use the locale parameter that's passed in. For more information, see Locale.

In earlier versions, _mbctohira was named jtohira and _mbctokata was named jtokata. For new code, use the new names.

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Requirements

Routine	Required header
_mbctohira	<mbstring.h>
_mbctohira_l	<mbstring.h>
_mbctokata	<mbstring.h>
_mbctokata_l	<mbstring.h>

For more compatibility information, see Compatibility.

See also

Data conversion
_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l
_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l
_mbctombb, _mbctombb_l