次の方法で共有

_gcvt_s

  • [アーティクル]

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

構文

errno_t _gcvt_s(
   char *buffer,
   size_t sizeInBytes,
   double value,
   int digits
);
template <size_t cchStr>
errno_t _gcvt_s(
   char (&buffer)[cchStr],
   double value,
   int digits
); // C++ only

パラメーター

buffer
変換の結果を格納するバッファー。

sizeInBytes
バッファーのサイズ。

value
変換する値。

digits
格納されている有効桁数。

戻り値

正常終了した場合は 0。 無効なパラメーターが原因でエラーが発生した場合 (無効な値については、次の表を参照)、「パラメーターの検証 で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、エラー コードが返されます。 エラー コードは、Errno.h で定義されています。 これらのエラーの一覧については、 errno、 _doserrno、 _sys_errlist、および _sys_nerrに関するページを参照してください。

エラー条件

buffer sizeInBytes value digits Return buffer の値
NULL 任意 任意 任意 EINVAL 変更されません。
NULL ではありません (有効なメモリを指します) ゼロ 任意 任意 EINVAL 変更されません。
NULL ではありません (有効なメモリを指します) 任意 任意 >= sizeInBytes EINVAL 変更されません。

セキュリティの問題

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

解説

_gcvt_s 関数は、(小数点、符号バイトを含む) 浮動小数点 value を文字列に変換し、その文字列を buffer に格納します。 buffer は、変換された値に、自動的に追加される終端の nulll 文字を加えたものを格納するのに十分な大きさである必要があります。 長さ _CVTBUFSIZE のバッファーは、浮動小数点値には十分です。 digits + 1 のバッファー サイズを使用する場合、関数はバッファーの末尾を上書きしないため、この操作に十分なバッファーを指定してください。 _gcvt_s は、10 進数形式で digits 桁を生成しようとします。 できない場合は、指数形式で digits 桁が生成されます。 後続のゼロは、変換時に非表示にできます。

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

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

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

要件

ルーチンによって返される値 必須ヘッダー オプション ヘッダー
_gcvt_s <stdlib.h> <error.h>

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

例

// crt_gcvt_s.c
#include <stdio.h>
#include <stdlib.h>
#include <errno.h>

int main()
{
    char buf[_CVTBUFSIZE];
    int decimal;
    int sign;
    int err;

    err = _gcvt_s(buf, _CVTBUFSIZE, 1.2, 5);

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

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

Converted value: 1.2

関連項目

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