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 в примере выше), чтобы узнать о нём.

РЕАЛИЗАЦИЯ

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

Команда, упомянутая в разделе SYNOPSIS, соответствует следующему Perl-коду

use O ("Backend", OPTIONS);

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

Подводя итог, модуль бэкенда компилятора должен называться "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