C ++プラグマGCCsystem_headerディレクティブ

このC ++ディレクティブは何をしますか： "＃pragma GCC system_header"？

私はグーグルでこれを手に入れました：

#pragma GCC system_header

This pragma takes no arguments. It causes the rest of the code in the
current file to be treated as if it came from a system header. Section 2.7
System Headers.

システムヘッダーの詳細

2.7。システムヘッダー

オペレーティングシステムおよびランタイムライブラリへのインターフェイスを宣言するヘッダーファイルは、厳密に準拠したCで記述できないことがよくあります。したがって、GCCは、システムヘッダーにあるコードを特別に扱います。#warning（第5章診断）によって生成されたものを除くすべての警告は、GCCがシステムヘッダーを処理している間は抑制されます。システムヘッダーで定義されたマクロは、展開された場所に関係なく、いくつかの警告の影響を受けません。この免除は、システムヘッダーで定義されたマクロのコードが原因で警告が多くの誤検知を生成することがわかった場合に、アドホックベースで付与されます。

通常、特定のディレクトリにあるヘッダーのみがシステムヘッダーと見なされます。これらのディレクトリは、GCCのコンパイル時に決定されます。ただし、通常のヘッダーをシステムヘッダーにする方法は2つあります。

-isystemコマンドラインオプションは、-Iと同様に、その引数をディレクトリのリストに追加してヘッダーを検索します。そのディレクトリで見つかったヘッダーはすべて、システムヘッダーと見なされます。

-isystemで指定されたすべてのディレクトリは、コマンドラインでの順序に関係なく、-Iで指定されたすべてのディレクトリの後に検索されます。同じディレクトリに-Iと-isystemの両方の名前が付けられている場合、-Iオプションは無視されます。-vが使用されている場合、これが発生すると、GCCは有益なメッセージを提供します。

#pragma GCC system_headerというディレクティブもあります。これは、GCCに、現在のインクルードファイルの残りの部分が見つかった場所に関係なくシステムヘッダーと見なすように指示します。ファイル内の#pragmaの前にあるコードは影響を受けません。#pragma GCC system_headerは、プライマリソースファイルには影響しません。

非常に古いシステムでは、事前定義されたシステムヘッダーディレクトリの一部がさらに特別な扱いを受けます。GNU C ++は、これらのディレクトリにあるヘッダー内のコードが外部の「C」ブロックで囲まれていると見なします。#pragma、またはコマンドラインからこの動作を要求する方法はありません。

このポイントを過ぎたものはすべて、システムヘッダーにあるかのように扱われると書かれています。これは、＃warning以外のすべての警告が抑制されることを意味します