C++核心準則ES.34:不要定義C風格的可變參數函數

ES.34: Don't define a (C-style) variadic function

ES.34:不要定義C風格的可變參數函數

 

Reason（原因）

Not type safe. Requires messy cast-and-macro-laden code to get working right.

這種方式不是類型安全的。需要繁雜的類型轉換和宏裝載代碼來保證正確動作。

 

Example（示例）

#include <cstdarg>

// "severity" followed by a zero-terminated list of char*s; write the C-style strings to cerr
void error(int severity ...)
{
    va_list ap;             // a magic type for holding arguments
    va_start(ap, severity); // arg startup: "severity" is the first argument of error()

    for (;;) {
        // treat the next var as a char*; no checking: a cast in disguise
        char* p = va_arg(ap, char*);
        if (!p) break;
        cerr << p << ' ';
    }

    va_end(ap);             // arg cleanup (don't forget this)

    cerr << '\n';
    if (severity) exit(severity);
}

void use()
{
    error(7, "this", "is", "an", "error", nullptr);
    error(7); // crash
    error(7, "this", "is", "an", "error");  // crash
    const char* is = "is";
    string an = "an";
    error(7, "this", "is", an, "error"); // crash
}

Alternative: Overloading. Templates. Variadic templates.

可選項：重載，模板，可變參數模板。

#include <iostream>

void error(int severity)
{
    std::cerr << '\n';
    std::exit(severity);
}

template <typename T, typename... Ts>
constexpr void error(int severity, T head, Ts... tail)
{
    std::cerr << head;
    error(severity, tail...);
}

void use()
{
    error(7); // No crash!
    error(5, "this", "is", "not", "an", "error"); // No crash!

    std::string an = "an";
    error(7, "this", "is", "not", an, "error"); // No crash!

    error(5, "oh", "no", nullptr); // Compile error! No need for nullptr.
}

Note（注意）

This is basically the way printf is implemented.

這是實現printf的基本方法。

 

Enforcement（實施建議）

• Flag definitions of C-style variadic functions.

• 標記定義了C風格可變參數函數的情況。

• Flag #include <cstdarg> and #include <stdarg.h>

• 標記代碼中包含#include <cstdarg> 和 #include <stdarg.h>的情況。

 

原文鏈接

https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#-es34-dont-define-a-c-style-variadic-function

 

---

 

覺得本文有幫助？歡迎點贊並分享給更多的人。

閱讀更多更新文章，請關注微信公衆號【面向對象思考】