mbtowc、_mbtowc_l
対応するマルチバイト文字をワイド文字に変換します。
int mbtowc(
wchar_t *wchar,
const char *mbchar,
size_t count
);
int _mbtowc_l(
wchar_t *wchar,
const char *mbchar,
size_t count,
_locale_t locale
);
パラメーター
wchar
ワイド文字 (型 wchar_t) のアドレス。mbchar
バイト (マルチバイト文字) のシーケンスのアドレス。count
チェックするバイト数。ロケール
使用するロケール。
戻り値
mbchar が NULL である、mbchar がフォームを有効なマルチバイト文字を指すオブジェクト、mbtowc はマルチバイト文字のバイト数を返します。 mbchar が NULL であるかまたはオブジェクトが指すワイド文字の null 文字 (L'\0) の場合、関数は 0。 mbchar ポイントは最初の 数値の 文字内の有効なマルチバイト文字を形作らないするオブジェクト、–1 を返します。
解説
mbcharが指す mbchar が NULLである、対応するワイド文字への mbtowc 関数の変換が必要なバイト数がカウントされます。 mbtowc は wchar で発生したワイド文字 (wchar ではありません。NULL格納します。 mbtowc は MB_CUR_MAX データの多くはチェックされません。mbtowc に依存する動作に現在のロケールを使用して; _mbtowc_l は同じですが、渡されたロケールを代わりに使用します。 詳細については、「ロケール」を参照してください。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
mbtowc |
<stdlib.h> |
_mbtowc_l |
<stdlib.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ
C ランタイム ライブラリのすべてのバージョン。
使用例
// crt_mbtowc.c
/* Illustrates the behavior of the mbtowc function
*/
#include <stdlib.h>
#include <stdio.h>
int main( void )
{
int i;
char *pmbc = (char *)malloc( sizeof( char ) );
wchar_t wc = L'a';
wchar_t *pwcnull = NULL;
wchar_t *pwc = (wchar_t *)malloc( sizeof( wchar_t ) );
printf( "Convert a wide character to multibyte character:\n" );
wctomb_s( &i, pmbc, sizeof(char), wc );
printf( " Characters converted: %u\n", i );
printf( " Multibyte character: %x\n\n", *pmbc );
printf( "Convert multibyte character back to a wide "
"character:\n" );
i = mbtowc( pwc, pmbc, MB_CUR_MAX );
printf( " Bytes converted: %u\n", i );
printf( " Wide character: %x\n\n", *pwc );
printf( "Attempt to convert when target is NULL\n" );
printf( " returns the length of the multibyte character:\n" );
i = mbtowc( pwcnull, pmbc, MB_CUR_MAX );
printf( " Length of multibyte character: %u\n\n", i );
printf( "Attempt to convert a NULL pointer to a" );
printf( " wide character:\n" );
pmbc = NULL;
i = mbtowc( pwc, pmbc, MB_CUR_MAX );
printf( " Bytes converted: %u\n", i );
}
出力
Convert a wide character to multibyte character:
Characters converted: 1
Multibyte character: 61
Convert multibyte character back to a wide character:
Bytes converted: 1
Wide character: 61
Attempt to convert when target is NULL
returns the length of the multibyte character:
Length of multibyte character: 1
Attempt to convert a NULL pointer to a wide character:
Bytes converted: 0
同等の .NET Framework 関数
使用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。