7.4 C++ Интерфейс и реализация пragma

#pragma interface и #pragma implementation предоставляют пользователю способ явно указать компилятору на необходимость генерировать сущности с размытой связью (и отладочной информацией) в конкретном трансляционном блоке.

Примечание: Эти #pragma устарели начиная с GCC 2.7.2 в пользу поддержки COMDAT и эвристики «ключевого метода», упомянутой в Размытой связности. Их использование может фактически увеличить размер программы из-за ненужных внестрочных копий встроенных функций.

#pragma interface

#pragma interface "subdir/objects.h"

Используйте эту директиву в заголовочных файлах, определяющих классы объектов, чтобы сэкономить место в большинстве объектных файлов, использующих эти классы. Обычно локальные копии определённой информации (резервные копии встроенных функций-членов, отладочная информация и внутренние таблицы, реализующие виртуальные функции) должны храниться в каждом объектном файле, включающем определения классов. Вы можете использовать эту директиву, чтобы избежать такого дублирования. При включении в компиляцию заголовочного файла, содержащего ‘#pragma interface’, эта вспомогательная информация не генерируется (если только сам основной исходный файл не использует ‘#pragma implementation’). Вместо этого объектные файлы содержат ссылки, которые будут разрешены на этапе компоновки.

Вторая форма этой директивы полезна в случае, когда у вас есть несколько заголовочных файлов с одинаковым именем в разных каталогах. Если вы используете эту форму, вы должны указать ту же строку для ‘#pragma implementation’.

#pragma implementation

#pragma implementation "objects.h"

Используйте эту директиву в основном исходном файле, когда вы хотите получить полную информацию из включённых заголовочных файлов (и сделать её глобально видимой). Включённый заголовочный файл, в свою очередь, должен использовать ‘#pragma interface’. Резервные копии встроенных функций-членов, отладочная информация и внутренние таблицы, используемые для реализации виртуальных функций, генерируются во всех файлах реализации.

Если вы используете ‘#pragma implementation’ без аргумента, оно применяется к файлу включения с тем же базовым именем⁴, что и ваш исходный файл. Например, в allclass.cc, указание только ‘#pragma implementation’ эквивалентно ‘#pragma implementation "allclass.h"’.

Используйте строковый аргумент, если вы хотите, чтобы один файл реализации включал код из нескольких заголовочных файлов. (Вы также должны использовать ‘#include’ для включения заголовочного файла; ‘#pragma implementation’ только указывает, как использовать файл — он его не включает.)

Нет способа разделить содержимое одного заголовочного файла на несколько файлов реализации.

‘#pragma implementation’ и ‘#pragma interface’ также влияют на встроенные функции.

Если вы определяете класс в заголовочном файле, помеченном как ‘#pragma interface’, эффект на встроенную функцию, определённую в этом классе, похож на явное extern объявление — компилятор вообще ничего не генерирует для определения независимой версии функции. Его определение используется только для встроенного вызова.

Напротив, при включении того же заголовочного файла в основной исходный файл, который объявляет его как ‘#pragma implementation’, компилятор генерирует код для самой функции; это определяет версию функции, которая может быть найдена через указатели (или вызывающие функции, скомпилированные без встроенных вызовов). Если все вызовы функции могут быть встроены, вы можете избежать генерации функции, скомпилировав с -fno-implement-inlines. Если какие-либо вызовы не встроены, у вас возникнут ошибки компоновки.

Далее: Шаблон инстанцирования, Предыдущее: Размытая связь, Вверх: Расширения C++ [Содержание][Индекс]