WideFmtStr - C++ Builder

2022-06-08 本文已影响0人玄坴

C++ Builder 参考手册 ➙ System::Sysutils ➙ WideFmtStr

格式化数据到 WideString 类型的字符串

头文件：#include <System.SysUtils.hpp>
命名空间：System::Sysutils
函数原型：

void __fastcall WideFmtStr(
    System::WideString &Result,
    const System::WideString Format,
    const System::TVarRec *Args,
    const int Args_High);

void __fastcall WideFmtStr(
    System::WideString &Result,
    const System::WideString Format,
    const System::TVarRec *Args,
    const int Args_High,
    const TFormatSettings &AFormatSettings);

参数：

Result：用于返回生成的字符串；
Format：输出数据的格式；
Args：要输出的数据数组；
Args_High：数据的个数减1；
AFormatSettings：地区格式；

返回值：

按照 Format 参数的格式输出参数 Args 数据到字符串，通过参数 Result 返回生成的字符串；
这个函数的参数及生成的字符串规则和 Format 函数相同；
Args, Args_High 可以使用 ARRAYOFCONST 宏，请参考本文后面的例子；
Format、FmtStr 和 WideFmtStr 的区别：
• Format 通过函数返回值返回结果，其他两个函数通过参数 Result 返回输出结果；
• Format 有模板版本可以简化使用，这三个函数都可以通过 ARRAYOFCONST 宏简化使用；
• WideFmtStr 返回值和参数是 WideString 类型的，其他两个函数是 UnicodeString 类型的；
没有 AFormatSettings 参数的函数不是线程安全的，因为使用了全局变量作为地区格式；带有 AFormatSettings 参数的函数是线程安全的。

例子：

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    int i = 123;
    double x = 4.5678;
    WideString s;
    WideFmtStr(s, L"i=%d, x=%.3f", ARRAYOFCONST((i, x)));
    Memo1->Lines->Add(s); // i=123, x=4.568

    TFormatSettings fr = TFormatSettings::Create(L"fr_FR"); // 使用法国格式
    WideFmtStr(s, L"i=%d, x=%.3f", ARRAYOFCONST((i, x)), fr);
    Memo1->Lines->Add(s); // i=123, x=4.568
}

运行结果：可以看到第二行输出使用法国格式，小数点变成了逗号。

运行结果

WideFmtStr - C++ Builder

猜你喜欢

热点阅读