WideFormatBuf - C++ Builder

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

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

格式化数据到字符串

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

unsigned __fastcall WideFormatBuf(
    void *Buffer,
    unsigned BufLen,
    const void *Format,
    unsigned FmtLen,
    const System::TVarRec *Args,
    const int Args_High);

unsigned __fastcall WideFormatBuf(
    void *Buffer, unsigned BufLen,
    const void *Format,
    unsigned FmtLen,
    const System::TVarRec *Args,
    const int Args_High,
    const TFormatSettings &AFormatSettings);

参数：

Buffer：用于返回生成的字符串，指向 System::WideChar * 类型的缓存；
BufLen：参数 Buffer 的长度 (可以容纳的字符个数)；
Format：输出数据的格式，指向 System::WideChar * 类型的缓存；
FmtLen：参数 Format 的长度 (包含字符的个数)；
Args：要输出的数据数组；
Args_High：数据的个数减1；
AFormatSettings：地区格式；

返回值：

按照 Format 参数的格式输出参数 Args 数据到字符串，通过参数 Buffer 返回生成的字符串；
这个函数的参数及生成的字符串规则和 Format 函数相同。
参数 Args, Args_High 可以使用 ARRAYOFCONST 宏；
参数 Buffer 和 Format 指向 System::WideChar * 类型的缓存，即 UTF-16 编码的字符缓存，Windows 里面相当于 wchar_t *，其他系统对应的是 char16_t * 类型，缓存长度是 char16_t 的个数，而不是字节数；
没有 AFormatSettings 参数的函数不是线程安全的，因为使用了全局变量作为地区格式；带有 AFormatSettings 参数的函数是线程安全的。

WideFormatBuf - C++ Builder

猜你喜欢

热点阅读