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 はワイド文字の null 文字 (L'\0) の場合、wctomb を返します。1. ターゲット mbchar ポインターが NULL の場合、wctomb 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 を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。