System.UnicodeString.FloatToStrF

• 親: UnicodeString

C++

static UnicodeString FloatToStrF(long double value,
                                            TStringFloatFormat format,
                                            int precision, int digits);

プロパティ

種類	可視性	ソース	ユニット	親
function	public	ustring.h	System	UnicodeString

説明

浮動小数点値の文字列表現を返します。

format パラメータにより、結果の文字列の形式を制御します。precision パラメータにより、与えられた値の精度を指定します。float 型の値の場合は 7 以下、double 型の値の場合は 15 以下、Extended 型の値の場合は 18 以下にします。digits パラメータの意味は、選択した形式によって異なります。

format パラメータで使用可能な値とそれぞれの意味を、次に説明します。

値	意味
sffGeneral	一般的な数値の形式。値は、固定形式または科学的形式を使用して、できるだけ短い 10 進数に変換されます。結果の文字列からは、末尾のゼロは削除され、必要な場合に限り、小数点が表示されます。結果の文字列では、値のなかの小数点より上の桁数が指定された精度以下の場合、また、値が 0.00001 以上の場合、固定小数点形式を使用します。それ以外の場合、結果の文字列は科学的形式を使用し、digits パラメータにより指数内の最小桁数（0 ～ 4）を指定します。
sffExponent	科学的形式（10 のべき乗）。値は、"-d.ddd...E+dddd" の形式の文字列に変換されます。結果の文字列は、その数が負の場合は、マイナス符号で始まり、小数点の前には必ず 1 桁付きます。結果の文字列の合計桁数（小数点の前の 1 桁も含む）は、precision パラメータで指定します。結果の文字列に含まれる指数文字 "E" の後ろには、常に、プラス記号かマイナス記号と、最大 4 桁の数字が続きます。digits パラメータにより、指数内の最小桁数（0 ～ 4）を指定します。
sffFixed	固定小数点形式。値は、"-ddd.ddd..." の形式の文字列に変換されます。結果の文字列は、その数が負の場合は、マイナス符号で始まり、小数点の前には少なくとも 1 桁付きます。小数点以下の桁数は、digits パラメータにより 0 ～ 18 を指定します。小数点より左の桁数が指定した精度より大きい場合は、結果の値は科学的形式を使用します。
sffNumber	数値形式。値は、"-d,ddd,ddd.ddd..." の形式の文字列に変換されます。sffNumber 形式は、結果の文字列に桁区切り文字が含まれることを除いて、sffFixed 形式に対応します。
sffCurrency	通貨形式。値は、通貨金額を表す文字列に変換されます。この変換は、グローバル変数 CurrencyString、CurrencyFormat、NegCurrFormat、ThousandSeparator、および DecimalSeparator によって制御され、そのどれもみな、Windows の [コントロール パネル｜地域と言語のオプション] の、[地域オプション] タブの [標準と形式] セクションの指定に従って初期化されます。小数点以下の桁数は、Digits パラメータにより 0 ～ 18 を指定します。

すべての形式について、小数点文字や桁区切り文字として使用される実際の文字は、グローバル変数の DecimalSeparator と ThousandSeparator から取得します。

与えられた値が NAN （非数値）ならば、結果の文字列は 'NAN' です。与えられた値が正の無限大ならば、結果の文字列は 'INF' です。与えられた値が負の無限大ならば、結果の文字列は '-INF' です。