_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」を参照してください。

次の表に示すように、無効なパラメーターがある場合、「パラメーターの検証」で説明されているように、この関数は無効なパラメーター ハンドラーを呼び出します。 実行を続行できる場合、この関数は 、 にEINVAL設定errnoされ、.EINVAL

エラー条件

buffer sizeInBytes value count dec sign 戻り値 buffer の値
NULL any any any any any EINVAL 変更されません。
NULL ではありません (有効なメモリを指します) <=0 any any any any EINVAL 変更されません。
any any any any NULL any EINVAL 変更されません。
any any any any any NULL EINVAL 変更されません。

セキュリティ上の問題

_ecvt_sが有効なメモリNULLを指していない場合、アクセス違反が発生する可能性bufferがあります。

解説

_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