Exponenta Banner

compiler.build.CppSharedLibraryOptions

Опции для создания C++ совместно использовали библиотеки

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

    Синтаксис

    opts = compiler.build.CppSharedLibraryOptions(FunctionFiles)
    opts = compiler.build.CppSharedLibraryOptions(FunctionFiles,Name,Value)

    Описание

    пример

    opts = compiler.build.CppSharedLibraryOptions(FunctionFiles) создает совместно использованный объект опций библиотеки C++ использование файлов MATLAB® FunctionFiles. Используйте CppSharedLibraryOptions возразите как вход против compiler.build.cppSharedLibrary функция.

    пример

    opts = compiler.build.CppSharedLibraryOptions(FunctionFiles,Name,Value) создает CppSharedLibraryOptions объект с опциями, заданными с помощью одного или нескольких аргументов значения имени. Опции включают имя библиотеки, выводят директорию и дополнительные файлы, чтобы включать.

    Примеры

    свернуть все

    Создайте CppSharedLibraryOptions объект с помощью файла вводится.

    В данном примере используйте файл magicsquare.m расположенный в matlabroot\extern\examples\compiler.

    appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
opts = compiler.build.CppSharedLibraryOptions(appFile)
    opts = 

  CppSharedLibraryOptions with properties:

                Interface: 'matlab-data'
    SampleGenerationFiles: {}
            FunctionFiles: {'C:\Program Files\MATLAB\R2021a\extern\examples\compiler\magicsquare.m'}
               DebugBuild: off
              LibraryName: 'magicsquare'
           LibraryVersion: '1.0.0.0'
          AdditionalFiles: {}
      AutoDetectDataFiles: on
                  Verbose: off
                OutputDir: '.\magicsquarecppSharedLibrary'

    Можно изменить значения свойств существующего CppSharedLibraryOptions объект с помощью записи через точку. Например, включите многословный выход.

    opts.Verbose = 'on'
    opts = 

  CppSharedLibraryOptions with properties:

                Interface: 'matlab-data'
    SampleGenerationFiles: {}
            FunctionFiles: {'C:\Program Files\MATLAB\R2021a\extern\examples\compiler\magicsquare.m'}
               DebugBuild: off
              LibraryName: 'magicsquare'
           LibraryVersion: '1.0.0.0'
          AdditionalFiles: {}
      AutoDetectDataFiles: on
                  Verbose: on
                OutputDir: '.\magicsquarecppSharedLibrary'

    Используйте CppSharedLibraryOptions возразите как вход против compiler.build.cppSharedLibrary функционируйте, чтобы создать совместно использованную библиотеку C++.

    buildResults = compiler.build.cppSharedLibrary(opts);

    Создайте CppSharedLibraryOptions возразите и настройте его с помощью аргументов значения имени.

    В данном примере используйте файл magicsquare.m расположенный в matlabroot\extern\examples\compiler. Используйте аргументы значения имени, чтобы задать выходную директорию и отключить автоматическое обнаружение файлов данных.

    appFile = fullfile(matlabroot,'extern','examples','compiler','magicsquare.m');
opts = compiler.build.CppSharedLibraryOptions(appFile,...
    'OutputDir','D:\Documents\MATLAB\work\MagicSquareLib',...
    'AutoDetectDataFiles','off')
    opts = 

  CppSharedLibraryOptions with properties:

                Interface: 'matlab-data'
    SampleGenerationFiles: {}
            FunctionFiles: {'C:\Program Files\MATLAB\R2021a\extern\examples\compiler\magicsquare.m'}
               DebugBuild: off
              LibraryName: 'magicsquare'
           LibraryVersion: '1.0.0.0'
          AdditionalFiles: {}
      AutoDetectDataFiles: off
                  Verbose: off
                OutputDir: 'D:\Documents\MATLAB\work\MagicSquareLib'

    Можно изменить значения свойств существующего CppSharedLibraryOptions объект с помощью записи через точку. Например, включите многословный выход.

    opts.Verbose = 'on'
    opts = 

  CppSharedLibraryOptions with properties:

                Interface: 'matlab-data'
    SampleGenerationFiles: {}
            FunctionFiles: {'C:\Program Files\MATLAB\R2021a\extern\examples\compiler\magicsquare.m'}
               DebugBuild: off
              LibraryName: 'magicsquare'
           LibraryVersion: '1.0.0.0'
          AdditionalFiles: {}
      AutoDetectDataFiles: off
                  Verbose: on
                OutputDir: 'D:\Documents\MATLAB\work\MagicSquareLib'

    Используйте CppSharedLibraryOptions возразите как вход против compiler.build.cppSharedLibrary функционируйте, чтобы создать совместно использованную библиотеку C++.

    buildResults = compiler.build.cppSharedLibrary(opts);

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

    свернуть все

    Файлы, реализующие функции MATLAB в виде вектора символов, строкового скаляра, массива строк или массива ячеек из символьных векторов. Пути к файлам могут быть относительно текущей рабочей директории или абсолюта. Файлы должны иметь .m расширение.

    Пример: ["myfunc1.m","myfunc2.m"]

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

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

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

    Пример: 'Verbose','on'

    Дополнительные файлы, чтобы включать в C++ совместно использовали библиотеку в виде вектора символов, строкового скаляра, массива строк или массива ячеек из символьных векторов. Пути к файлам могут быть относительно текущей рабочей директории или абсолюта.

    Пример: 'AdditionalFiles',["myvars.mat","data.txt"]

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

    Отметьте, чтобы автоматически включать файлы данных в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

    • Если вы устанавливаете это свойство на 'on', затем файлы данных, которые вы предоставляете как входные параметры определенным функциям (такой как load и fopen) автоматически включены в разделяемую библиотеку.

    • Если вы устанавливаете это свойство на 'off', затем необходимо добавить файлы данных в разделяемую библиотеку с помощью AdditionalFiles свойство.

    Пример: 'AutoDetectDataFiles','off'

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

    Отметьте, чтобы включить отладочные символы в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

    • Если вы устанавливаете это свойство на 'on', затем скомпилированная библиотека содержит отладочные символы.

    • Если вы устанавливаете это свойство на 'off', затем скомпилированная библиотека не содержит отладочные символы.

    Пример: 'DebugBuild','on'

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

    Интерфейсный API в виде одной из следующих опций:

    • 'matlab-data' — Сгенерируйте совместно использованные библиотеки с помощью MATLAB Data API.

    • 'mwarray' — Сгенерируйте совместно использованные библиотеки с помощью mwArray API.

    Для получения дополнительной информации смотрите Выбор API для C++ Разделяемая Библиотека.

    Пример: 'Interface','mwarray'

    Имя C++ совместно использовало библиотеку в виде вектора символов или строкового скаляра. Имя по умолчанию сгенерированной библиотеки является первой записью FunctionFiles аргумент.

    Пример: 'LibraryName','mymagic'

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

    Путь к выходной директории, где файлы типа "build" сохранены в виде вектора символов или строкового скаляра. Путь может быть относительно текущей рабочей директории или абсолюта.

    Имя по умолчанию папки сборки является именем библиотеки, добавленным с cppSharedLibrary.

    Пример: 'OutputDir','D:\Documents\MATLAB\work\mymagiccppSharedLibrary'

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

    Файлы примера MATLAB раньше генерировали демонстрационные файлы библиотеки C++ для функций, включенных в библиотеке в виде вектора символов, строкового скаляра, массива строк или массива ячеек из символьных векторов. Пути к файлам могут быть относительно текущей рабочей директории или абсолюта. Файлы должны иметь .m расширение. Для получения дополнительной информации и ограничения, смотрите Демонстрационное Создание Файла Драйвера.

    Пример: 'SampleGenerationFiles',["sample1.m","sample2.m"]

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

    Отметьте, чтобы управлять многословием сборки в виде 'on' или 'off', или как числовой или логический 1 TRUE) или 0 ложь). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом можно использовать значение этого свойства как логическое значение. Значение хранится как логическое значение включения - выключения типа matlab.lang.OnOffSwitchState.

    • Если вы устанавливаете это свойство на 'on', затем окно команды MATLAB отображает информацию о прогрессе, указывающую на выход компилятора во время процесса сборки.

    • Если вы устанавливаете это свойство на 'off', затем командное окно не отображает информацию о прогрессе.

    Пример: 'Verbose','on'

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

    Выходные аргументы

    свернуть все

    Библиотека C++ создает опции, возвращенные как CppSharedLibraryOptions объект.

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

    Введенный в R2021a

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

    Поддержка