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