Exponenta Banner

clibgen.buildInterface

Создайте интерфейс к библиотеке C++ без файла определения

свернуть все на странице

Синтаксис

clibgen.buildInterface(CppFiles)
clibgen.buildInterface(CppFiles,'Libraries',SharedLibrary)
clibgen.buildInterface(CppFiles,Name,Value)

Описание

пример

clibgen.buildInterface(CppFiles) генерирует интерфейс MATLAB® к библиотеке C++, заданной HeaderFiles. Именем интерфейсного файла библиотеки является libNameИнтерфейс, со специфичным для платформы расширением файла. По умолчанию, libName имя файл, заданный в HeaderFiles. Если вы используете больше чем один заголовочный файл, то необходимо задать PackageName аргумент. Если вы используете совместно использованный файл библиотеки, то необходимо задать Libraries аргумент.

Вам нужен поддерживаемый MATLAB компилятор C++. Необходимо создать интерфейсную библиотеку с помощью того же компилятора, который использовался, чтобы создать библиотеку C++. Если ваша библиотека только для заголовка (не использует совместно использованный файл библиотеки), то можно выбрать, любой поддержал компилятор C++, чтобы создать интерфейсную библиотеку.

Конструкторы класса, методы и функции, которые не может автоматически задать MATLAB, не включены в интерфейс. Чтобы включать недостающую функциональность, используйте clibgen.generateLibraryDefinition функция.

clibgen.buildInterface(CppFiles,'Libraries',SharedLibrary) создает интерфейс для библиотеки с одним или несколькими совместно использованными файлами библиотеки.

clibgen.buildInterface(CppFiles,Name,Value) генерирует интерфейс с помощью одного или нескольких аргументов пары "имя-значение".

Примеры

свернуть все

Скопируйте school.hpp заголовочный файл к перезаписываемой папке H:\Documents\MATLAB\publisher.

copyfile(fullfile(matlabroot,'extern','examples','cpp_interface','school.hpp'),'.','f')

Создайте интерфейс schoolInterface.dll.

clibgen.buildInterface('school.hpp')
Building interface file 'schoolInterface.dll'.
Interface file 'schoolInterface.dll' built in folder 'H:\Documents\MATLAB\publisher\school'.
To use the library, add the interface file folder to the MATLAB path.
1 constructs need further definition to be included in the interface. 
Use clibgen.generateLibraryDefinition to provide definitions.

Нажмите interface file folder соединитесь, чтобы добавить интерфейс в путь.

Введите clib.schoolТочка, затем нажмите Tab, чтобы отобразить классы в библиотеке.

Отобразите справку для библиотеки.

help clib.school
Classes contained in clib.school:
Person                         - clib.school.Person    Representation of C++ class Person
Teacher                        - clib.school.Teacher    Representation of C++ class Teacher
Student                        - clib.school.Student    Representation of C++ class Student

Сравните эту функциональность с выходом summary(defineschool) команда в Публикует Интерфейс к Библиотеке C++ Только для заголовка. Этот интерфейс не включает:

Functions
  string clib.school.getName(clib.school.Person)

Входные параметры

свернуть все

Один или несколько файлов C++ для генерации интерфейса в виде массива строк, вектора символов или массива ячеек из символьных векторов. Интерфейсные файлы генерации являются или заголовочными файлами или исходным кодом .cpp файлы. Поддерживаемыми расширениями заголовочного файла является .h, .hpp, и .hxx. Код в .h заголовочными файлами должен быть C++ совместимый код С. Заголовочный файл без расширения также поддерживается. Поддерживаемыми расширениями исходного файла является .cpp и .cxx. Если не в текущей папке или на вашем пути MATLAB, то имя включает полный или относительный путь в файл. Файл должен содержать Код С++.

Эти файлы должны содержать объявления всех функций, экспортируемых библиотекой. Необходимо смочь скомпилировать их в среде разработки C++ и использовать функциональность в приложениях C++. Если библиотека полностью задана заголовочными файлами (библиотека только для заголовка), то вам не нужен файл библиотеки.

Если основной заголовочный файл содержит #include операторы для заголовочных файлов в различных папках, затем используйте IncludePath аргумент, чтобы задать эти пути.

Если вы обеспечиваете одно имя заголовочного файла, то MATLAB ищет библиотеку с тем же именем в той же папке как заголовочный файл. Библиотека должна иметь специфичное для платформы расширение файла. Если библиотека имеет другое имя и/или не находится в той же папке, то используйте Libraries аргумент.

MATLAB записывает интерфейсные файлы в подпапке в текущей папке, если вы не задаете OutputFolder аргумент. Имя подпапки является именем первого заголовочного файла без расширения файла. Например, следующий оператор создает интерфейсный файл библиотеки в подпапке myHeader в текущей папке.

clibgen.buildInterface('myHeader.hpp')

Пример: "sample.hpp"

Пример: "sample.cxx"

Типы данных: char | string | cell

Одно или несколько имен полного пути к библиотекам в виде массива строк, вектора символов или массива ячеек из символьных векторов. Используйте с 'Libraries' аргумент. Это значение требуется за исключением библиотек только для заголовка, который является библиотекой, заданной полностью ее заголовочными файлами. Разделяемая библиотека является одним из следующего:

  • На платформах Microsoft® используйте .dll файл динамически подключаемой библиотеки.

  • На платформах Linux® используйте .so файл общего объекта.

  • На macOS платформах используйте .dylib динамический совместно использованный файл библиотеки.

Например, выполнение этого оператора на Windows® создает sampleInterface.dll использование myLib.lib в C:\myLib\ и записи это к подпапке sample в текущей папке.

clibgen.buildInterface('sample.hpp','Libraries','C:\myLib\myLib.lib')

Типы данных: char | string | cell

Аргументы в виде пар имя-значение

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: clibgen.buildInterface('myHeader.hpp','Libraries','myHeader.lib','OutputFolder','C:\work');

Одна или несколько папок для включенных заголовочных файлов в виде массива строк, вектора символов или массива ячеек из символьных векторов. IncludePath имя полного пути к папкам, чтобы включать во время компиляции заголовочных файлов.

Если основной заголовочный файл содержит #include операторы для заголовочных файлов в различных папках, затем используйте IncludePath аргумент, чтобы задать эти пути.

Типы данных: char | string | cell

Имя папки раньше генерировало интерфейсную библиотеку в виде строкового скаляра или вектора символов. Например, этот оператор создает myHeaderInterface.dll в C:\work\myHeader на Windows.

clibgen.buildInterface('myHeader.hpp','OutputFolder','C:\work')

Типы данных: char | string | cell

Сгенерированный интерфейсный пакет называет в виде строкового скаляра или вектора символов. Для интерфейсов, созданных из одного заголовочного файла, значением по умолчанию является имя заголовка. Для нескольких заголовочных файлов необходимо задать имя пакета как допустимое имя MATLAB. Например, этот оператор создает myPackageInterface файл библиотеки в подпапке myPackage в текущей папке.

clibgen.buildInterface({'h1.hpp','h2.hpp'},'PackageName','myPackage')

Типы данных: char | string | cell

Опция, чтобы отобразить сообщения генерации в виде true или false. Когда true, clibgen.buildInterface генерация отображений обменивается сообщениями к командному окну при создании интерфейса. Например, этот оператор создает h1Interface файл библиотеки в подпапке h1 и отображения обмениваются сообщениями в командном окне.

clibgen.buildInterface('h1.hpp','Verbose',true)

Для получения дополнительной информации см. сообщения О Неподдерживаемых Типах.

Типы данных: логический

Сформируйте спецификатор для объектных указателей в виде true или false. Если TreatObjectPointerAsScalar true, затем MATLAB обрабатывает все объектные указатели в библиотеке как скаляры путем определения SHAPE как 1. В противном случае форма объектного указателя неизвестна.

Типы данных: логический

Форма и MATLAB вводят спецификатор для const символьные указатели в виде true или false. Если TreatConstCharPointerAsCString true, затем MATLAB обрабатывает весь const символьные указатели в библиотеке как отключенные пустым указателем струны до путем определения MLTYPE как string и SHAPE как nullTerminated. В противном случае, тип MATLAB и форма const символьные указатели неизвестны. Поддерживаемые типы указателей:

  • const char *

  • const wchar_t *

  • const char16_t *

  • const char32_t *

Типы данных: логический

Список макроопределений, чтобы использовать при парсинге заголовочных файлов в виде пустого, скалярной строки или вектора-строки из скалярных строк. Макро-имя содержит символы 1–9, a–z, A–Z и '_' и не может начаться с цифры.

Типы данных: string

Список макро-отмен, чтобы использовать при парсинге заголовочных файлов в виде пустого, скалярной строки или вектора-строки из скалярных строк. Макро-имя содержит символы 1–9, a–z, A–Z и '_' и не может начаться с цифры.

Типы данных: string

Сгенерировать ли документацию из файлов C++ в виде true или false. Если GenerateDocumentationFromHeaderFiles true, затем MATLAB генерирует документацию из комментариев в исходных файлах C++ для отображения с помощью MATLAB doc команда. Если false, затем MATLAB игнорирует комментарии C++ и только генерирует документацию отображений типа MATLAB и C++.

Для получения дополнительной информации смотрите, Публикуют текст Справки для Интерфейса MATLAB к Библиотеке C++.

Типы данных: логический

Возвратить ли массивы необъекта C в виде true или false. Если ReturnCArrays true, затем MATLAB возвращает массивы C (clib.array.*) для массивов необъекта C. Если false, затем MATLAB возвращает числовые массивы MATLAB для массивов необъекта C.

Типы данных: логический

Сгенерировать ли документацию из файлов C++ в виде true или false. Если GenerateDocumentationFromHeaderFiles true, затем MATLAB генерирует документацию из комментариев в исходных файлах C++ для отображения с помощью MATLAB doc команда. Если false, затем MATLAB игнорирует комментарии C++ и только генерирует документацию отображений типа MATLAB и C++.

Для получения дополнительной информации смотрите, Публикуют текст Справки для Интерфейса MATLAB к Библиотеке C++.

Типы данных: логический

Один или несколько исходных файлов C++ в виде массива строк, вектора символов или массива ячеек из символьных векторов. Поддерживаемыми расширениями файла является .cpp и .cxx. Если не в текущей папке или на вашем пути MATLAB, то имя включает полный или относительный путь в файл. Исходный файл поддержки должен содержать Код С++.

Пример: "sample.cpp"

Типы данных: char | string | cell

Ограничения

Смотрите также

Введенный в R2019a

Документация MATLAB

Поддержка