03-ACL Первые-команды. Язык программирования. Виктор Кон

3. ПЕРВЫЕ КОМАНДЫ

Начнем описание команд по принципу -- сначала самые важные и простые, затем все остальное. Прежде всего есть пустая команда #parameters или сокращенно #p. Она сама ничего не делает, но, как и для любой другой команды, после нее можно писать поле определения параметров (FPD). И как раз для этих целей она и используется. Иногда это бывает удобно. Итак

 #p [n=1; b=1; le=1; c=1; ...]

Здесь для примера указаны некоторые часто используемые параметры [n] number, [b] begin, [le] length, [c] code. Каждая команда использует свои параметры и они будут указываться по ходу описания команд. Полная таблица всех команд и параметров дана в 24-й главе. Далее, есть команда окончания работы программы

 #stop

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

 #exit

позволяющая полностью выйти из Java программы интерпретатора, которая обеспечивает работу ACL программы в независимом варианте. Она необходима только при запуске интерпретатора с полностью готовой ACL-программой, когда среда разработки ACL-программ не используется совсем. Это позволяет представить ACL-программу как независимую Java программу, при использовании которой знание языка ACL не требуется. Начинающим программистам этой командой лучше не пользоваться. Далее, в языке есть описания процедуры

 #pro NAME  <здесь помещаются все другие команды> @

Символ [@] служит окончанием процедуры (жирная точка). Имя процедуры NAME является первым аргументом такой команды. Оно должно содержать 4 знака в любой комбинации. Любой кусок программы можно предварительно поместить в тело процедуры, и он при этом не выполняется, а запоминается. Тело процедуры и символ окончания [@] можно рассматривать как остальные аргументы команды. Код в теле процедуры будет выполнен позже, при вызове процедуры. Порядок записи на строке не имеет значения. Как удобно, так и записываете. Процедуры выполняются с помощью специальной команды, которая должна, естественно, быть поставлена после определения процедуры

 #e [c=1;] NAM1 NAM2 NAM3  #%

Эта команда как раз выполняет (execute) процедуры одну за другой из указанного списка. Если у команды #pro есть только аргументы: [NAME] и сама процедура, то у команды #e кроме аргументов есть уже и параметр с именем [c] (code), значение которому можно присвоить прямо тут же, в FPD, а можно и раньше. Все процедуры выполняются только в том случае, если значение параметра [code] совпадает с текущим значением переменной [&]. Эта переменная должна быть определена заранее. Но если написать

 #e [c=&;] NAME  #%

то процедура всегда выполнится при любом значении [&]. Для сокращения записи, то же самое можно написать как

 #e _NAME  #%

Символ подчеркивания перед первым именем в списке процедур означает безусловное выполнение. Важно помнить, что [c] -- это целое число, а [&] - это вещественная переменная, поэтому для сравнения берется ее ближайшее целое.

Эта команда реально имеет очень большое значение, потому что используется часто и не только с процедурами, записанными явно. Есть два специальных режима работы этой команды, необходимые для написания особенно сложных программ. Специальные имена процедур [file] и [text] служат для выполнения команд программы из файла или из текстового массива t(). Пример:

 #e [file=pro/calcul.acl;] _file

Эта команда выполнит набор команд ACL, записанных в файл "calcul.acl", помещенный в папку "pro" внутри главной папки интерпретатора. Интерпретатор первоначально был сделан так, что он не работал с внешними папками, а работал только с папками внутри "своей" папки, то есть папки, в которой находится сам интерпретатор, то есть файл (vkACL.jar). Папка -- это место, где хранятся файлы, другое ее название -- Директория -- использовалось в ДОСе, и иногда продолжает использоваться, а я перешел на оконный язык. Здесь уже используется второй текстовый параметр [file] для указания пути к файлу. В этой команде путь к файлу указывается полный, то есть относительно папки интерпретатора. Это необходимо по той причине, что имя текущей рабочей папки может использоваться для других файлов. С другой стороны, иногда полезно держать все файлы с процедурами в одном месте независимо от прикладной программы. Процедуры, помещенные в файлы, могут быть относительно универсальными и могут использоваться многими программами. Поэтому они должны удовлетворять некоторым ограничениям поскольку интерпретатор использует одни и те же ресурсы для всех программ. Но можно и просто поместить в файл любой кусок программы и затем выполнить его.

В процессе развития программы я отказался от локализации файлов внутри папки интерпретатора во многих командах работы с файлами, в том числе и в этой команде. Если полный путь к файлу будет начинаться так C:/... или так D:/... , то есть буква диска, двоеточие и так далее, то команда будет работать, но в этой команде осталось ограничение имени файла 42 символами, а конструкция file=arg; не работает. То есть надо стараться не использовать папки с длинными именами. Еще более сложная команда

 #e [b=a; le=b;] _text

выполняет команды, динамически записанные в часть текстового массива t(), начиная c элемента t(a) и длиной b символов. Понятие строки текста в ACL не существует. Любая строка, как известно, состоит из набора символов и имеет имя и длину. Значения числовых параметров [b] (begin) и [le] (length) можно рассматривать как имя и длину строки. Просто в ACL в качестве имени строки используется число, которое указывает начало размещения символов строки в текстовом массиве. Этого вполне достаточно. Программа, которую выполняет данная команда, исходно не существует, поэтому ее надо предварительно записать. Естественно и параметр [c] тоже можно использовать в обоих случаях. Записанный вариант безусловного исполнения просто короче.

Наконец, нужно отметить еще одно важное свойство этой команды. Она читает имена процедур для выполнения неограниченно, пока не встретит символ [ #] или символ [@], означающие начало новой команды или окончание процедуры. Исключение составляют только специальные имена file и text. Ни до, ни после них никакие другие процедуры не выполняются. Поэтому они не могут быть в цепочке. Если после команды необходимо вставить текст комментария или данная команда является последней в файле, то после нее можно поставить любую другую команду с фиксированной длиной. Самой короткой командой является #% поэтому проще всего использовать эту команду. Но для сокращения записи то же самое делает символ ( ! ) восклицательного знака. Если этого не сделать, то интерпретатор выдаст ошибку несуществующей процедуры.

Так как процедуру из файла нельзя ставить в цепочку, то надо следить за тем, чтобы обычная процедура в цепочке не содержала вызов супекоманды. Они описанны в главе 27. Потому что в этом случае такую процедуру тоже нельзя ставить в цепочку. Ведь суперкоманды -- это тоже процедуры из файла. В любом случае, если вдруг программа неадекватно работает, надо расцепллять цепочки процедур.

Как это очевидно из сказанного, сначала надо определить все процедуры, а потом писать текст основной программы. Иногда это бывает неудобно, так как приходится начинать изучение программы с конца файла. Но можно использовать простой прием. Основной текст программы тоже поместить в процедуру

 #pro main ... @

Теперь уже можно писать любые процедуры в любом порядке, а в конце программы написать стандартную строку

 #e _main   #stop  или   #e _main  #%