_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 で定義されています。 これらのエラーの一覧については、 errno_doserrno_sys_errlist、および _sys_nerrに関するページを参照してください。

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

エラー条件

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

セキュリティの問題

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

解説

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

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

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

_ecvt_s_fcvt_s の違いは、count パラメーターの解釈にあります。 _ecvt_scount を出力文字列の合計桁数として解釈し、 _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