ecvt、fcvt、または gcvt サブルーチン
目的
浮動小数点数をストリングに変換します。
ライブラリー
標準 C ライブラリー (libc.a)
構文
#include <stdlib.h> double Value;
int NumberOfDigits, *DecimalPointer, *Sign;
char *fcvt (Value, NumberOfDigits, DecimalPointer, Sign;)
double Value;
int NumberOfDigits, *DecimalPointer, *Sign;
説明
Ecvt、 Fcvt、および GCVT サブルーチンは、浮動小数点数をストリングに変換します。
Ecvt サブルーチンは、 値 パラメーターをヌル終了ストリングに変換し、それを指すポインターを戻します。 NumberOfDigitsパラメータは、文字列の桁数を指定する。 下位桁は、現在の丸めモードに従って丸められます。 ecvt サブルーチンは、 DecimalPointer パラメーターが指す整数を、ストリングの先頭を基準とする小数点の位置に設定します。 (負の数は、小数点が文字列で指定された桁より左にあることを意味する) 小数点自体はストリングに含まれません。 また、 Ecvt サブルーチンは、 サイン パラメーターが指す整数を、 値 パラメーターが負の場合はゼロ以外の値に設定し、それ以外の場合は 0 の値に設定します。
fcvtサブルーチンは、NumberOfDigitsパラメータで指定された桁数のCまたはFORTRAN Fフォーマット出力のために正しい桁が丸められることを除いて、ecvtサブルーチンと同じように動作します。
GCVT サブルーチンは、 値 パラメーターをヌル終了ストリングに変換し、それを バッファー パラメーターが指す配列に保管してから、 バッファー パラメーターを戻します。 gcvtサブルーチンは、NumberOfDigitsパラメータの有効数字の文字列を FORTRAN F-format で生成しようとする。 これが不可能な場合は、E フォーマットが使用されます。 GCVT サブルーチンは後続ゼロを抑止します。 ストリングは、必要に応じて、負符号 (-)、小数点、または指数付きで印刷の準備ができています。 基数文字は、現行ロケールによって決定されます ( setlocale サブルーチンを参照)。 setlocale サブルーチンが正常に呼び出されなかった場合は、デフォルト・ロケール POSIXが使用されます。 デフォルト・ロケールは . を指定します。 (ピリオド) を基数文字として使用します。 LC_NUMERIC (L) カテゴリーは、現行ロケール内の基数文字の値を決定します。
Ecvt、 Fcvt、および GCVT サブルーチンは、浮動小数点演算のために ANSI/IEEE 標準 754-1985 および 854-1987 で指定されている以下の特殊値を表します。
| 項目 | 説明 |
|---|---|
| 静止 NaN | 静止非数値 (NaNQ) を示します。 |
| シグナリング NaN | シグナリング NaNS を示します。 |
| 無限大 | INF 値を示します。 |
これらの値のそれぞれに関連付けられた符号は、 サイン パラメーターに保管されます。
パラメーター
| 項目 | 説明 |
|---|---|
| VALUE | いくつかの倍精度浮動小数点値を指定します。 |
| NumberOfDigits | ストリングの桁数を指定します。 |
| DecimalPointer | ストリングの先頭に対する小数点の相対位置を指定します。 |
| 署名 | 戻り値に関連した符号を サイン パラメーターに入れることを指定します。 IEEE 浮動小数点では、0 は符号付きにすることができるため、 サイン パラメーターは符号付き 0 に対して適切に設定されます。 |
| buffer | ストリングの文字配列を指定します。 |