O

СОДЕРЖАНИЕ

• НАЗВАНИЕ
• СИНТАКСИС
• ОПИСАНИЕ
• СОГЛАШЕНИЯ
• РЕАЛИЗАЦИЯ
• ОШИБКИ
• АВТОР

НАЗВАНИЕ

O — Общий интерфейс для бэкендов Perl-компилятора

СИНТАКСИС

perl -MO=[-q,]Backend[,OPTIONS] foo.pl

ОПИСАНИЕ

Этот модуль используется как фронтенд для Perl-компилятора.

Если вы передадите опцию -q модулю, то файловый дескриптор STDOUT будет перенаправлен в переменную $O::BEGIN_output во время компиляции. Это означает, что любой вывод в STDOUT, созданный блоками BEGIN или используемыми модулями, будет сохранён в этой переменной, а не выведен. Это полезно для тех бэкендов, которые сами производят вывод (Deparse, Concise и т. д.), чтобы их вывод не смешивался с выводом компилируемого кода.

Опция -qq ведет себя как опция -q, за исключением того, что она также закрывает STDERR после завершения распарсивания. Это подавляет сообщение «Синтаксис OK», обычно генерируемое perl.

СОГЛАШЕНИЯ

Большинство бэкендов компилятора используют следующие соглашения: OPTIONS состоит из списка слов, разделённых запятыми (без пробелов). Опция -v обычно переводит бэкенд в режим подробной информации. Опция -ofile генерирует вывод в файл file вместо stdout. Опция -D в сочетании с различными буквами включает различные внутренние флаги отладки. См. документацию для нужного бэкенда (названного B::Backend в примере выше), чтобы узнать о нём подробнее.

РЕАЛИЗАЦИЯ

Этот раздел необходим только тем, кто хочет написать модуль бэкенда компилятора, который можно использовать через этот модуль.

Команда, упомянутая в разделе СИНТАКСИС, соответствует Perl-коду

use O ("Backend", OPTIONS);

Функция O::import загружает соответствующий модуль B::Backend и вызывает его функцию compile, передавая ей OPTIONS. От этой функции ожидается возврат ссылки на подпрограмму, которую мы назовём CALLBACK. Затем включается флаг «только компиляция» (эквивалентный командной строке -c) и регистрируется блок CHECK, который вызывает CALLBACK. Таким образом, основная программа Perl, упомянутая в командной строке, считывается, разбирается и компилируется во внутреннее представление синтаксического дерева. Поскольку установлен флаг -c, программа не начинает выполняться (за исключением блоков BEGIN, конечно), но вызывается функция обратного вызова, зарегистрированная бэкендом компилятора.

Подводя итог, модуль бэкенда компилятора должен называться "B::Foo" для некоторого foo и находиться в соответствующей директории для этого имени. Он должен определять функцию, называемую compile. Когда пользователь вводит

perl -MO=Foo,OPTIONS foo.pl

вызывается эта функция и получает эти OPTIONS (разделённые запятыми). Она должна вернуть ссылку на подпрограмму для основной функции компиляции. После загрузки и разбора программы пользователя эта возвращённая ссылка на подпрограмму вызывается, что позволяет ей выполнить компиляцию, обычно используя функциональность модуля B.

ОШИБКИ

Опции -q и -qq не работают правильно, если perl не скомпилирован с поддержкой PerlIO: STDOUT будет закрыт вместо перенаправления в $O::BEGIN_output.

АВТОР

Malcolm Beattie, mbeattie@sable.ox.ac.uk