Опции для создания общих библиотек C++
создает объект опций общей библиотеки C++ с помощью MATLAB® файлы opts = compiler.build.CppSharedLibraryOptions(FunctionFiles)FunctionFiles. Используйте CppSharedLibraryOptions объект как вход в compiler.build.cppSharedLibrary функция.
создает opts = compiler.build.CppSharedLibraryOptions(FunctionFiles,Name,Value)CppSharedLibraryOptions объект с опциями, заданными с помощью одного или нескольких аргументов в виде имя-значение. Опции включают имя библиотеки, выходную директорию и дополнительные файлы, которые нужно включить.
Создайте CppSharedLibraryOptions объект с использованием ввода файла.
В данном примере используйте файл magicsquare.m расположен в .matlabroot\ extern\примеры\компилятор
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\примеры\компилятор
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);
FunctionFiles - Файлы, реализующие функции MATLABФайлы, реализующие функции MATLAB, заданные как вектор символов, строковый скаляр, строковые массивы или массив ячеек векторов символов. Пути к файлам могут быть относительно текущей рабочей директории или абсолютными. Файлы должны иметь .m расширение.
Пример: ["myfunc1.m","myfunc2.m"]
Типы данных: char | string | cell
Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.
'Verbose','on''AdditionalFiles' - Дополнительные файлыДополнительные файлы для включения в общую библиотеку C++, заданные как вектор символов, строковый скаляр, строковые массивы или массив ячеек векторов символов. Пути к файлам могут быть относительно текущей рабочей директории или абсолютными.
Пример: 'AdditionalFiles',["myvars.mat","data.txt"]
Типы данных: char | string | cell
'AutoDetectDataFiles' - Флаг для автоматического включения файлов данных'on' (по умолчанию) | логическое значение включения/выключенияФлаг для автоматического включения файлов данных, заданный как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.
Если вы задаете это свойство равным 'on', затем файлы данных, которые вы предоставляете в качестве входов для определенных функций (таких как load и fopen) автоматически включаются в общую библиотеку.
Если вы задаете это свойство равным 'off', затем необходимо добавить файлы данных в общую библиотеку с помощью AdditionalFiles свойство.
Пример: 'AutoDetectDataFiles','off'
Типы данных: logical
'DebugBuild' - Флаг для включения отладки символов'off' (по умолчанию) | логическое значение включения/выключенияФлаг для включения отладки символов, заданный как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.
Если вы задаете это свойство равным 'on', затем скомпилированная библиотека содержит символы отладки.
Если вы задаете это свойство равным 'off', тогда скомпилированная библиотека не содержит символов отладки.
Пример: 'DebugBuild','on'
Типы данных: logical
'Interface' - Интерфейсный API'matlab-data' (по умолчанию) | 'mwarray'Интерфейс API, заданный как один из следующих опций:
'matlab-data' - Создавайте общие библиотеки с помощью MATLAB Data API.
'mwarray' - Создавайте общие библиотеки с помощью mwArray API.
Для получения дополнительной информации см. раздел «Выбор API для общей библиотеки C++».
Пример: 'Interface','mwarray'
'LibraryName' - Имя разделяемой библиотеки C++Имя общей библиотеки C++, заданное как вектор символов или строковый скаляр. Имя по умолчанию сгенерированной библиотеки является первой записью FunctionFiles аргумент.
Пример: 'LibraryName','mymagic'
Типы данных: char | string
'OutputDir' - Путь к выходной директорииПуть к выходу директории, где сохраняются файлы сборки, задается в виде вектора символов или строкового скаляра. Путь может быть относительно текущей рабочей директории или абсолютным.
Именем по умолчанию для папки сборки является имя библиотеки, добавленное в cppSharedLibrary.
Пример: 'OutputDir','D:\Documents\MATLAB\work\mymagiccppSharedLibrary'
Типы данных: char | string
'SampleGenerationFiles' - Образцы файлов MATLABMATLAB выборки файлов, используемых для генерации образцов файлов библиотеки C++ для функций, включенных в библиотеку, заданные как вектор символов, строковый скаляр, строковые массивы или массив ячеек из векторов символов. Пути к файлам могут быть относительно текущей рабочей директории или абсолютными. Файлы должны иметь .m расширение. Для получения дополнительной информации и ограничений см. Пример создания файла драйвера.
Пример: 'SampleGenerationFiles',["sample1.m","sample2.m"]
Типы данных: char | string | cell
'Verbose' - Флаг для управления подробностями сборки'off' (по умолчанию) | логическое значение включения/выключенияФлаг для управления подробностями сборки, заданный как 'on' или 'off', или как числовое или логическое 1 (true) или 0 (false). Значение 'on' эквивалентно true, и 'off' эквивалентно false. Таким образом, можно использовать значение этого свойства как логическое значение. Значение сохранено в виде логического значения on/off типа matlab.lang.OnOffSwitchState.
Если вы задаете это свойство равным 'on', затем в командном окне MATLAB отображается информация о прогрессе, указывающая на выход компилятора в процессе сборки.
Если вы задаете это свойство равным 'off'затем командное окно не отображает информацию о прогрессе.
Пример: 'Verbose','on'
Типы данных: logical
opts - Опции сборки библиотеки C++CppSharedLibraryOptions объектОпции сборки библиотеки C++, возвращенные как CppSharedLibraryOptions объект.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.