C++ Builder格式化字符串
来源:互联网 发布:软件项目管理阶段 编辑:程序博客网 时间:2024/05/21 09:18
Category
string formatting routines
extern PACKAGE AnsiString __fastcall Format(const AnsiString Format, const System::TVarRec* Args, const int Args_Size);
Format strings specify required formats to general-purpose formatting routines.
Returns a formatted string assembled from a format string and an array of arguments.
Description
Format strings passed to the string formatting routines contain two types of objects -- literal characters and format specifiers. Literal characters are copied verbatim to the resulting string. Format specifiers fetch arguments from the argument list and apply formatting to them.
Format specifiers have the following form:
"%" [index ":"] ["-"] [width] ["." prec] type
A format specifier begins with a % character. After the % come the following, in this order:
An optional argument zero-offset index specifier (that is, the first item has index 0), [index ":"]
An optional left justification indicator, ["-"]
An optional width specifier, [width]
An optional precision specifier, ["." prec]
The conversion type character, type
The following table summarizes the possible values for type:
d Decimal. The argument must be an integer value. The value is converted to a string of decimal digits. If the format string contains a precision specifier, it indicates that the resulting string must contain at least the specified number of digits; if the value has less digits, the resulting string is left-padded with zeros.
u Unsigned decimal. Similar to 'd' but no sign is output.
e Scientific. The argument must be a floating-point value. The value is converted to a string of the form "-d.ddd...E+ddd". The resulting string starts with a minus sign if the number is negative. One digit always precedes the decimal point.The total number of digits in the resulting string (including the one before the decimal point) is given by the precision specifier in the format string梐 default precision of 15 is assumed if no precision specifier is present. The "E" exponent character in the resulting string is always followed by a plus or minus sign and at least three digits.
f Fixed. The argument must be a floating-point value. The value is converted to a string of the form "-ddd.ddd...". The resulting string starts with a minus sign if the number is negative.The number of digits after the decimal point is given by the precision specifier in the format string梐 default of 2 decimal digits is assumed if no precision specifier is present.
g General. The argument must be a floating-point value. The value is converted to the shortest possible decimal string using fixed or scientific format. The number of significant digits in the resulting string is given by the precision specifier in the format string梐 default precision of 15 is assumed if no precision specifier is present.Trailing zeros are removed from the resulting string, and a decimal point appears only if necessary. The resulting string uses fixed point format if the number of digits to the left of the decimal point in the value is less than or equal to the specified precision, and if the value is greater than or equal to 0.00001. Otherwise the resulting string uses scientific format.
n Number. The argument must be a floating-point value. The value is converted to a string of the form "-d,ddd,ddd.ddd...". The "n" format corresponds to the "f" format, except that the resulting string contains thousand separators.
m Money. The argument must be a floating-point value. The value is converted to a string that represents a currency amount. The conversion is controlled by the CurrencyString, CurrencyFormat, NegCurrFormat, ThousandSeparator, DecimalSeparator, and CurrencyDecimals global variables. If the format string contains a precision specifier, it overrides the value given by the CurrencyDecimals global variable.
p Pointer. The argument must be a pointer value. The value is converted to an 8 character string that represents the pointers value in hexadecimal.
s String. The argument must be a character, a string, or a PChar value. The string or character is inserted in place of the format specifier. The precision specifier, if present in the format string, specifies the maximum length of the resulting string. If the argument is a string that is longer than this maximum, the string is truncated.
x Hexadecimal. The argument must be an integer value. The value is converted to a string of hexadecimal digits. If the format string contains a precision specifier, it indicates that the resulting string must contain at least the specified number of digits; if the value has fewer digits, the resulting string is left-padded with zeros.
Conversion characters may be specified in uppercase as well as in lowercase梑oth produce the same results.
For all floating-point formats, the actual characters used as decimal and thousand separators are obtained from the DecimalSeparator and ThousandSeparator global variables.
Index, width, and precision specifiers can be specified directly using decimal digit string (for example "%10d"), or indirectly using an asterisk character (for example "%*.*f"). When using an asterisk, the next argument in the argument list (which must be an integer value) becomes the value that is actually used. For example,
TVarRec args[3] = {8,2,123.456};
Format("%*.*f", args, 2);
is the same as
Format("%8.2f", 123.456, 0);
A width specifier sets the minimum field width for a conversion. If the resulting string is shorter than the minimum field width, it is padded with blanks to increase the field width. The default is to right-justify the result by adding blanks in front of the value, but if the format specifier contains a left-justification indicator (a "-" character preceding the width specifier), the result is left-justified by adding blanks after the value.
An index specifier sets the current argument list index to the specified value. The index of the first argument in the argument list is 0. Using index specifiers, it is possible to format the same argument multiple times. For example "Format('%d %d %0:d %1:d', [10, 20])" produces the string '10 20 10 20'.
Note: Setting the index specifier affects all subsequent formatting. That is, Format('%d %d %d %0:d %d', [1, 2, 3, 4]) returns '1 2 3 1 2', not '1 2 3 1 4'. To get the latter result, you have must use Format('%d %d %d %0:d %3:d', [1, 2, 3, 4])
example 1
This example displays a message on the form抯 status bar indicating the table抯 record count after a record is deleted.
Note that the ARRAYOFCONST macro requires an additional pair of parentheses even though there is only one argument.
void __fastcall TForm1::Table1AfterDelete(TDataSet *DataSet)
{
StatusBar1->SimpleText = Format("There are now %d records in the table", ARRAYOFCONST(((int)DataSet->RecordCount)));
}
example 2
AnsiString Msg = Format("Copy %s to %s", ARRAYOFCONST((Edit1->Text,NewFileName)));
- C++ Builder格式化字符串
- c++builder字符串使用
- c++builder通过指定的分隔符格式化一个日期字符串
- c++builder通过指定的分隔符格式化一个日期字符串
- c++builder通过指定的分隔符格式化一个日期字符串
- C++/C字符串格式化
- C语言格式化字符串
- objective-c 字符串格式化
- C格式化字符串
- C 格式化字符串
- c的格式化字符串
- c格式化字符串
- c的格式化字符串
- C#DateTime字符串格式化
- C++Builder 字符串 AnsiString操作
- ExtractStrings c++builder 字符串分解
- C++builder 中字符串、string
- C语言中格式化字符串
- C#中的多线程编程
- C#的多线程机制
- SQL Server 使用备份还原造成孤立用户的解决(补充)
- C#下用P2P技术实现点对点聊天
- Asp.net(c#)实现多线程断点续传
- C++ Builder格式化字符串
- 03-29/小心QQ信息中的网址传播Trojan-PSW.Win32.Delf.qc/Trojan.PSW.Liumazi.kr(2版)
- 生成静态文件的新闻系统核心代码
- XML中DOM解析问题:Msxml2.DOMDocument.4.0 报错
- 架构师要了解那些??
- 设计模式之C#实现--AbstractFactory
- 考研日志-11
- 设计模式C#描述之——简单工厂模式
- 深入理解abstract class和interface