_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at _mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l.
Converts between hiragana and katakana characters.
This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported with /ZW. |
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.
Each of these functions returns the converted character c, if possible. Otherwise it returns the character c unchanged.
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; see setlocale for more information. 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.
| Routine | Required header |
|---|---|
_mbctohira | <mbstring.h> |
_mbctohira_l | <mbstring.h> |
_mbctokata | <mbstring.h> |
_mbctokata_l | <mbstring.h> |
For more compatibility information, see Compatibility.
Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.
Data Conversion
_mbcjistojms, _mbcjistojms_l, _mbcjmstojis, _mbcjmstojis_l
_mbctolower, _mbctolower_l, _mbctoupper, _mbctoupper_l
_mbctombb, _mbctombb_l