ecvt、fcvt、または gcvt サブルーチン

目的

浮動小数点数をストリングに変換します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

#include <stdlib.h>
char *ecvt ( Value,  NumberOfDigits,  DecimalPointer,  Sign;)
double Value;
int  NumberOfDigits, *DecimalPointer, *Sign;
char *fcvt (Value, NumberOfDigits, DecimalPointer, Sign;)
double Value;
int  NumberOfDigits, *DecimalPointer, *Sign; 
char *gcvt (Value, NumberOfDigits,  Buffer;)
double Value;
int NumberOfDigits;
char *Buffer;

説明

EcvtFcvt、および GCVT サブルーチンは、浮動小数点数をストリングに変換します。

Ecvt サブルーチンは、 パラメーターをヌル終了ストリングに変換し、それを指すポインターを戻します。 NumberOfDigitsパラメータは、文字列の桁数を指定する。 下位桁は、現在の丸めモードに従って丸められます。 ecvt サブルーチンは、 DecimalPointer パラメーターが指す整数を、ストリングの先頭を基準とする小数点の位置に設定します。 (負の数は、小数点が文字列で指定された桁より左にあることを意味する) 小数点自体はストリングに含まれません。 また、 Ecvt サブルーチンは、 サイン パラメーターが指す整数を、 パラメーターが負の場合はゼロ以外の値に設定し、それ以外の場合は 0 の値に設定します。

fcvtサブルーチンは、NumberOfDigitsパラメータで指定された桁数のCまたはFORTRAN Fフォーマット出力のために正しい桁が丸められることを除いて、ecvtサブルーチンと同じように動作します。

注:Fフォーマットでは、NumberOfDigitsパラメータは小数点以下の桁数を指定する。 大きな数字は、小数点の前に長い桁の文字列を生成し、小数点の後にNumberOfDigits桁を生成する。 一般に、 GCVT および Ecvt サブルーチンは、大きな数の場合に役立ちます。

GCVT サブルーチンは、 パラメーターをヌル終了ストリングに変換し、それを バッファー パラメーターが指す配列に保管してから、 バッファー パラメーターを戻します。 gcvtサブルーチンは、NumberOfDigitsパラメータの有効数字の文字列を FORTRAN F-format で生成しようとする。 これが不可能な場合は、E フォーマットが使用されます。 GCVT サブルーチンは後続ゼロを抑止します。 ストリングは、必要に応じて、負符号 (-)、小数点、または指数付きで印刷の準備ができています。 基数文字は、現行ロケールによって決定されます ( setlocale サブルーチンを参照)。 setlocale サブルーチンが正常に呼び出されなかった場合は、デフォルト・ロケール POSIXが使用されます。 デフォルト・ロケールは . を指定します。 (ピリオド) を基数文字として使用します。 LC_NUMERIC (L) カテゴリーは、現行ロケール内の基数文字の値を決定します。

EcvtFcvt、および GCVT サブルーチンは、浮動小数点演算のために ANSI/IEEE 標準 754-1985 および 854-1987 で指定されている以下の特殊値を表します。

項目 説明
静止 NaN 静止非数値 (NaNQ) を示します。
シグナリング NaN シグナリング NaNS を示します。
無限大 INF 値を示します。

これらの値のそれぞれに関連付けられた符号は、 サイン パラメーターに保管されます。

注: 値 0 は正または負のいずれかです。 IEEE 浮動小数点では、ゼロにも符号が付き、 サイン パラメーターが適切に設定されます。
注意: 3 つのサブルーチンはすべて、いずれかのサブルーチンが呼び出されるたびに内容が上書きされるメモリーの静的領域にストリングを保管します。

パラメーター

項目 説明
VALUE いくつかの倍精度浮動小数点値を指定します。
NumberOfDigits ストリングの桁数を指定します。
DecimalPointer ストリングの先頭に対する小数点の相対位置を指定します。
署名 戻り値に関連した符号を サイン パラメーターに入れることを指定します。 IEEE 浮動小数点では、0 は符号付きにすることができるため、 サイン パラメーターは符号付き 0 に対して適切に設定されます。
buffer ストリングの文字配列を指定します。