wctomb_s、_wctomb_s_l
対応するワイド文字をマルチバイト文字に変換します。 この関数は、「CRT のセキュリティ機能」に説明されているように、wctomb、_wctomb_l のセキュリティが強化されたバージョンです。
errno_t wctomb_s(
int *pRetValue,
char *mbchar,
size_t sizeInBytes,
wchar_t wchar
);
errno_t _wctomb_s_l(
int *pRetValue,
char *mbchar,
size_t sizeInBytes,
wchar_t wchar,
_locale_t locale
);
パラメーター
[出力] pRetValue
バイト数、または結果を示すコード。[出力] mbchar
マルチバイト文字のアドレス。[入力] sizeInBytes
mbcharバッファーのサイズ。[入力] wchar
ワイド文字。[入力] locale
使用するロケール。
戻り値
正常終了した場合は 0 を返します。失敗した場合はエラー コードを返します。
エラー条件
mbchar |
sizeInBytes |
戻り値 |
pRetValue |
|---|---|---|---|
NULL |
>0 |
EINVAL |
変更されない |
任意 |
>INT_MAX |
EINVAL |
変更されない |
任意 |
小さすぎる |
EINVAL |
変更されない |
上記のいずれかのエラー条件が発生すると、「パラメーターの検証」に説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、wctomb は EINVAL を返し、errno を EINVAL に設定します。
解説
wctomb_s 関数は、対応するマルチバイト文字に wchar 引数を変換し、mbcharに結果を保存します。 プログラムの任意の場所から関数を呼び出すことができます。
wctomb_s マルチバイト文字にワイド文字を変換する場合、整数に pRetValueが指すワイド文字 (より小さい)、MB_CUR_MAXバイト数を取得します。 wchar はワイド文字の null 文字 (L'\0) の場合、wctomb_s は 1.で pRetValue を塗りつぶします。 ターゲット mbchar ポインターが NULL の場合、wctomb_s は pRetValueに 0 を配置します。 変換は現在のロケールで有効でない場合、wctomb_s は pRetValueに–1 を配置します。
wctomb_s は ロケールに依存情報に現在のロケールを使用して; _wctomb_s_l は同じですが、渡されたロケールを代わりに使用します。 詳細については、「ロケール」を参照してください。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
wctomb_s |
<stdlib.h> |
_wctomb_s_l |
<stdlib.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
次のプログラムは、wctomb 関数の動作を示しています。
// crt_wctomb_s.cpp
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
int i;
wchar_t wc = L'a';
char *pmb = (char *)malloc( MB_CUR_MAX );
printf_s( "Convert a wide character:\n" );
wctomb_s( &i, pmb, MB_CUR_MAX, wc );
printf_s( " Characters converted: %u\n", i );
printf_s( " Multibyte character: %.1s\n\n", pmb );
}
同等の .NET Framework 関数
使用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。