_mbctohira, _mbctohira_l, _mbctokata, _mbctokata_l

Article
06/05/2017

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.

Important

This API cannot be used in applications that execute in the Windows Runtime. For more information, see CRT functions not supported with /ZW.

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

Requirements

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

For more compatibility information, see Compatibility.

.NET Framework Equivalent

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.