7.4 Прагмы C++ интерфейса и реализации

#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++ [Содержание][Индекс]