TRealFormat Class Reference

class TRealFormat

Defines the character representation of a real number type such as a TReal or a TRealX.

An object of this type is used by functions that convert real values to character format, for example, the descriptor functions: Num(), AppendNum() and Format().

There are three constructors for constructing a suitable object. The data members of the class, however, are public and can be explicitly set after construction.

Constructor & Destructor Documentation

TRealFormat()

IMPORT_CTRealFormat()

TRealFormat(TInt)

IMPORT_CTRealFormat(TIntaWidth)

Parameters

TInt aWidth

TRealFormat(TInt, TInt)

IMPORT_CTRealFormat(TIntaWidth,
TIntaDecimalPlaces
)

Parameters

TInt aWidth
TInt aDecimalPlaces

Member Data Documentation

TInt iPlaces

TInt iPlaces

Defines either the number of characters to be used to represent the decimal portion of the number, or the maximum number of significant digits in the character representation of the number.

The interpretation depends on the chosen format as defined by iType.

TRealFormat::iType

TChar iPoint

TChar iPoint

Defines the character to be used to separate the integer portion of a number representation from its decimal portion.

In general, the character used for this purpose is a matter of local convention. The TLocale::DecimalSeparator() function can supply the desired character.

TLocale

TInt iTriLen

TInt iTriLen

Defines the threshold number of digits above which triad separation is to occur. A value of zero disables triad separation and no triad separation character (i.e. the character held in iTriad) is inserted into the resulting character representation regardless of the number of characters.

For example, a value of 1 causes the number 1000 to be represented by the characters "1,000" whereas a value of 4 causes the same number to be represented by the characters "1000" (This assumes the , triad separation character).

Note that no triad separation occurs if the flag KDoNotUseTriads is set in the iType data member.

TRealFormat::iTriad

KDoNotUseTriads

TChar iTriad

TChar iTriad

Defines the character to be used to delimit groups of three digits in the integer part of the number.

In general, the character used for this purpose is a matter of local convention. The TLocale::ThousandsSeparator() function can supply the desired character.

TLocale

TInt iType

TInt iType

Governs the format of the character representation of the real number.

This is set to one of the defined format types.

One or more of the defined format flags can subsequently be ORed into this member.

KRealFormatFixed

KRealFormatExponent

KRealFormatGeneral

KRealFormatNoExponent

KRealFormatCalculator

KExtraSpaceForSign

KAllowThreeDigitExp

KDoNotUseTriads

KGeneralLimit

KUseSigFigs

TInt iWidth

TInt iWidth

Defines the maximum number of characters required to represent the number.