Создание макропрограмм
Макропрограммы системы K3 представляют собой последовательность команд и операторов языка системы, записанную в текстовый файл. Этот файл может создаваться любым текстовым редактором, в том числе и встроенным в систему текстовым редактором.
Каждая команда системы описывается своим ключевым словом и списком параметров, который может за ним следовать. Например, команда «Создать точку с координатами {18,20,30}» будет выглядеть следующим образом:
point 18,20,30 done;
где point
— ключевое слово, а остальной текст описывает конкретные параметры данной команды.
Каждая команда может быть набрана не полностью, а только несколько первых символов. Количество этих символов зависит от конкретной команды. Например, вместо команды point можно набрать p, po, poi и т.д. Однако в макропрограммах рекомендуется использовать полное название команды.
Прописные и строчные буквы в именах команд, функций, массивов и переменных равнозначны.
Каждая команда должна завершаться символом «;» (точка с запятой).
Кроме команд системы в тексте макропрограммы можно использовать операторы макроязыка, такие как:
- Оператор присваивания;
- Условный оператор;
- Оператор перехода;
- Оператор вызова подпрограммы;
- Оператор выхода в вызывающую макропрограмму;
- Оператор выхода в интерактивный режим.
При описании будут использованы следующие типографские соглашения:
|
Используется для обычного текста описания |
|
Используется для выделения отдельных фрагментов описания, названия пунктов меню, клавиш и пр., а также описываемой команды или функции. |
Полужирный шрифт в блоке |
Указывает, что это имя функции или команды K3 (Например: |
Обычный шрифт |
Используется для описания стандартных ключей K3, а также имен команд и функций в тексте описания. |
ЗАГЛАВНЫЕ БУКВЫ в блоке |
Используются для условного обозначения типа данных входного параметра или результата, возвращаемого функций. В качестве типа используются следующие условные обозначения:
|
|
Используется для описания примеров. |
|
Используется в тексте примеров для обозначения результата, возвращаемого функцией, который она выдает в окно диалога. Вывод результата в окно диалога является удобным средством для изучения поведения функции или выражения. Для этого перед выражением необходимо поставить знак присваивания "=". |
|
Используется для выделения команд и функций для быстрого поиска |
|
Используется для примечаний и фрагментов, на которые необходимо обратить внимание. |
Дополнительно к этому через вертикальную черту (|) перечислены возможные альтернативы. В угловых скобках (<>) указаны параметры команды или функции. Фигурные скобки ({}) в описании команд (не в примерах) служат для группировки элементов. Квадратные скобки ([]) служат для обозначения необязательных параметров и/или ключевых слов.
Например
colorpicture [rend] <VPort> {yes | no}
следует читать так. Команда colorpicture
требует указания параметра <VPort>
, перед которым может стоять (а может и не стоять) необязательный ключ rend
. После указания следует ввести одно из двух ключевых слов yes
или no
, но не оба сразу и не упуская хотя бы одного из них.