Описание среды компилятора AmigaE 3.3a

Вводная (для интриги)
Описание редактора EE
Определение закладок (folding)
Функция автодополнения и файл окончаний
Примеры программ на языке E для AmigaOS

Из руководства к компилятору AmigaЕ:

E - объектно-ориентированный, процедурный, высокоуровневый язык программирования, во многом схожий с языками Си++, Ада, Лисп и другими. Являясь языком общего назначения, в своей реализации на Ammy, основной упор сделан на разработку приложений.

Возможности поддержки языка компилятором, включают в себя:

Скорость компиляции более 20000 строк в минуту на "голой" A500, включаемый ассемблер и линковщик интегрированы в компилятор, большой набор встроенных функций, великолепная концепция модулей, реализованная во вложениях v39, гибкая система типов, наследование, методы, обработка прерываний (в контексте компилятора), выделение регистров, быстрая работа с памятью, унификация, Лисп-ячейки, средства разработки графического интерфейса, (макро-) препроцессор, гибкий и мощный отладчик на уровне исходника, легкая линковка библиотек и многое другое...

Если говорить проще - среди высокоуровневых языков на Ammy, альтернативы E, по возможностям (см. ниже), по скорости компиляции (виииуууу...), по простоте, нет и не будет, если конечно язык будет развиваться! Дело доходит до комизма, автор в прилагаемой документации утверждал, что компилятор AmigaЕ не поддерживает многомерные массивы, и тут же выходит модуль от преданного пользователя компилятора, для обхода этого недоразумения!

Это показывает уровень гибкости языка... Требования к железу минимальны - голой A1200 с винтом хватит по уши! Любой проект будет Вам по плечу! Е вобрал в себя все лучшее, что было в языках программирования. Смотрите сами: Вывод "Hello, World!" в CLI-окно 1000 раз, дана соответствующая информация о компиляторе, длине полученного кода и скорости выполнения...

По материалaм гайда "Comparison of programming languages" by Frank Reibold. Как Вы сами можете видеть по размеру генерируемого кода, компилятор AmigaЕ - абсолютный рекордсмен, да и по скорости не на последнем месте!

Для того, чтобы подогреть Ваш интерес, далее по тексту будет дано описание редактора ЕЕ (версия 0.9.2 beta), и его настроек (крайне простых), чтобы Вы могли во всеоружии начать программировать на E! ;-)

И еще несколько примеров на растерзание!

Как обычно - Hello World и еще несколько, посложнее!

Главное меню редактора

Project (работа над проектами)

Edit (редактирование проекта)

Find (операции поиска)

Settings (установки)

Tools (инструментарий)

Settings/Edit Prefs.../Commands... (определение вспомогательных команд)

Пример определения вспомогательных команд

Settings/Edit Prefs.../Compiler... (определение настроек компилятора)

• Command - поле содержащее строку вызова компилятора с аргументами;

• Auto-Save - автоматическое сохранение перед компиляцией;

• Report Unreferenced - вывод сообщения, если есть ссылки на неопределенные переменные.

Пример определения настроек компилятора

Settings/Edit Prefs.../Global Settings... (глобальные установки среды редактора EE)

Checked Settings... - триггерные установки:
• FG<->BG - инвертирование цвета тона/фона окна редактора;
• Bottom Scroller - определяет наличие нижнего скроллера;
• Find Case Sensitive - переключатель определяющий имеет ли значение регистр букв при поиске;
• Insert Mode - вкл/выкл режим вставки;
• Backup Project - cоздаёт резервную копию с добавлением расширения .bak;
• No Fold When Loading - отключение закладок при загрузке.
• Free-Form Cursor - в выключенном состоянии возможно только построчное редактирование;
• Fast File Loading - быстрая загрузка файла (требуется больше памяти);
• Justify New Line - "умный" отступ при создании новой строки.

Пример определения триггерных настроек

Public Screen... - установки общего экрана:
• Public Screen Name - имя общего экрана для New или Visit;
• New - создать новый экран;
• Visit - перейти на экран указанный в Public Screen;
• Fallback - вывод на экран Workbench, при условии что предыдущие опции не сработали
• Default - вкл/выкл использования общего экрана для редактора EE;
• Shanghai - вкл/выкл открытие всех окон на экране редактора EE.

Пример определения настроек общего экрана

Miscellanous... - установки общего назначения:
• Indent - ширина отступа;
• Tab - табуляция;
• Fold Extra Lines - установка числа пустых строк для закладки при обработке операторов ENDPROC и ENDOBJECT;
• Window - координаты левого-верхнего угла и размеры окна редактора EE;
• Console Spec - конфигурирование окна вывода сообщений;
• Font - установка выбранного шрифта;
• Completions - путь к файлу окончаний.

Пример определения настроек общего назначения

Settings/Edit Prefs.../Key Assignments... (присвоение "горячих" клавиш)

Пример присвоения "горячих" клавиш

Settings/Edit Prefs.../Menu Command Hotkeys... - переопределение "горячих" клавиш в системе меню редактора.

Settings/Macros/Begin Recording... - начать определение макроса.

Settings/Macros/End Recording - закончить определение макроса.

Settings/Macros/Cancel Macro - прервать определение макроса.

Settings/Macros/Delete... - удалить существующий макрос.

Settings/Macros/Save... - сохранить определённые макросы.

Settings/Macros/Load... - загрузить определения макросов.

Settings/Macros/Clear... - очистить список определённых макросов.

Settings/Edit Command/1... - определение первой вспомогательной команды.

Settings/Edit Command/2... - определение второй вспомогательной команды.

Settings/Edit Command/3... - определение третьей вспомогательной команды.

Settings/Edit Command/4... - определение четвёртой вспомогательной команды.

Settings/Edit Command/4... - определение пятой вспомогательной команды.

Settings/Edit Command/Compiler... - определение строки вызова компилятора и его аргументов.

Закладки служат для улучшения удобочитаемости Ваших программ, путём сворачивания программных блоков. Это очень удобно при объектно-ориентированном и процедурном подходах в программировании. Для определения закладок (fold) служит опция "Fold/Unfold" из меню "Tools" ("RAmiga+h", по умолчанию). Если вы хотите пользоваться закладками, убедитесь сначала в том, что опция "No Fold When Loading" из меню "Settimgs" не активирована. В противном случае определяемые закладки не будут запоминаться в сохраняемых проектах.

Существует два способа определения границ закладки:

1. По выделенному тексту;
2. Начиная с текущей строки до первого встреченного оператора "конца закладки" ("->endfold").

Механизм действия закладок:

• Если текущая строка начинается с оператора "OBJECT" или "EXPORT OBJECT", текст свертывается до первого встреченного оператора "ENDOBJECT" или до конца текста;

• Если текущая строка начинается с оператора "PROC" или "EXPORT PROC", текст свертывается до первого встреченного оператора "ENDPROC", или до конца текста;

• Текст Вашей программы может сворачиваться с текущей строки до первого встреченного оператора "->endfold" или до конца текста.

Обратите внимание на точность написания оператора "конца закладки!"

Установленная закладка выглядит как строка с парой символов ">>" в начале. Закладка не может быть скопирована, она может быть только перенесена (Cut & Paste). Вложенность закладок никак не ограничена. Сама закладка будет храниться в виде комментария, в конце файла содержащего исходный текст Вашей программы - следовательно, не будет мешать при просмотре исходника другими средствами. В случае повреждения этой информации, используйте опцию "No Fold When Loading" из меню "Settings" - это позволит редактору EE нормально загрузить исходник.

Автодополнение (complete) - удобная функция позволяющая Вам не тратить время на ввод программных блоков, наиболее часто используемых в Ваших программах. Для вызова автодополнения используется опция "Complete" из меню "Tools" ("RAmiga+/", по умолчанию). При этом происходит поиск окончания для выделенного блока текста в файле окончаний. В случае, когда окончание для выделенного блока текста было найдено - происходит замена этого блока на блок найденный в файле окончаний. В противном случае, текст Вашей программы останется неизменным.

Например: Вы выделили строку "rand" в Вашей программе, нажали комбинацию клавиш "RAmiga+/" и эта строка дополнилась до: "randnum:=Rnd(max)" - присвоение переменной randnum случайного значения. Удобно использовать автодополнение для завершения путей к ресурсам, библиотекам и т.д. подключаемым в Ваших программах. Вы можете и сами придумать подходящие применения для этой функции.

Файл окончаний (CompletionFiles) хранится в директории "prefs" и может быть отредактирован в любом имеющемся у Вас текстовом редакторе (включая EE).

Пример 1:

/* Самый занудный пример */

PROC main()
   WriteF('Hello, World!\n')
ENDPROC

Пример 2:

/* Получение аргументов из командной строки. Здесь, arg - специально 
 * зарезервированная для этих целей переменная языка E.
 */
 
PROC main()
   WriteF( IF arg[]=0 THEN 'No Args!\n' ELSE 'You wrote: \s\n', arg )
ENDPROC

Пример 3:

/* Отображение окна на общий экран (по умолчанию - экран Workbench) */
 
MODULE  'intuition/intuition'                 -> Нам понадобится модуль intuition.m

ENUM ERR_NONE, ERR_WIN, ERR_KICK, ERR_PUB     -> Определяем константы путём перечисления

RAISE ERR_WIN  IF OpenWindowTagList()=NIL,    -> "Лов" исключений: окно не
      ERR_PUB  IF LockPubScreen()=NIL         -> открылось или сорвался захват...

/* Открываем простое окно и ждём когда пользователь захочет его закрыть. */

PROC main() HANDLE                            -> Процедура содержит обработчик исключений
   DEF test_window=NIL, test_screen=NIL       -> Объявление переменных для структур
   IF KickVersion(37)=FALSE THEN ERR_KICK     -> Генерируем ошибку для старых кикстартов
   
   test_screen := LockPubScreen('Workbench')  ->  Захват стандартного экрана
   test_screen := OpenWindowTagList(NIL,      ->               Открытие окна
                                   [WA_LEFT, 0, WA_TOP, 11,
                                    WA_WIDTH, 640, WA_HEIGHT, 30,
                                    WA_DRAGBAR, TRUE,
                                    WA_CLOSEGADGET, TRUE,
                                    WA_SMARTREFRESH, TRUE,
                                    WA_CAREREFRESH, TRUE,
                                    WA_DEPTHGADGET, TRUE,
                                    WA_IDCMP, IDCMP_CLOSEWINDOW,
                                    WA_TITLE, 'Window Title',
                                    WA_PUBSCREEN, test_screen,
                                    NIL])
									
   UnlockPubScreen(NIL, test_screen)          -> Отдаём системе захваченный экран
   test_screen := NIL                         -> Обнуляем указатель
   handle_window_events(test_window)          -> Ожидание системного события

   EXCEPT DO
      IF test_window THEN CloseWindow(test_window)
      IF test_screen THEN UnlockPubScreen(NIL, test_screen)
         SELECT exception                     -> Вывод сообщений об ошибках
            CASE ERR_KICK; WriteF('Error: Needs Kickstart V37+\n')
            CASE ERR_PUB;  WriteF('Error: Could not lock public screen\n')
            CASE ERR_WIN;  WriteF('Error: Failed to open window\n')
         ENDSELECT
ENDPROC

/* Процедура ожидания события */

PROC handle_window_events(win)
   REPEAT
   UNTIL WaitIMessage(win)=IDCMP_CLOSEWINDOW
ENDPROC

MindEngine; Copyright 2003