C++ 为错误使用自定义打印/日志功能添加编译器警告

Question

我有以下功能，我希望在使用 printf 时得到警告：

void LoggingManager::log(int32_t logLevel, const char *p_str, ...)
{
    va_list args;
    va_start(args, p_str);
    vsnprintf(s_LogginManagerBuffer, LOGGING_MANAGER_BUFFER_SIZE - 1, p_str, args);
    va_end(args);

    internalLog(s_LogginManagerBuffer);
}

如果我忘记为格式字符串中的一个标记添加参数，我想以某种方式发出警告。还有太多（或错误的论点）的警告也会很棒。 由于忘记了日志记录函数中的参数，我最近遇到了一些崩溃。

如果无法做到这一点，我该如何重写我的函数，以获得警告但功能相同？

Answer 1

如果您使用 gcc/g++/clang，您可以使用 this page 中指定的 format 属性：

格式（原型、字符串索引、首先检查）

format 属性指定函数采用 printf、scanf、strftime 或 strfmon 样式参数，这些参数应根据格式字符串进行类型检查。例如声明：

extern int my_printf (void *my_object, const char *my_format, ...) __attribute__ ((format (printf, 2, 3)));

使编译器检查对 my_printf 的调用中的参数与 printf 样式格式字符串参数 my_format 的一致性。

__attribute__ 在函数原型之前还是之后都没有关系。

所以在你的情况下，你可以这样做：

class LoggingManager {
    ...
public:
    void log(int32_t logLevel, const char *p_str, ...) __attribute__((format (printf, 3, 4)));
    ...
};

请注意，由于这是一个成员函数，因此您需要考虑传递的隐式 this 参数。所以格式字符串实际上是第三个参数而不是第二个。 （format (printf, 3, 4) 而不是format (printf, 2, 3)）

看到它工作here。

Answer 2

如果您使用的是 Visual Studio，则可以使用 SAL annotation _Printf_format_string_ 宏：

#include <sal.h>

void log
(
    int32_t                                    log_level
,   _In_z_ _Printf_format_string_ const char * psz_format
,   ...
);

为了使代码可移植，您可能需要在必要时定义格式属性宏和 SAL 宏替换：

#if defined(__GNUC__)
#define ATTRIBUTE_PRINTF(format_index, vargs_index) __attribute__((__format__ (__printf__, format_index, vargs_index)))
#else
#define ATTRIBUTE_PRINTF(format_index, vargs_index)
#endif

#if defined(_MSC_VER)
#include <sal.h>
#else
#define _In_z_
#define _Printf_format_string_
#endif

void log
(
    int32_t                                    log_level
,   _In_z_ _Printf_format_string_ const char * psz_format
,   ...
) ATTRIBUTE_PRINTF(2, 3);