_fcvt

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

浮動小数点数を文字列に変換します。この関数のセキュリティが強化されたバージョンについては、「_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 に設定され、負の場合は 0 以外の数値に設定されます。

_ecvt と _fcvt の違いは、count パラメータの解釈にあります。_ecvt は、count を出力文字列の合計桁数として解釈しますが、_fcvt は、count を小数点以下の桁数として解釈します。

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

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

必要条件

関数	必須ヘッダー
_fcvt	<stdlib.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

// 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