_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 を参照してください。
無効なパラメーターの場合は次の表に示すようにこの関数は パラメーターの検証 に説明されているように無効なパラメーター ハンドラーを呼び出します。実行の継続が許可された場合関数のセット errno は EINVAL を返しEINVALこの。
エラー条件
buffer |
sizeInBytes |
value |
count |
12 年 7 月 |
sign |
戻り値 |
buffer の値 |
|---|---|---|---|---|---|---|---|
NULL |
任意 |
任意 |
任意 |
任意 |
任意 |
EINVAL |
変更されない。 |
NULL 以外 (有効なメモリを指し示している) |
<=0 |
任意 |
任意 |
任意 |
任意 |
EINVAL |
変更されない。 |
任意 |
任意 |
任意 |
任意 |
NULL |
任意 |
EINVAL |
変更されない。 |
任意 |
任意 |
任意 |
任意 |
任意 |
NULL |
EINVAL |
変更されない。 |
セキュリティの問題
_fcvt_s は buffer が有効なメモリを指すしNULL であるかアクセス違反が発生する場合があります。
解説
_fcvt_s の関数は null で終わる文字列に浮動小数点数に変換します。value のパラメーターは変換する浮動小数点数です。_fcvt_s は文字列として value の数字を保存しnull 文字 (「 \ 0 ") を追加します。count のパラメーターは小数点の後に格納される桁数を指定します。これには count の場所に丸められます。精度の count の数値よりも少ない場合文字列はゼロで埋められます。
数値を文字列に格納されます。value の小数点値と符号の位置は呼び出しの後で dec と sign から取得できます。整数値への dec のパラメーターの point; この整数値は文字列の先頭に対して小数点の場所を指定します。ゼロまたは負の整数値は整数部の桁目の左側にあることを示します。value の符号を表す整数へのパラメーターの sign のポインター。整数は 0 に value が負の場合 value が正の場合ゼロ以外の数字セットに設定されます。
バッファーの長さ _CVTBUFSIZE は浮動小数点値に対して十分です。
_ecvt_s_fcvt_s との違いは count のパラメーターの解釈にあります。_ecvt_s は出力文字列の値の合計数として count を解釈し後で _fcvt_s は小数部の桁数としての ount を解釈します。
この関数を使用してC++ ではテンプレートのオーバーロードによって簡略化 ; オーバーロードではバッファー長を自動的に推論できるためサイズ引数を指定する必要がなくなります。詳細については、「セキュリティ保護されたテンプレート オーバーロード」を参照してください。
この関数のデバッグ バージョンは最初にバッファーを 0xFD で埋めます。この動作を無効にするには、_CrtSetDebugFillThreshold を使用します。
必要条件
Function |
必須ヘッダー |
オプション ヘッダー |
|---|---|---|
_fcvt_s |
<stdlib.h> |
<errno.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
ライブラリ :CRT ライブラリの機能 のすべてのバージョン。
使用例
// 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);
}