次の方法で共有


wctomb、_wctomb_l

マルチバイト文字に対応するワイド文字に変換します。これらの関数のセキュリティを強化したバージョンについては、「wctomb_s、_wctomb_s_l」を参照してください。

int wctomb(
   char *mbchar,
   wchar_t wchar 
);
int _wctomb_l(
   char *mbchar,
   wchar_t wchar,
   _locale_t locale
);

パラメーター

  • mbchar
    マルチ バイト文字のアドレス。

  • wchar
    ワイド文字。

戻り値

wctomb がマルチバイト文字列にはワイド文字を変換する (より小さい)MB_CUR_MAX ワイド文字のバイト数を返します。wchar がワイド文字 L の NULL 文字 (\ 0) の場合wctomb 1. を返します。ターゲットのポインターが null の場合に mbcharwctomb は 0 を返します。が現在のロケールに変換できない場合はが返されます wctomb ~ 1 と errno は EILSEQ に設定されます。

解説

wctomb の関数は対応するマルチバイト文字に wchar の引数をに変換します。mbchar に格納されます。プログラム内の任意の場所から関数を呼び出します。wctomb は、すべてのロケールに依存する動作に現在のロケールを使用します。_wctomb_l は、渡されたロケールを代わりに使用することを除いてwctomb と同じです。詳細については、「ロケール」を参照してください。

wctomb はパラメーターを検証します。mbchar が NULL の場合は、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーが呼び出されます。実行の継続が許可 errno は EINVALおよび関数の戻り値 (-1 に設定されます。

必要条件

ルーチン

必須ヘッダー

wctomb

<stdlib.h>

互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。

使用例

このプログラムは wctomb の関数の動作を示しています。

// crt_wctomb.cpp
// compile with: /W3
#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   int i;
   wchar_t wc = L'a';
   char *pmb = (char *)malloc( MB_CUR_MAX );

   printf( "Convert a wide character:\n" );
   i = wctomb( pmb, wc ); // C4996
   // Note: wctomb is deprecated; consider using wctomb_s
   printf( "   Characters converted: %u\n", i );
   printf( "   Multibyte character: %.1s\n\n", pmb );
}
  

同等の .NET Framework 関数

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

参照

関連項目

データ変換

ロケール

_mbclen、mblen、_mblen_l

mbstowcs、_mbstowcs_l

mbtowc、_mbtowc_l

wcstombs、_wcstombs_l

WideCharToMultiByte