如何为几行代码禁用 GCC 警告

显示为 can be done。我无法确定它添加的 GCC 版本，但它是在 2010 年 6 月之前的某个时间。

这是一个例子：

#pragma GCC diagnostic error "-Wuninitialized"
    foo(a);         /* error is given for this one */
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wuninitialized"
    foo(b);         /* no diagnostic for this one */
#pragma GCC diagnostic pop
    foo(c);         /* error is given for this one */
#pragma GCC diagnostic pop
    foo(d);         /* depends on command line options */

---

为了解决所有问题，这是一个暂时禁用警告的示例：

#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wunused-result"
    write(foo, bar, baz);
#pragma GCC diagnostic pop

您可以查看 GCC documentation on diagnostic pragmas 了解更多详情。

---

TL;DR：如果有效，请避免使用或使用 __attribute__ 等说明符，否则为 _Pragma。

这是我的博客文章的简短版本Suppressing Warnings in GCC and Clang。

考虑以下 Makefile，

CPPFLAGS:=-std=c11 -W -Wall -pedantic -Werror

.PHONY: all
all: puts

用于构建以下 puts.c 源代码：

#include <stdio.h>

int main(int argc, const char *argv[])
{
    while (*++argv)
        puts(*argv);
    return 0;
}

它不会编译，因为 argc 未使用，并且设置是硬核 (-W -Wall -pedantic -Werror)。

你可以做五件事：

如果可能，改进源代码

使用声明说明符，例如 __attribute__

使用 _Pragma

使用#pragma

使用命令行选项。

改进源

第一次尝试应该是检查是否可以改进源代码以消除警告。在这种情况下，我们不想仅仅因为这个而改变算法，因为 argc 与 !*argv 是多余的（最后一个元素之后的 NULL）。

使用声明说明符，例如 __attribute__

#include <stdio.h>

int main(__attribute__((unused)) int argc, const char *argv[])
{
    while (*++argv) puts(*argv);
    return 0;
}

如果幸运的话，该标准会为您的情况提供一个说明符，例如 _Noreturn。

__attribute__ 是专有的 GCC 扩展（由 Clang 和一些其他编译器（如 armcc）支持）并且不会被许多其他编译器理解。如果您想要可移植代码，请将 __attribute__((unused)) 放入宏中。

_Pragma 运算符

_Pragma 可用作 #pragma 的替代品。

#include <stdio.h>

_Pragma("GCC diagnostic push")
_Pragma("GCC diagnostic ignored \"-Wunused-parameter\"")

int main(int argc, const char *argv[])
{
    while (*++argv)
        puts(*argv);
    return 0;
}
_Pragma("GCC diagnostic pop")

_Pragma 运算符的主要优点是您可以将它放在宏中，而 #pragma 指令无法做到这一点。

缺点：它几乎是一个战术核武器，因为它是基于行而不是基于声明的。

_Pragma 运算符是在 C99 中引入的。

#pragma 指令。

我们可以更改源代码以抑制代码区域的警告，通常是整个函数：

#include <stdio.h>

#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wunused-parameter"
int main(int argc, const char *argv[])
{
    while (*++argc) puts(*argv);
    return 0;
}
#pragma GCC diagnostic pop

缺点：它几乎是一个战术核武器，因为它是基于行而不是基于声明的。

请注意，Clang 中存在类似的语法。

抑制单个文件的命令行上的警告

我们可以将以下行添加到 Makefile 以抑制专门针对 puts 的警告：

CPPFLAGS:=-std=c11 -W -Wall -pedantic -Werror

.PHONY: all
all: puts

puts.o: CPPFLAGS+=-Wno-unused-parameter

在您的特定情况下，这可能不是您想要的，但它可能会帮助处于类似情况的其他读者。

---

我知道这个问题是关于 GCC 的，但是对于寻找如何在其他和/或多个编译器中执行此操作的人来说……

TL;博士

您可能想看看 Hedley，它是我编写的一个公共域单个 C/C++ 标头，它为您做了 lot 的这些内容。在这篇文章的最后，我将简要介绍如何使用 Hedley 来完成所有这些工作。

禁用警告

#pragma warning (disable: …) 在大多数编译器中都有等效项：

MSVC：#pragma 警告（禁用：4996）

GCC：#pragma GCC 诊断忽略“-W...”，其中省略号是警告的名称；例如，#pragma GCC 诊断忽略“-Wdeprecated-declarations.

Clang：#pragma clang 诊断忽略了“-W…”。语法与 GCC 基本相同，并且许多警告名称是相同的（尽管很多不是）。

英特尔 C++ 编译器 (ICC)：使用 MSVC 语法，但请记住警告编号完全不同。示例：#pragma 警告（禁用：1478 1786）。

PGI/Nvidia：有一个 diag_suppress pragma：#pragma diag_suppress 1215,1444。请注意，所有警告数量在 20.7（第一个 Nvidia HPC 版本）中都增加了一个。

TI (CCS)：有一个 diag_suppress pragma，其语法与 PGI 相同（但警告编号不同！）：pragma diag_suppress 1291,1718

Oracle Developer Studio (ODS) (suncc)：有一个 error_messages pragma。令人讨厌的是，C 和 C++ 编译器的警告是不同的。这两个都禁用基本相同的警告： C: #pragma error_messages(off,E_DEPRECATED_ATT,E_DEPRECATED_ATT_MESS) C++: #pragma error_messages(off,symdeprecated,symdeprecated2)

C：#pragma error_messages（关闭，E_DEPRECATED_ATT，E_DEPRECATED_ATT_MESS）

C++: #pragma error_messages(off,symdeprecated,symdeprecated2)

IAR：也像 PGI 和 TI 一样使用 diag_suppress，但语法不同。一些警告数字是相同的，但我其他人有分歧：#pragma diag_suppress=Pe1444,Pe1215

Pelles C：类似于 MSVC，但数字再次不同#pragma warn(disable:2241)

对于大多数编译器来说，在尝试禁用它之前检查编译器版本通常是一个好主意，否则你最终会触发另一个警告。例如，GCC 7 添加了对 -Wimplicit-fallthrough 警告的支持，因此如果您在 7 之前关心 GCC，您应该执行类似的操作

#if defined(__GNUC__) && (__GNUC__ >= 7)
#  pragma GCC diagnostic ignored "-Wimplicit-fallthrough"
#endif

对于 Clang 和基于 Clang 的编译器，例如较新版本的 XL C/C++ 和 armclang，您可以使用 __has_warning() 宏检查编译器是否知道特定警告。

#if __has_warning("-Wimplicit-fallthrough")
#  pragma clang diagnostic ignored "-Wimplicit-fallthrough"
#endif

当然，您还必须检查 __has_warning() 宏是否存在：

#if defined(__has_warning)
#  if __has_warning("-Wimplicit-fallthrough")
#    pragma clang diagnostic ignored "-Wimplicit-fallthrough"
#  endif
#endif

你可能会想做类似的事情

#if !defined(__has_warning)
#  define __has_warning(warning)
#endif

因此，您可以更轻松地使用 __has_warning。 Clang 甚至在他们的手册中为 __has_builtin() 宏提出了类似的建议。 不要这样做。其他代码可能会检查 __has_warning 并在编译器版本不存在时回退到检查，如果您定义 __has_warning，您将破坏他们的代码。正确的方法是在你的命名空间中创建一个宏。例如：

#if defined(__has_warning)
#  define MY_HAS_WARNING(warning) __has_warning(warning)
#else
#  define MY_HAS_WARNING(warning) (0)
#endif

然后你可以做类似的事情

#if MY_HAS_WARNING(warning)
#  pragma clang diagnostic ignored "-Wimplicit-fallthrough"
#elif defined(__GNUC__) && (__GNUC__ >= 7)
#  pragma GCC diagnostic ignored "-Wimplicit-fallthrough"
#endif

推动和弹出

许多编译器还支持将警告推送和弹出堆栈的方法。例如，这将禁用 GCC 上一行代码的警告，然后将其返回到之前的状态：

#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wdeprecated"
call_deprecated_function();
#pragma GCC diagnostic pop

当然，编译器之间在语法上并没有很多一致意见：

GCC 4.6+：#pragma GCC 诊断推送/#pragma GCC 诊断弹出

Clang：#pragma clang diagnostic push / #pragma clang diagnostic pop

Intel 13+（可能更早）：#pragma warning(push) / #pragma warning(pop)

MSVC 15+（Visual Studio 9.0 / 2008）：#pragma 警告（推送）/#pragma 警告（弹出）

ARM 5.6+：#pragma push / #pragma pop

TI 8.1+：#pragma diag_push / #pragma diag_pop

Pelles C 2.90+（可能更早）：#pragma warning(push) / #pragma warning(pop)

如果没记错的话，对于一些非常旧的 GCC 版本（如 3.x、IIRC），push/pop pragma 必须在函数之外。

隐藏血淋淋的细节

对于大多数编译器，可以使用 C99 中引入的 _Pragma 隐藏宏背后的逻辑。即使在非 C99 模式下，大多数编译器也支持 _Pragma;最大的例外是 MSVC，它有自己的 __pragma 关键字，但语法不同。标准的 _Pragma 接受一个字符串，微软的版本没有：

#if defined(_MSC_VER)
#  define PRAGMA_FOO __pragma(foo)
#else
#  define PRAGMA_FOO _Pragma("foo")
#endif
PRAGMA_FOO

大致相当于，一旦预处理，

#pragma foo

这让我们创建宏，这样我们就可以编写如下代码

MY_DIAGNOSTIC_PUSH
MY_DIAGNOSTIC_DISABLE_DEPRECATED
call_deprecated_function();
MY_DIAGNOSTIC_POP

并隐藏宏定义中所有丑陋的版本检查。

最简单的方法：赫德利

既然您了解了如何在保持代码整洁的同时以便携方式执行此类操作的机制，那么您就了解了我的一个项目 Hedley 的作用。无需深入研究大量文档和/或安装尽可能多的编译器版本来进行测试，您只需包含 Hedley（它是一个公共域 C/C++ 头文件）并完成它。例如：

#include "hedley.h"

HEDLEY_DIAGNOSTIC_PUSH
HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED
call_deprecated();
HEDLEY_DIAGNOSTIC_POP

将禁用有关在 GCC、Clang、ICC、PGI、MSVC、TI、IAR、ODS、Pelles C 以及可能的其他设备上调用已弃用函数的警告（我可能不会在更新 Hedley 时更新此答案）。而且，在未知的编译器上，宏将被预处理为空，因此您的代码将继续与任何编译器一起使用。当然，HEDLEY_DIAGNOSTIC_DISABLE_DEPRECATED 不是 Hedley 知道的唯一警告，也不是 Hedley 所能做的所有禁用警告，但希望您明白这一点。

---

#pragma GCC diagnostic ignored "-Wformat"

将“-Wformat”替换为警告标志的名称。

AFAIK 无法为此选项使用推送/弹出语义。

---

利用：

#define DIAG_STR(s) #s
#define DIAG_JOINSTR(x,y) DIAG_STR(x ## y)
#ifdef _MSC_VER
#define DIAG_DO_PRAGMA(x) __pragma (#x)
#define DIAG_PRAGMA(compiler,x) DIAG_DO_PRAGMA(warning(x))
#else
#define DIAG_DO_PRAGMA(x) _Pragma (#x)
#define DIAG_PRAGMA(compiler,x) DIAG_DO_PRAGMA(compiler diagnostic x)
#endif
#if defined(__clang__)
# define DISABLE_WARNING(gcc_unused,clang_option,msvc_unused) DIAG_PRAGMA(clang,push) DIAG_PRAGMA(clang,ignored DIAG_JOINSTR(-W,clang_option))
# define ENABLE_WARNING(gcc_unused,clang_option,msvc_unused) DIAG_PRAGMA(clang,pop)
#elif defined(_MSC_VER)
# define DISABLE_WARNING(gcc_unused,clang_unused,msvc_errorcode) DIAG_PRAGMA(msvc,push) DIAG_DO_PRAGMA(warning(disable:##msvc_errorcode))
# define ENABLE_WARNING(gcc_unused,clang_unused,msvc_errorcode) DIAG_PRAGMA(msvc,pop)
#elif defined(__GNUC__)
#if ((__GNUC__ * 100) + __GNUC_MINOR__) >= 406
# define DISABLE_WARNING(gcc_option,clang_unused,msvc_unused) DIAG_PRAGMA(GCC,push) DIAG_PRAGMA(GCC,ignored DIAG_JOINSTR(-W,gcc_option))
# define ENABLE_WARNING(gcc_option,clang_unused,msvc_unused) DIAG_PRAGMA(GCC,pop)
#else
# define DISABLE_WARNING(gcc_option,clang_unused,msvc_unused) DIAG_PRAGMA(GCC,ignored DIAG_JOINSTR(-W,gcc_option))
# define ENABLE_WARNING(gcc_option,clang_option,msvc_unused) DIAG_PRAGMA(GCC,warning DIAG_JOINSTR(-W,gcc_option))
#endif
#endif

这应该对 GCC、Clang 和 MSVC 有用。

它可以被调用，例如：

DISABLE_WARNING(unused-variable,unused-variable,42)
[.... some code with warnings in here ....]
ENABLE_WARNING(unused-variable,unused-variable,42)

有关详细信息，请参阅 7 Pragmas、Controlling Diagnostics via Pragmas 和 Pragma directives and the __pragma and _Pragma keywords。

您至少需要 4.02 版才能为 GCC 使用这些编译指示，而且我不确定 MSVC 和 Clang 的版本。

看起来 GCC 的 push pop pragma 处理有点坏了。如果您再次启用警告，您仍然会收到 DISABLE_WARNING/ENABLE_WARNING 块内的块的警告。对于某些版本的 GCC，它可以工作，而对于某些版本则不能。

---

我对 ROS 标头等外部库有同样的问题。我喜欢在 CMakeLists.txt 中使用以下选项来进行更严格的编译：

set(CMAKE_CXX_FLAGS "-std=c++0x -Wall -Wextra -Wstrict-aliasing -pedantic -Werror -Wunreachable-code ${CMAKE_CXX_FLAGS}")

但是，这样做也会导致外部包含的库中出现各种迂腐错误。解决方案是在包含外部库之前禁用所有迂腐警告，然后像这样重新启用它们：

// Save compiler switches
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wpedantic"

// Bad headers with a problem goes here
#include <ros/ros.h>
#include <sensor_msgs/LaserScan.h>

// Restore compiler switches
#pragma GCC diagnostic pop

---

GCC 样式通常不是消除警告，而是使用标准 C 构造或 __attribute__ 扩展来告诉编译器更多关于您的意图。

例如，通过将赋值放在括号中（即 if ((p=malloc(cnt))) 而不是 if (p=malloc(cnt))）来抑制有关用作条件的赋值的警告。

关于未使用的函数参数的警告可以通过一些我永远记不住的奇怪 __attribute__ 或通过自赋值等来抑制。

但通常我更喜欢全局禁用任何会为正确代码中发生的事情生成警告的警告选项。

---

这是在 IAR 中执行此操作的一种方法。尝试这个：

#pragma diag_suppress=Pe177
void foo1(void)
{
   /* The following line of code would normally provoke diagnostic 
      message #177-D: variable "x" was declared but never referenced.
      Instead, we have suppressed this warning throughout the entire 
      scope of foo1(). 
   */
   int x;
}
#pragma diag_default=Pe177

请参阅 official documentation 以供参考。

---