4.2.10 __has_include

Специальный оператор __has_include (operand) может использоваться в выражениях ‘#if’ и ‘#elif’ для проверки, может ли заголовочный файл, указанный в его операнде, быть включён с помощью директивы ‘#include’. Использование оператора в других контекстах недопустимо. Операнд принимает ту же форму, что и файл в директиве ‘#include’ (см. Синтаксис включения), и возвращает ненулевое значение, если заголовочный файл может быть включён, и нулевое значение в противном случае. Обратите внимание, что возможность включения заголовочного файла не означает, что заголовочный файл не содержит недопустимых конструкций или директивы ‘#error’, которые могут привести к ошибке препроцессора.

Оператор __has_include сам по себе, без операнда или скобок, действует как предопределённая макрос, так что его поддержку можно проверить в переносимом коде. Таким образом, рекомендуемое использование оператора таково:

#if defined __has_include
#  if __has_include (<stdatomic.h>)
#    include <stdatomic.h>
#  endif
#endif

Первый тест ‘#if’ проходит только тогда, когда оператор поддерживается используемой версией GCC (или другим компилятором). Только при успешном прохождении этого теста допустимо использовать __has_include как оператор препроцессора. В результате объединение двух тестов в одно выражение, как показано ниже, будет допустимо только с компилятором, поддерживающим оператор, но не с другими компиляторами, его не поддерживающими.

#if defined __has_include && __has_include ("header.h")   /* not portable */
…
#endif