6. Утилита mxxc

Утилита командной строки mxxc является интерпритатором и средой исполнения для языка M++.

Формат вызова:

mxxc [<arg> [<arg> [...]]] [@<resp-file> [@<resp-file> [...]]]

Если существует переменная среды MXX4, то указанные в ней аргументы разбираются перед началом разбора командной строки. В переменной среды MXX4 можно указывать только аргументы -d, -u, -i;

Если указываются response-файлы, то их содержимое обрабатывается после разбора командной строки. В response-файлах можно указывать любые аргументы за исключением имен response-файлов.

Если не задан аргумент -api, то в аргументах должно быть указано имя файла с программой M++. Если имя файла не указано, то mxxc проверяет наличие в текущем каталоге файла с именем default.4xx. Если такой файл существует, то mxxc выполняет содержащуюся в нем программу. Если в текущем каталоге нет файла default.4xx, то mxxc выдает на стандартный поток вывода короткую справку о текущей версии и аргументах mxxc. Получить такую же справку можно указав в командной строке один из агрументов: -?, -h, -help, --help.

Аргументы mxxc, указываемые в переменной среды MXX4, командной строке и response-файлах должны следовать следующим правилам:

• аргумент начинается со знака дефиса ("-");
• если аргумент должен получать значение (например, -d, -u, -i, -f), то значение должно быть отделено от имени аргумента пробелом (табуляцией или символом новой строки). Например, -f myfile.4xx;
• если значение аргумента содежит пробелы, то:
  • если аргумент указывается в командной строке, то значение аргумента должно быть оформлено в соответствии с правилами оформления подобных значений в текущей операционной системе. Например, в операционных системах Windows, OS/2 и UNIX такие значения заключаются в двойные кавычки. Если значение так же содержит символы двойных кавычек, то эти символы должны предваряться символом обратной косой - '\"'; Пример:
    mxxc -f "c:\program files\my prj\myfile.4xx"
  • если аргумент указывается в response-файле, то значение аргумента должно быть заключено в двойные кавычки. Если значение так же содержит символы двойных кавычек, то эти символы должны предваряться символом обратной косой - '\"'. Если значение содержит символы обратной косой (которая используется как разделитель имен каталогов на платформах Windows и OS/2), то каждый такой символ должен предваряться обратной косой чертой. Если значение не помещается на одной строке, то его можно продолжить на другой строке, если последним символом строки поставить символ обратной косой черты. Пример:
    -f "c:\\program files\\my prj\\myfile.4xx"
    -i "c:\\program files\\my prj\\mxxc standard \
    include files"
  Если значение аргумента, содержащее пробелы не оформить подобным образом, то часть значения после первого пробела будет рассматриваться как агумент;
• порядок следования аргументов не имеет значения;
• если аргумент может указыватся несколько раз (-d, -u, -i), то порядок обработки его значений будет определяться порядком указания аргумента. Например, если в переменной MXX4 будет указано -d MSC, в командной строке будет указано -d RELEASE, а в response-файле - -d NOBUILD, то это означает, что сначала будет определен символ MSC, затем RELEASE, а затем NOBUILD.

Формат: -a <name> <value>

Задает скалярное значение аргументу с именем <name>. Получить это значение можно из mxx-кода при помощи функций mxxc_arg, mxxc_arg_as_array, mxxc_arg_names.

Формат: -aa <name> <value>

Добавляет еще одно скалярное значение аргументу-вектору с именем <name>. Получить это значение можно из mxx-кода при помощи функций mxxc_arg, mxxc_arg_as_array, mxxc_arg_names.

Формат: -api

Предписывает отобразить на стандартный поток вывода список всех функций M++ API реализованных в данной версии mxxc. Для каждой функции отображается краткое описание.

После выдачи описания функций M++ API утилита mxxc завершает свою работу. Поэтому не имеет смысла использовать этот аргумент совместно с другими аргументами.

Формат: -c

Предписывает только скомпилировать M++ программу, но не выполнять ее. Основное назначение данного ключа - проверка синтаксической правильности программ.

Формат: -d <id>[=[<value>]]

Определяет символ препроцессора id. Имя символа препроцессора должно быть уникальным (т.е. символа препроцессора с таким именем быть не должно). Если указано значение value, то это значение будет присвоено этому символу препроцессора.

Не должно быть пробелов между идентификатором и знаком =. Если указан только знак равенства, но без значения (-d id=), то будет создан символ препроцессора с пустым значением (что эквивалентно -d id).

Можно указывать произвольное количество аргументов -d.

Формат: -i <path>

Добавляет указанный path к списку путей к стандартным подключаемым файлам.

Можно указывать произвольное количество аргументов -i.

Формат: -pre

Предписывает выдать результат обработки программы препроцессором на стандартный поток вывода. После этого утилита mxxc завершает свою работу.

Формат: -sf <filename>

Аналогичен параметру -f, но указанный файл ищется в путях стандартных подключаемых файлов.

Формат: -u <id>

Удаляет символ препроцессора id. Отсутствие указаного символа ошибкой не считается.

Можно указывать произвольное количество аргументов -u.

Аргументы -u обрабатываются перед тем, как будут обработаны аргументы -d.