_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_sbufferが有効なメモリを指していないため、NULLされていない場合は、アクセス違反が発生する可能性があります。

解説

_ecvt_s 関数は、浮動小数点数の値を文字列に変換します。 value パラメーターは変換する浮動小数点数です。 この関数は、value の最大 count 桁を文字列として格納し、null 文字 ("\0") を追加します。 value の桁数が count を超える場合、下位の桁は丸められます。 count 桁より少ない場合は、文字列が 0 で埋められます。

文字列には数字だけが格納されます。 value の小数点位置と符号は、呼び出しの後で dec と sign から取得できます。 dec パラメーターは、文字列の先頭に対する小数点位置を示す整数値をポイントします。 0 または負の整数値は、最初の桁の左側に小数点があることを示します。 sign パラメーターは、変換後の数値の符号を示す整数をポイントします。 整数値が 0 の場合、数値は正の値です。 それ以外の場合、数値は負の値です。

長さ _CVTBUFSIZE のバッファーは、浮動小数点値には十分です。

_ecvt_s と _fcvt_s の違いは、count パラメーターの解釈にあります。 _ecvt_s が count を出力文字列全体の桁数として解釈するのに対し、_fcvt_s は count を小数点より後の桁数と解釈します。

C++ では、テンプレートのオーバーロードによってこの関数を簡単に使用できます。オーバーロードでは、バッファー長を自動的に推論できるため、サイズ引数を指定する必要がなくなります。 詳細については、「セキュリティ保護されたテンプレート オーバーロード」を参照してください。

この関数のデバッグ バージョンでは、最初にバッファーを 0xFE で埋めます。 この動作を無効にするには、_CrtSetDebugFillThreshold を使用します。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

要件

機能	必須ヘッダー	オプション ヘッダー
_ecvt_s	<stdlib.h>	<errno.h>

互換性の詳細については、「 Compatibility」を参照してください。

例

// 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);
}

Converted value: 12000

関連項目

データ変換
数値演算と浮動小数点のサポート
atof、 _atof_l、 _wtof、 _wtof_l
_ecvt
_fcvt_s
_gcvt_s