mbuild

Скомпилируйте и соедините исходные файлы с сгенерированными MATLAB общими библиотеками

Синтаксис

mbuild [option1 ... optionN] sourcefile1 [... sourcefileN]
   [objectfile1 ... objectfileN] [libraryfile1 ... libraryfileN]

Описание

mbuild компилирует и связывает написанный клиентом код C or C++ с MATLAB® сгенерированные общие библиотеки.

Некоторые из этих опций (-f, -g, и -v) доступны на mcc командная строка и передаются в mbuild. Другие могут быть переданы с помощью -M опция для mcc. Для получения дополнительной информации о -M опция, см. mcc страница с описанием.

Поддерживаемые типы исходных файлов

Поддерживаемые типы исходных файлов:

  • .c

  • .cpp

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

Опции

В этой таблице перечислены наборы mbuild опции. Если платформа не указана, опция доступна в обоих UNIX® и Windows®.

ОпцияОписание
@<rspfile>

(Только для Windows) Включить содержимое текстового файла <rspfile> как аргументы командной строки для mbuild.

-c

Компилируйте только. Создает только файл объекта.

-D<name>

Определите имя символа для препроцессора C. Эквивалентно #define <name> директива в источнике.

-D<name>=<value>

Определите имя и значение символа для препроцессора C. Эквивалентно #define <name> <value> директива в источнике.

-f <optionsfile>

Укажите местоположение и имя файла опций для использования. Переопределяет mbuild по умолчанию опции механизм поиска файлов.

-g

Создайте исполняемый файл, содержащий дополнительную символическую информацию для использования в отладке. Эта опция отключает mbuild поведение по умолчанию оптимизации построенных объектных кодов (см. -O опция).

-h[elp]

Распечатать справку для mbuild.

-I<pathname>

Добавить <pathname> в список папок для поиска #include файлы.

-l<name>

Ссылка на библиотеку объектов. В системах Windows, <name> расширяется до <name>.lib или lib<name>.lib и в системах UNIX, для lib<name>.so или lib<name>.dylib. Не добавляйте пространство после этого коммутатора.

Примечание

При связывании с библиотекой важно сначала задать путь (с -I<pathname>, для примера).

-L<folder>

Добавить <folder> в список папок для поиска библиотек, указанных в -l опция. В системах UNIX необходимо также задать пути к библиотеке во время выполнения. Не добавляйте пространство после этого коммутатора.

-n

Режим выполнения отсутствует. Распечатайте все команды, которые mbuild в противном случае выполнил бы, но на самом деле не выполнил бы ни один из них.

-O

Оптимизируйте объектный код. Оптимизация включена по умолчанию и путем включения этой опции в командную строку. Если на -g опция появляется без -O опция, оптимизация отключена.

-outdir <dirname>

Поместите все выходные файлы в папку <dirname>.

-output <resultname>

Создайте исполняемый файл с именем <resultname>. Соответствующее исполняемое расширение автоматически добавляется. Переопределяет mbuild исполняемый механизм именования по умолчанию.

-setup

В интерактивном режиме укажите файл опций компилятора C/C + +, который будет использоваться по умолчанию для будущих вызовов mbuild путем размещения его в папке профиля пользователя (возвращается prefdir команда). Когда эта опция задана, другой вход командной строки не принимается.

-setup -client mbuild_com

В интерактивном режиме укажите файл опций компилятора COM, который будет использоваться по умолчанию для будущих вызовов mbuild путем размещения его в папке профиля пользователя (возвращается prefdir команда). Когда эта опция задана, другой вход командной строки не принимается.

-U<name>

Удалите любое начальное определение символа препроцессора C <name>. (Обратная -D опция.)

-v

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

<name>=<value>

Дополните или переопределите переменную файла опций для переменной <name>. Эта опция обрабатывается после обработки файла опций и рассмотрения всех аргументов командной строки. Возможно, вам потребуется использовать синтаксис кавычек интерпретатора для защиты таких символов, как пространства, которые имеют значение в синтаксисе интерпретатора. В Windows используются двойные кавычки (например COMPFLAGS="opt1 opt2"), и в UNIX используются одинарные кавычки (например, CFLAGS='opt1 opt2').

Обычно эта опция используется для дополнения уже определенной переменной. Для этого обратитесь к переменной путем подготовки $ (например, COMPFLAGS="$COMPFLAGS opt2" в Windows или CFLAGS='$CFLAGS opt2' на интерпретаторе UNIX).

Для компилятора MinGW-w64, который основан на gcc/g + +, используйте одинарные кавычки (').

Примеры

Чтобы изменить компилятор C/C + + по умолчанию для использования с MATLAB Compiler SDK™, используйте

mbuild -setup

Чтобы скомпилировать и связать внешнюю программу на C foo.c против libfoo, использование

mbuild foo.c -L. -lfoo (on UNIX)
mbuild foo.c libfoo.lib (on Windows)

Это принимает оба foo.c и библиотека, сгенерированная выше, находится в текущей рабочей папке.

Представлено до R2006a