- Generated by
1.9.8
|
Original Symbian headers
Selected EUSER, Window Server, networking, graphics and device declarations
|
Defines the character representation of a real number type such as a TReal or a TRealX. More...
#include <e32std.h>
Public Member Functions | |
| IMPORT_C | TRealFormat () |
| Default constructor. | |
| IMPORT_C | TRealFormat (TInt aWidth) |
| Constructs the object taking the width of the character representation. | |
| IMPORT_C | TRealFormat (TInt aWidth, TInt aDecimalPlaces) |
| Constructs the object taking the width of the character representation and a value which is interpreted as the number of digits to follow the decimal point. | |
Public Attributes | |
| TInt | iType |
| Governs the format of the character representation of the real number. | |
| TInt | iWidth |
| Defines the maximum number of characters required to represent the number. | |
| 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. | |
| TChar | iPoint |
| Defines the character to be used to separate the integer portion of a number representation from its decimal portion. | |
| TChar | iTriad |
| Defines the character to be used to delimit groups of three digits in the integer part of the number. | |
| TInt | iTriLen |
| Defines the threshold number of digits above which triad separation is to occur. | |
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.
| IMPORT_C TRealFormat::TRealFormat | ( | ) |
Default constructor.
The public data members of the constructed object are assigned the following values:
TRealFormat::iType - set to KRealFormatGeneral
TRealFormat::iWidth - set to KDefaultRealWidth
TRealFormat::iPlaces - set to 0
TRealFormat::iPoint - set to the decimal separator character defined in a TLocale object and returned by the DecimalSeparator() member function of that class.
TRealFormat::iTriad - set to the character used to delimit groups of three digits in the integer portion of a number; the character is defined in a TLocale object and returned by the ThousandsSeparator() member function of that class.
TRealFormat::iTriLen - set to 1
TLocale::DecimalSeparator TLocale::ThousandsSeparator
(generated from Symbian Developer Library)
| IMPORT_C TRealFormat::TRealFormat | ( | TInt | aWidth | ) |
Constructs the object taking the width of the character representation.
The remaining public data members of the constructed object are assigned the following values:
TRealFormat::iType - set to KRealFormatGeneral
TRealFormat::iWidth - set to the aWidth argument
TRealFormat::iPlaces - set to 0
TRealFormat::iPoint - set to the decimal separator character defined in a TLocale object and returned by the DecimalSeparator() member function of that class.
TRealFormat::iTriad - set to the character used to delimit groups of three digits in the integer portion of a number; the character is defined in a TLocale object and returned by the ThousandsSeparator() member function of that class.
TRealFormat::iTriLen - set to 1
TLocale::DecimalSeparator TLocale::ThousandsSeparator
| aWidth | The width of the character representation of the real number. |
(generated from Symbian Developer Library)
| IMPORT_C TRealFormat::TRealFormat | ( | TInt | aWidth, |
| TInt | aDecimalPlaces | ||
| ) |
Constructs the object taking the width of the character representation and a value which is interpreted as the number of digits to follow the decimal point.
The remaining public data members of the constructed object are assigned the following values:
TRealFormat::iType - set to KRealFormatFixed
TRealFormat::iWidth - set to the aWidth argument
TRealFormat::iPlaces - set to the aDecimals argument
TRealFormat::iPoint - set to the decimal separator character defined in a TLocale object and returned by the DecimalSeparator() member function of that class.
TRealFormat::iTriad - set to the character used to delimit groups of three digits in the integer portion of a number; the character is defined in a TLocale object and returned by the ThousandsSeparator() member function of that class.
TRealFormat::iTriLen - set to 1
Note that if the iType data member is changed after construction, aDecimalPlaces may be interpreted as the number of significant digits. For more information, see KRealFormatFixed and the other format types, and KExtraSpaceForSign and the other format flags.
TLocale::DecimalSeparator() TLocale::ThousandsSeparator() KRealFormatFixed KExtraSpaceForSign
| aWidth | The width of the character representation of the real number. |
| aDecimalPlaces | The number of digits to follow the decimal point. |
(generated from Symbian Developer Library)
| TInt TRealFormat::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.
| TChar TRealFormat::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.
| TChar TRealFormat::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.
| TInt TRealFormat::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.
| TInt TRealFormat::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.
| TInt TRealFormat::iWidth |
1.9.8