C++. Сборник рецептов | страница 29
Пример 1.5. Файл определения модуля для libgeorgeringo.dll
>LIBRARY LIBGEORGERINGO.DLL
>EXPORTS
> Georgeringo @1
Имеется два стандартных метода экспорта символов из Windows DLL.
• Использование атрибута >__declspec(dllexport)
в заголовочных файлах DLL и сборка библиотеки импорта, предназначенной для применения при сборке кода, использующего эту DLL.
Атрибут >__dеclspec(dllexport)
должен указываться в начале объявления экспортируемой функции или данных, вслед за какими-либо спецификаторами сборки, и сразу за ним должно следовать ключевое слово >class
или >struct
для экспортируемого класса. Это проиллюстрировано в примере 1.6. Заметьте, что >__declspec(dllexport)
не является частью языка С++; это расширение языка, реализованное для большинства компиляторов для Windows.
• Создание файла .def, описывающего функции и данные, экспортируемые из динамической библиотеки.
Пример 1.6. Использование атрибута __declspec(dllexport)
>__declspec(dllexport) int m = 3; // Экспортируемое определение данных
>extern __declspec(dllexport) int n; // Экспортируемое объявление данных
>__declspec(dllexport) void f(); // Экспортируемое объявление функции class
>__declspec(dllexport) c { // Экспортируемое определение класса
> /* ... */
>};
Использование файла .def имеет несколько преимуществ — например, он может позволить осуществлять доступ к функциям в DLL по номеру, а не по имени, что сокращает размер DLL. Он также устраняет необходимость запутанных директив препроцессора, таких как показанные в примере 1.2 в заголовочном файле georgeringo.hpp. Однако он также имеет и несколько серьезных недостатков. Например, файл .def не может использоваться для экспорта классов. Более того, можно забыть обновить свой файл .def при добавлении, удалении или изменении функций в вашей DLL. Таким образом, я рекомендую вам всегда использовать >__declspec(dllexport)
. Чтобы изучить полный синтаксис файлов .def, а также научиться их использовать, обратитесь к документации по своему инструментарию.
Как есть два способа экспорта символов из DLL, так есть и два способа импорта символов.
• В заголовочных файлах, включенных в исходный код, использующий DLL, используйте атрибут >__declspec(dllimport)
и при сборке этого кода передайте библиотеку импорта компоновщику.