Прагмы hdrstop, no_implicit_inclusion, no_pch, once и system_header помогают компилятору обрабатывать заголовочные файлы проекта (*.h), используя предварительную компиляцию заголовков, что потенциально может уменьшить общее время компиляции проекта.

[#pragma hdrstop]

Прагма hdrstop pragma используется вместе с ключом командной строки -pch (precompiled header), см. врезку ниже. Опция -pch инструктирует компилятор искать файл предварительной компиляции заголовков (файл с расширением *.pch), и если не получилось его найти, то этот файл будет сгенерирован для использования в последующей компиляции. Файл *.pch содержит снимок всего кода, который был скомпилирован до точки останова предварительной компиляции (header stop point). Эта точка в исходном коде (или в заголовочном файле) задается директивой #pragma hdrstop.

cc0219:  Catastrophic error: error while deleting file
          "PCHRepository\somefile.pch"

1 catastrophic error detected in the compilation of ".\somefile.cpp".
Compilation terminated.
cc3089: fatal error: Compilation failed
Tool failed with exit/exception code: 1.
Build was unsuccessful.

По умолчанию точка header stop point (если #pragma hdrstop не используется) - первая не обрабатываемая предварительной компиляцией строка в основном исходном коде. Директива #pragma hdrstop может использоваться установки header stop point в файле исходного кода.

В следующем примере точка останова по умолчанию для предварительной компиляции - начало декларации переменной i.

#include "standard_defs.h"

#include "common_data.h"

#include "frequently_changing_data.h"

int i;

Такой вариант выбора точки останова предварительной компиляции может быть плохим выбором, потому что заголовочный файл frequently_changing_data.h может находится на стадии разработки и подвергаться частым модификациям. Это приведет к тому, что файл *.pch будет часто генерироваться заново, и выгода использования precompiled header теряется. Прагма hdrstop может использоваться для того, чтобы выбрать более подходящее место для точки header stop.

В следующем примере файл precompiled header не будет включать frequently_changing_data.h, потому что он подключается после #pragma hdrstop. Поэтому precompiled header не нужно будет создавать заново каждый раз, когда был изменен frequently_changing_data.h.

#include "standard_defs.h"

#include "common_data.h"

#pragma hdrstop

#include "frequently_changing_data.h"

int i;

[#pragma no_implicit_inclusion]

С помощью опции -c++ (см. врезку ниже) для каждого файла заголовка (с расширением *.h или без расширения), компилятор пытается подключить соответствующий файл *.c или .cpp. Это называется "неявное подключение" (implicit inclusion).

Если строка #pragma no_implicit_inclusion помещена в заголовочный файл *.h (или файл без расширения), то компилятор не будет неявно подключать соответствующий файл *.c или .cpp при компиляции с опцией -c++. Это поведение влияет только на файл *.h (или файл без расширения), в котором есть строка #pragma no_implicit_inclusion, и соответствующие файлы *.c или *.cpp.

Например, если есть файл t.c, содержащий

#include "m.h"

и файлы m.h и m.c оба пустые, то командная строка:

ccblkfn -c++ t.c -M

покажет следующие зависимости для t.c:

t.doj: t.c
t.doj: m.h
t.doj: m.c 

Если следующая строка добавлена в m.h:

#pragma no_implicit_inclusion

то запуск компилятора с той же командой (ccblkfn -c++ t.c -M) не покажет m.c в списке зависимостей:

t.doj: t.c
t.doj: m.h

[#pragma no_pch]

Прагма no_pch отменяет ключ -pch (precompiled headers) для определенного файла исходного кода. Она указывает компилятору, что он не должен искать файл *.pch, и не должен генерировать его для указанного файла исходного кода.

[#pragma once]

Прагма once предназначена для замены набора директив #ifndef/#define/#endif. Это просто "синтаксический сахар", используемый для красоты и удобства.

Директива #pragma once должна находиться в начале заголовочного файла. Она говорит компилятору, что этот заголовочный файл написан таким образом, что его однократное подключение дает тот же эффект, как и многократное подключение. Т. е., говоря по-русски, заголовочный файл с #pragma once должен подключаться в проекте только один раз, даже если директива #include этого файла встречается во многих модулях проекта. Например,

#pragma once
// Следующие обрамляющие директивы #ifndef/#define/#endif
// больше не нужны:

#ifndef FILE_H

#define FILE_H

... содержимое файла заголовка ...

#endif

Примечание: в этом примере директиву #pragma once в действительности указывать необязательно, потому что компилятор увидит директивы #ifndef, #define и #endif, и не будет повторно обрабатывать этот заголовок.

[#pragma system_header]

Прагма system_header pragma идентифицирует файл как файл, предоставленный системой программирования VisualDSP++. Компилятор VisualDSP++ использует эту информацию, чтобы помочь оптимизации использования предоставляемых библиотечных функций и inline-функций, которые определены этими файлами. Не используйте эту прагму в исходном коде пользовательского приложения.

[Ссылки]

1. Linker Description File.
2. Visual Studio: /Yc, /Yu, #pragma hdrstop, stdafx.h.