Overview | Namespace | Class | Index | Help |
rtl_String * * | pResult, |
sal_Int32 * | pResultCapacity, |
sal_Int32 | nResultOffset, |
double | fValue, |
rtl_math_StringFormat | eFormat, |
sal_Int32 | nDecPlaces, |
sal_Char | cDecSeparator, |
const sal_Int32 * | pGroups, |
sal_Char | cGroupSeparator, |
sal_Bool | bEraseTrailingDecZeros ); |
virtual | abstract | const | volatile | template | static | inline | C-linkage |
NO | NO | NO | NO | NO | NO | NO | YES |
pResult | Returns the resulting byte string. Must itself not be null, and must point to either null or a valid string. |
pResultCapacity | If null, pResult is considered to point to immutable strings, and a new string will be allocated in pResult. If non-null, it points to the current capacity of pResult, which is considered to point to a string buffer (pResult must not itself be null in this case, and must point to a string that has room for the given capacity). The string representation of the given double value is inserted into pResult at position nResultOffset. If pResult's current capacity is too small, a new string buffer will be allocated in pResult as necessary, and pResultCapacity will contain the new capacity on return. |
nResultOffset | If pResult is used as a string buffer (i.e., pResultCapacity is non-null), nResultOffset specifies the insertion offset within the buffer. Ignored otherwise. |
fValue | The value to convert. |
eFormat | The format to use, one of rtl_math_StringFormat. |
nDecPlaces | The number of decimals to be generated. Effectively fValue is rounded at this position, specifying nDecPlaces <= 0 accordingly rounds the value before the decimal point and fills with zeros. If eFormat == rtl_math_StringFormat_Automatic and nDecPlaces == rtl_math_DecimalPlaces_Max, the highest number of significant decimals possible is generated. If eFormat == rtl_math_StringFormat_G, nDecPlaces specifies the number of significant digits instead. If nDecPlaces == rtl_math_DecimalPlaces_DefaultSignificance, the default number (currently 6 as implemented by most libraries) of significant digits is generated. According to the ANSI C90 standard the E style will be used only if the exponent resulting from the conversion is less than -4 or greater than or equal to the precision. However, as opposed to the ANSI standard, trailing zeros are not necessarily removed from the fractional portion of the result unless bEraseTrailingDecZeros == true was specified. |
cDecSeparator | The decimal separator. |
pGroups | Either null (no grouping is used), or a null-terminated list of group lengths. Each group length must be strictly positive. If the number of digits in a conversion exceeds the specified range, the last (highest) group length is repeated as needed. Values are applied from right to left, for a grouping of 1,00,00,000 you'd have to specify pGroups={3,2,0}. |
cGroupSeparator | The group separator. Ignored if pGroups is null. |
bEraseTrailingDecZeros | Trailing zeros in decimal places are erased. |
rtl_uString * * | pResult, |
sal_Int32 * | pResultCapacity, |
sal_Int32 | nResultOffset, |
double | fValue, |
rtl_math_StringFormat | eFormat, |
sal_Int32 | nDecPlaces, |
sal_Unicode | cDecSeparator, |
const sal_Int32 * | pGroups, |
sal_Unicode | cGroupSeparator, |
sal_Bool | bEraseTrailingDecZeros ); |
virtual | abstract | const | volatile | template | static | inline | C-linkage |
NO | NO | NO | NO | NO | NO | NO | YES |
pResult | Returns the resulting Unicode string. Must itself not be null, and must point to either null or a valid string. |
pResultCapacity | If null, pResult is considered to point to immutable strings, and a new string will be allocated in pResult. If non-null, it points to the current capacity of pResult, which is considered to point to a string buffer (pResult must not itself be null in this case, and must point to a string that has room for the given capacity). The string representation of the given double value is inserted into pResult at position nResultOffset. If pResult's current capacity is too small, a new string buffer will be allocated in pResult as necessary, and pResultCapacity will contain the new capacity on return. |
nResultOffset | If pResult is used as a string buffer (i.e., pResultCapacity is non-null), nResultOffset specifies the insertion offset within the buffer. Ignored otherwise. |
fValue | The value to convert. |
eFormat | The format to use, one of rtl_math_StringFormat. |
nDecPlaces | The number of decimals to be generated. Effectively fValue is rounded at this position, specifying nDecPlaces <= 0 accordingly rounds the value before the decimal point and fills with zeros. If eFormat == rtl_math_StringFormat_Automatic and nDecPlaces == rtl_math_DecimalPlaces_Max, the highest number of significant decimals possible is generated. If eFormat == rtl_math_StringFormat_G, nDecPlaces specifies the number of significant digits instead. If nDecPlaces == rtl_math_DecimalPlaces_DefaultSignificance, the default number (currently 6 as implemented by most libraries) of significant digits is generated. According to the ANSI C90 standard the E style will be used only if the exponent resulting from the conversion is less than -4 or greater than or equal to the precision. However, as opposed to the ANSI standard, trailing zeros are not necessarily removed from the fractional portion of the result unless bEraseTrailingDecZeros == true was specified. |
cDecSeparator | The decimal separator. |
pGroups | Either null (no grouping is used), or a null-terminated list of group lengths. Each group length must be strictly positive. If the number of digits in a conversion exceeds the specified range, the last (highest) group length is repeated as needed. Values are applied from right to left, for a grouping of 1,00,00,000 you'd have to specify pGroups={3,2,0}. |
cGroupSeparator | The group separator. Ignored if pGroups is null. |
bEraseTrailingDecZeros | Trailing zeros in decimal places are erased. |
double | fValue, |
int | nExp ); |
virtual | abstract | const | volatile | template | static | inline | C-linkage |
NO | NO | NO | NO | NO | NO | NO | YES |
fValue | The value to be raised. |
nExp | The exponent. |
double | fValue, |
int | nDecPlaces, |
rtl_math_RoundingMode | eMode ); |
virtual | abstract | const | volatile | template | static | inline | C-linkage |
NO | NO | NO | NO | NO | NO | NO | YES |
fValue | Specifies the value to be rounded. |
nDecPlaces | Specifies the decimal place where rounding occurs. Must be in the range -20 to +20, inclusive. Negative if rounding occurs before the decimal point. |
eMode | Specifies the rounding mode. |
const sal_Char * | pBegin, |
const sal_Char * | pEnd, |
sal_Char | cDecSeparator, |
sal_Char | cGroupSeparator, |
rtl_math_ConversionStatus * | pStatus, |
const sal_Char * * | pParsedEnd ); |
virtual | abstract | const | volatile | template | static | inline | C-linkage |
NO | NO | NO | NO | NO | NO | NO | YES |
pBegin | Points to the start of the byte string to convert. Must not be null. |
pEnd | Points one past the end of the byte string to convert. The condition pEnd >= pBegin must hold. |
cDecSeparator | The decimal separator. |
cGroupSeparator | The group (aka thousands) separator. |
pStatus | If non-null, returns the status of the conversion. |
pParsedEnd | If non-null, returns one past the position of the last character parsed away. Thus if [pBegin..pEnd) only contains the numerical string to be parsed, *pParsedEnd == pEnd on return. |
const sal_Unicode * | pBegin, |
const sal_Unicode * | pEnd, |
sal_Unicode | cDecSeparator, |
sal_Unicode | cGroupSeparator, |
rtl_math_ConversionStatus * | pStatus, |
const sal_Unicode * * | pParsedEnd ); |
virtual | abstract | const | volatile | template | static | inline | C-linkage |
NO | NO | NO | NO | NO | NO | NO | YES |
pBegin | Points to the start of the Unicode string to convert. Must not be null. |
pEnd | Points one past the end of the Unicode string to convert. The condition pEnd >= pBegin must hold. |
cDecSeparator | The decimal separator. |
cGroupSeparator | The group (aka thousands) separator. |
pStatus | If non-null, returns the status of the conversion. |
pParsedEnd | If non-null, returns one past the position of the last character parsed away. Thus if [pBegin..pEnd) only contains the numerical string to be parsed, *pParsedEnd == pEnd on return. |
Copyright © 2003 Sun Microsystems, Inc.