_ecvt_s
double の文字列に数値を変換します。 この関数は、「CRT のセキュリティ機能」に説明されているように、_ecvt のセキュリティが強化されたバージョンです。
errno_t _ecvt_s(
char * _Buffer,
size_t _SizeInBytes,
double _Value,
int _Count,
int *_Dec,
int *_Sign
);
template <size_t size>
errno_t _ecvt_s(
char (&_Buffer)[size],
double _Value,
int _Count,
int *_Dec,
int *_Sign
); // C++ only
パラメーター
[出力] _Buffer
文字列へのポインターを使用して、変換の結果。[入力] _SizeInBytes
バッファーのサイズ (バイト数)。[入力] _Value
変換される数値。[入力] _Count
保存する桁数。[出力] _Dec
保存された小数点位置。[出力] _Sign
変換された数値とします。
戻り値
正常に終了した場合は 0 を返します。 エラーが発生した場合の戻り値はエラー コードです。 エラー コードは、Errno.h で定義されます。 詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。
無効なパラメーターの場合は、次の表に示すように、この関数は パラメーターの検証"に説明されているように、無効なパラメーター ハンドラーを呼び出します。 実行の継続が許可された場合、この関数は errno を EINVAL に設定し、EINVAL を返します。
エラー条件
_Buffer |
_SizeInBytes |
_Value |
_Count |
_Dec |
_Sign |
戻り値 |
buffer の値 |
|---|---|---|---|---|---|---|---|
NULL |
任意 |
任意 |
任意 |
任意 |
任意 |
EINVAL |
変更されない。 |
NULL 以外 (有効なメモリを指し示している) |
<=0 |
任意 |
任意 |
任意 |
任意 |
EINVAL |
変更されない。 |
任意 |
任意 |
任意 |
任意 |
NULL |
任意 |
EINVAL |
変更されない。 |
任意 |
任意 |
任意 |
任意 |
任意 |
NULL |
EINVAL |
変更されない。 |
セキュリティの問題
_ecvt_s は buffer が有効なメモリを指さないし、NULLであるアクセス違反が発生することがあります。
解説
_ecvt_s 関数は、文字列、浮動小数点数に変換します。 _Value パラメーターは、変換する浮動小数点数です。 この関数は、文字列として count まで _Value の数値を格納し、null 文字 (「\0」) を付けます。 _Value の桁数が _Countを超えた場合、下位数字は丸められます。 count の数値より少なくがある場合は、文字列をゼロで埋められます。
数値を文字列に保存されます。 小数点の位置と _Value の符号は呼び出しの後に _Dec と _Sign から取得できます。 _Dec パラメーターは文字列の先頭に関して小数点の位置を示す整数値を指します。 0 または負の整数値は整数部の桁目の左側にあることを示します。 _Sign パラメーターは、変換された数値の符号を表す整数を指定します。 整数値が 0 の場合は、正の数です。 そうしないと、番号が負のです。
_CVTBUFSIZE 長さのバッファーは、浮動小数点値で十分です。
_ecvt_s と _fcvt_s の違いは _Count パラメーターの解釈にあります。 _ecvt_s は 出力文字列の桁数として _fcvt_s が小数点以下の桁数として _Count を解釈する場合、_Count を復号化します。
この関数を使用して、C++ では、テンプレートのオーバーロードによって簡素化されます。; オーバーロードでは、バッファー長を自動的に推論できるため、サイズ引数を指定する必要がなくなります。 詳細については、「セキュリティ保護されたテンプレート オーバーロード」を参照してください。
この関数は、1 番目のデバッグ バージョンは 0xFD をバッファーにコピーします。 この動作を無効にするには、_CrtSetDebugFillThreshold を使用します。
必要条件
関数 |
必須ヘッダー |
オプション ヘッダー |
|---|---|---|
_ecvt_s |
<stdlib.h> |
<errno.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// ecvt_s.c
#include <stdio.h>
#include <stdlib.h>
#include <errno.h>
int main( )
{
char * buf = 0;
int decimal;
int sign;
int err;
buf = (char*) malloc(_CVTBUFSIZE);
err = _ecvt_s(buf, _CVTBUFSIZE, 1.2, 5, &decimal, &sign);
if (err != 0)
{
printf("_ecvt_s failed with error code %d\n", err);
exit(1);
}
printf("Converted value: %s\n", buf);
}