_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 |
戻り値 |
buffer の値 |
|---|---|---|---|---|---|
NULL |
任意 |
任意 |
任意 |
EINVAL |
変更されない。 |
NULL 以外 (有効なメモリを指し示している) |
0 |
任意 |
任意 |
EINVAL |
変更されない。 |
NULL 以外 (有効なメモリを指し示している) |
任意 |
任意 |
>= sizeInBytes |
EINVAL |
変更されない。 |
セキュリティの問題
_gcvt_s は buffer が有効なメモリを指さないし、NULLであるアクセス違反が発生します。
解説
_gcvt_s 関数 (小数点記号と可能なバイトを含む) に浮動小数点 value を文字列に変換し、bufferで文字列を格納します。 buffer は 自動的に付けられた終端の null 文字に変換後の値を格納するのに十分な大きさが必要です。 _CVTBUFSIZE 長さのバッファーは、浮動小数点値で十分です。 digits のバッファー サイズが + 1 を使用すると、関数では、バッファーの末尾を上書きしていないため、この操作のための十分なバッファーを指定してください。 _gcvt_s は 10 進形式で digits の数字を生成しようとします。 できない場合、指数形式の digits の数字を生成します。 後続のゼロは変換で制約できます。
この関数を使用して、C++ では、テンプレートのオーバーロードによって簡素化されます。; オーバーロードでは、バッファー長を自動的に推論できるため、サイズ引数を指定する必要がなくなります。 詳細については、「セキュリティ保護されたテンプレート オーバーロード」を参照してください。
この関数は、1 番目のデバッグ バージョンは 0xFD をバッファーにコピーします。 この動作を無効にするには、_CrtSetDebugFillThreshold を使用します。
必要条件
ルーチン |
必須ヘッダー |
オプション ヘッダー |
|---|---|---|
_gcvt_s |
<stdlib.h> |
<error.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// 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);
}