_fcvt

浮動小数点数を文字列に変換します。 この関数のセキュリティが強化されたバージョンについては、「_fcvt_s」を参照してください。

構文

char *_fcvt(
   double value,
   int count,
   int *dec,
   int *sign
);

パラメーター

value
変換される数値。

count
小数点以下の桁数。

dec
格納された小数点位置を指すポインター。

sign
格納された符号インジケーターを指すポインター。

戻り値

_fcvt は、エラー時に数字 NULL の文字列へのポインターを返します。

解説

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

返される _fcvt 桁数の合計は、次の値を超 _CVTBUFSIZEえません。

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

_ecvt と _fcvt の違いは、count パラメーターの解釈にあります。 _ecvt が count を出力文字列全体の桁数として解釈するのに対し、_fcvt は count を小数点より後の桁数と解釈します。

_ecvt と _fcvt は、静的に割り当てられた共通のバッファーを使って変換を行います。 これらのルーチンを呼び出すたびに、前の呼び出しの結果は破棄されます。

この関数は、パラメーターを検証します。 signまたは 0 の場合dec、「countNULLパラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の続行が許可されている場合は 、 errno に EINVAL設定され NULL 、返されます。

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

必要条件

機能	必須ヘッダー
_fcvt	<stdlib.h>

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

例

// crt_fcvt.c
// compile with: /W3
// This program converts the constant
// 3.1415926535 to a string and sets the pointer
// buffer to point to that string.

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
   int  decimal, sign;
   char *buffer;
   double source = 3.1415926535;

   buffer = _fcvt( source, 7, &decimal, &sign ); // C4996
   // Note: _fcvt is deprecated; consider using _fcvt_s instead
   printf( "source: %2.10f   buffer: '%s'   decimal: %d   sign: %d\n",
            source, buffer, decimal, sign );
}

source: 3.1415926535   buffer: '31415927'   decimal: 1   sign: 0

関連項目

データ変換
数学と浮動小数点のサポート
atof, _atof_l, _wtof, _wtof_l
_ecvt
_gcvt