_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 で定義されています。 これらのエラーの一覧については、「、、_doserrno
、_sys_errlist
、、」_sys_nerr
を参照してくださいerrno
。
エラー条件
buffer |
sizeInBytes |
value |
digits |
Return | buffer の値 |
---|---|---|---|---|---|
NULL |
any | any | any | EINVAL |
変更されません。 |
NULL ではありません (有効なメモリを指します) |
ゼロ | any | any | EINVAL |
変更されません。 |
NULL ではありません (有効なメモリを指します) |
any | any | >= sizeInBytes |
EINVAL |
変更されません。 |
セキュリティの問題
_gcvt_s
は、有効なメモリを指していない場合、NULL
アクセス違反を生成する可能性buffer
があります。
解説
_gcvt_s
関数は、(小数点、符号バイトを含む) 浮動小数点 value
を文字列に変換し、その文字列を buffer
に格納します。 buffer
は、変換された値に、自動的に追加される終端の nulll 文字を加えたものを格納するのに十分な大きさである必要があります。 長さ _CVTBUFSIZE
のバッファーは、浮動小数点値には十分です。 バッファー サイズが + 1 の digits
場合、関数はバッファーの末尾を上書きしないため、この操作に十分なバッファーを指定してください。 _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
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示