2.7 Заголовки обёртки

Иногда необходимо изменить содержимое заголовочного файла, предоставляемого системой, не редактируя его напрямую. Например, операция fixincludes GCC это делает. Один из способов сделать это — создать новый заголовочный файл с тем же именем и вставить его в путь поиска перед исходным заголовком. Это работает хорошо, пока вы готовы полностью заменить старый заголовок. Но что, если вы хотите сослаться на старый заголовок из нового?

Вы не можете просто включить старый заголовок с помощью ‘#include’. Это начнёт с начала и снова найдёт ваш новый заголовок. Если ваш заголовок не защищён от многократного включения (см. Заголовки, включаемые только один раз), он будет рекурсировать бесконечно и вызовет ошибку.

Вы могли бы включить старый заголовок с абсолютным путём:

#include "/usr/include/old-header.h"

Это работает, но не является чистым; если заголовки системы когда-либо перемещаются, вам придётся редактировать новые заголовки, чтобы они соответствовали.

В стандарте C нет способа решить эту проблему, но вы можете использовать расширение GNU ‘#include_next’. Это означает «Включить следующий файл с этим именем». Эта директива работает как ‘#include’, за исключением поиска указанного файла: поиск начинается в списке каталогов заголовочных файлов после каталога, в котором был найден текущий файл.

Предположим, вы задаёте -I /usr/local/include, и список каталогов для поиска также включает /usr/include; и предположим, что оба каталога содержат signal.h. Обычный #include <signal.h> находит файл в /usr/local/include. Если этот файл содержит #include_next <signal.h>, он начинает поиск после этого каталога и находит файл в /usr/include.

‘#include_next’ не различает <file> и "file" включения, а также не проверяет, что указанный вами файл имеет то же имя, что и текущий файл. Он просто ищет файл с указанным именем, начиная с каталога в пути поиска после каталога, в котором был найден текущий файл.

Использование ‘#include_next’ может привести к большой путанице. Мы рекомендуем использовать его только в том случае, если нет других вариантов. В частности, его не следует использовать в заголовках, относящихся к конкретной программе; его следует использовать только для внесения глобальных исправлений в соответствии со fixincludes.

Далее: Системные заголовки, Предыдущий: Вычисленные включения, Вверх: Заголовочные файлы [Оглавление][Индекс]