_fcvt_s

  • [アーティクル]

浮動小数点数を文字列に変換します。 この関数は、「CRT の_fcvtセキュリティ機能」の説明に従って、セキュリティが強化されたバージョンです。

構文

errno_t _fcvt_s(
   char* buffer,
   size_t sizeInBytes,
   double value,
   int count,
   int *dec,
   int *sign
);
template <size_t size>
errno_t _fcvt_s(
   char (&buffer)[size],
   double value,
   int count,
   int *dec,
   int *sign
); // C++ only

パラメーター

buffer
変換の結果を保持する指定されたバッファー。

sizeInBytes
バッファーのサイズ (バイト単位)。

value
変換される数値。

count
小数点以下の桁数。

dec
格納された小数点位置を指すポインター。

sign
格納された符号インジケーターを指すポインター。

戻り値

正常終了した場合は 0。 エラーが発生した場合、戻り値はエラー コードです。 エラー コードは、errno.h で定義されています。 これらのエラーの一覧については、「、、_doserrno、_sys_errlist、、」_sys_nerrを参照してくださいerrno。

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

エラー条件

buffer sizeInBytes value count dec sign Return 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 変更されません。

セキュリティの問題

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

解説

_fcvt_s 関数は、浮動小数点数の値を null で終わる文字列に変換します。 value パラメーターは変換する浮動小数点数です。 _fcvt_s は、value の桁数を文字列として格納し、null 文字 ("\0") を追加します。 count パラメーターは、小数点より後の格納する桁数を指定します。 余分な桁は、count 桁まで丸められます。 この桁数が count の有効桁数より少ない場合は、文字列に 0 が埋め込まれます。

文字列には数字だけが格納されます。 value の小数点位置と符号は、呼び出しの後で dec と sign から取得できます。 dec パラメーターは、整数値を指します。この整数値は、小数点が文字列の先頭から何文字目にあるのかを示します。 0 または負の整数値は、小数点が文字列の先頭より左にあることを示します。 sign パラメーターは、value の符号を示す整数を指します。 value が正の場合、整数は 0 に設定され、value が負の場合は負の値に設定されます。

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

_ecvt_s と _fcvt_s の違いは、count パラメーターの解釈にあります。 _ecvt_s は出力 count 文字列の合計桁数として解釈され _fcvt_s 、小数点の後の桁数として解釈されます count 。

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

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

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

必要条件

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

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

ライブラリ:C ランタイム ライブラリのすべてのバージョン。

例

// fcvt_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 = _fcvt_s(buf, _CVTBUFSIZE, 1.2, 5, &decimal, &sign);

    if (err != 0)
    {
        printf("_fcvt_s failed with error code %d\n", err);
        exit(1);
    }

    printf("Converted value: %s\n", buf);
}

Converted value: 120000

関連項目

データ変換
数学と浮動小数点のサポート
atof, _atof_l, _wtof, _wtof_l
_ecvt_s
_gcvt_s
_fcvt