次の方法で共有


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
    (バイトマルチバイト文字のシーケンス) のアドレス。

  • カウント
    チェックするバイト数。

  • ロケール
    使用するロケール。

戻り値

mbcharnull でない場合はに mbchar がフォームに有効なマルチバイト文字がポイントするオブジェクトmbtowc はマルチバイト文字のバイトの長さを返します。mbchar が null の場合またはオブジェクトが指すワイド文字 L の NULL 文字 (\ 0) の場合0 が返されます。mbchar が指すオブジェクトが最初の 文字内の有効なマルチバイト文字を構成して– 1 を返します。

解説

mbtowc の関数の変換は mbchar が null の場合は対応するワイド文字に mbchar によって指されるバイト数をカウントします。mbtowcwchar で発生するワイド文字 wchar ではありません。null 保存します。mbtowcMB_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 を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

データ変換

MultiByteToWideChar

ロケール

マルチバイト文字のシーケンスの解釈

_mbclen、mblen、_mblen_l

wcstombs、_wcstombs_l

wctomb、_wctomb_l