#include_next

Diese Direktive ist eine GCC-spezifische Direktive, welche benötigt wird, um nicht wie bei der #include-Direktive die erstbeste auffindbare Datei einzubetten, sondern die darauffolgende. Damit ist gemeint, dass die im systemweiten Suchpfad eingegebenen Orte für include-Dateien zwar der Reihe nach abgesucht werden, jedoch das erste Auftreten der Datei übersprungen wird. Damit kann man erreichen, dass man eine Ersatz- oder Test-Datei für einen neuen Header testen kann, ohne den alten Header zu verlieren. Eine solche Header-Datei-Struktur ist jedoch viel zu spezifisch, als dass man eine generelle Aussage über die Verwendung dieser Direktive machen könnte. Von der Verwendung der #include_next-Direktive wird somit abgeraten.

#include_next "filename"

Details

Die #include_next-Direktive unterscheidet nicht wie die #include-Direktive zwischen Anführungszeichen "" und grösser-kleiner-Zeichen <>, sondern erwartet stets Anführungs- und Schlusszeichen "".

Benutzt man die Direktive in der Datei, welche die main-Funktion enthält, so gibt der Compiler eine #include_next in primary source file-Warnung aus.