Синтаксис команд

Управление работой программы Fidesys осуществляется или с помощью ввода команд в командной строке, или посредством чтения их из журнального файла. Ниже приводятся общие правила, принятые для синтаксиса команд. Быструю справку о формате определенной команды можно получить, введя в командной строке:

help <имя_команды>

Более подробная информация содержится в подразделе Справка по командной строке.

Одним из примеров команд Fidesys (все они описываются в настоящем Руководстве пользователя) является следующая:

volume <значение> scheme sweep [source [surface] <значение>] [target [surface] <значение>] [rotate {on | OFF}]

Команды, воспринимаемые Fidesys, имеют свободный формат, но следуют ряду правил:

Регистр не имеет значения.
Символ "#" в любой строке команд означает комментарий. Сам этот символ и следующие за ним в данной строке при выполнении команды игнорируются. Следует однако заметить, что символ "#" может использоваться для указания начала оператора на языке APREPRO.
Название команды может быть сокращено до минимального числа символов, отличающих ее от других команд.
Значения параметров, вводимые в команде, зависят от типов параметров. Ниже приведены некоторые типы параметров и соответствующие им значения:

numeric - численный параметр, который может выражаться действительным или целым числом. Действительное число может быть задано в любом принятом в языках C или FORTRAN формате (например, 1, 0.2, -1e-2). Целочисленный параметр может быть задан в разрешенном десятичном формате (например, 1, 100, 1000, но не 1.5, 1.0, 0x1F).

string - строковый параметр, строка символов, заключенных в одинарные или двойные кавычки (например, 'Это - строка').

filename - имя файла; оно должно быть заключено в одинарные или двойные кавычки. Если путь к файлу не указан, предполагается, что он находится в текущей рабочей директории. После задания части имени файла можно поставить '?' - в этом случае программа дополнит имя автоматически или приведет список всех имеющихся файлов, имена которых включают такой набор символов.

Имя файла может быть также задано с указанием относительного пути (..\cubit\mesh.jou) или полного пути (C:\USER\cubit\mesh.jou) (см. подраздел Команды управления работой программы.) Для задания имени файла возможно использование переменных среды.

toggle - указатель-переключатель для включения или выключения какой-либо настройки (опции). Допустимые значения для включения: on, yes и true; для выключения - off, no и false.

Обычно в написании команды - в качестве первого варианта - присутствует ключевое слово, означающее действие, или глагол с последующим набором переменных (параметров), например:

mesh volume 1

Здесь mesh - это действие, а volume 1 - параметр.

Другим вариантом является присутствие в команде ключевого слова - переключателя или существительного, обозначающего объект, за которыми следует имя и атрибуты указанного объекта, например:

volume 1 scheme sweep source 1 target 2

Здесь volume 1 - это объект, scheme - атрибут, а остальные данные представляют собой параметры для ключевого слова scheme.

При описании команд в настоящем Руководстве применяются следующие правила:

Команда и все ее параметры выделяются жирным шрифтом (см. выше).
Слово, заключенное в угловые скобки (<parameter>), означает параметр, задаваемый пользователем. Его значение может быть целым числом, диапазоном целых чисел, действительным числом, строкой символов, в том числе именем файла, или переключателем (см. выше). Подходящий тип значений параметра понятен из самой команды или ее описания.
Набор слов, разделенных вертикальной чертой (choice1 | choice2 | choice3) означает возможность выбора между перечисленными параметрами.
Значение переключателя, указанное ПРОПИСНЫМИ СИМВОЛАМИ, соответствует установке (настройке), принятой по умолчанию.
Слово, приведенное без скобок или заключенное в фигурные скобки ({required}), означает требуемый ввод данных.
Слово, заключенное в квадратные скобки (например, [options] или [опции]), означает возможность ввода необязательных параметров. Они могут вводиться с целью изменения действия команды, принятого по умолчанию.
Фигурные скобки внутри квадратных (например, [rotate {on | OFF}]) необходимы при указании используемой опции.