#微碼分享#C++變參字串格式化函式format_string

在C和C++中，變參格式化函式雖然非型別安全，但卻十分便利，因為得到廣泛使用。對於常見的size_t型別要用“%zu”，ssize_t用”%zd“，int64_t用“% ”PRId64，uint64_t用“% ”PRIu64，long用"%ld"，long long用"%lld"，示例：
const int64_t datetime = INT64_C(20190124144930);
​printf("datetime: %" PRId64"\n", datetime);
注意在PRId64前保留一個空格，以避免編譯警告

format_string原始碼連結：
https://github.com/eyjian/r3c/blob/master/utils.cpp
​https://github.com/eyjian/libmooon/blob/master/src/utils/string_utils.cpp​​​
​​
format_string原始碼：

// snprintf()第2個引數的大小，要求包含結尾符'\0'
// snprintf()的返回值是期望大小，不包含結尾符'\0'，
// 下面假設snprintf()的第二個引數值為10，則：
// 1) 當str為"abc"時，它的返回值的大小是3，"abc"的字元個數剛好是3；
// 2) 當str為"1234567890"時，它的返回值大小是10，"1234567890"的字元個數剛好是10；
// 3) 當str為"1234567890X"時，它的返回值大小是11，"1234567890X"的字元個數剛好是11。
//
// int asprintf(char **strp, const char *fmt, ...);
std::string format_string(const char* format, ...)
{
    size_t size = 4096;
    std::string buffer(size, '\0');
    char* buffer_p = const_cast<char*>(buffer.data());
    int expected = 0;
    va_list ap;

    while (true)
    {
        va_start(ap, format);
        expected = vsnprintf(buffer_p, size, format, ap);

        va_end(ap);
        if (expected>-1 && expected<=static_cast<int>(size))
        {
            break;
        }
        else
        {
            /* Else try again with more space. */
            if (expected > -1)    /* glibc 2.1 */
                size = static_cast<size_t>(expected + 1); /* precisely what is needed */
            else           /* glibc 2.0 */
                size *= 2;  /* twice the old size */

            buffer.resize(size);
            buffer_p = const_cast<char*>(buffer.data());
        }
    }

    // expected不包含字串結尾符號，其值等於：strlen(buffer_p)
    return std::string(buffer_p, expected>0?expected:0);
}