xsubpp

СОДЕРЖАНИЕ

• ИМЯ
• СИНТАКСИС
• ОПИСАНИЕ
• ПАРАМЕТРЫ
• ОКРУЖЕНИЕ
• АВТОР
• ИСТОРИЯ ИЗМЕНЕНИЙ
• СМОТРИТЕ ТАКЖЕ

ИМЯ

xsubpp - компилятор для преобразования кода Perl XS в код C

СИНТАКСИС

xsubpp [-v] [-except] [-s pattern] [-prototypes] [-noversioncheck] [-nolinenumbers] [-nooptimize] [-typemap typemap] [-output filename]... file.xs

ОПИСАНИЕ

Этот компилятор обычно запускается make-файлами, созданными ExtUtils::MakeMaker или Module::Build, или другими инструментами для сборки модулей Perl.

xsubpp компилирует XS-код в C-код, встраивая конструкции, необходимые для того, чтобы C-функции могли манипулировать значениями Perl, и создаёт связующий код, необходимый для доступа к этим функциям из Perl. Компилятор использует typemaps для определения того, как сопоставить параметры и переменные C-функций со значениями Perl.

Компилятор будет искать файлы typemap, называемые typemap. Он будет использовать следующую цепочку поиска для нахождения стандартных typemap, причём typemap справа имеет больший приоритет.

../../../typemap:../../typemap:../typemap:typemap

Также будет использоваться стандартный typemap, установленный как ExtUtils::typemap.

ПАРАМЕТРЫ

Обратите внимание, что параметр XSOPT MakeMaker может использоваться для добавления этих параметров в любые make-файлы, сгенерированные MakeMaker.

-hiertype

Сохраняет '::' в именах типов, чтобы можно было сопоставить иерархические типы C++.

-except

Добавляет заглушки обработки исключений в код C.

-typemap typemap

Указывает, что пользовательский typemap должен иметь приоритет над стандартными typemap. Этот параметр может использоваться несколько раз, причём последний typemap имеет наивысший приоритет.

-output filename

Указывает имя выходного файла. Если файл не указан, вывод будет записан в стандартный вывод.

-v

Выводит номер версии xsubpp в стандартный вывод и завершает работу.

-prototypes

По умолчанию xsubpp не будет автоматически генерировать прототипы кода для всех xsubs. Этот флаг включит генерацию прототипов.

-noversioncheck

Отключает проверку, которая определяет, имеют ли файл объекта (полученный из файла .xs) и файлы .pm один и тот же номер версии.

-nolinenumbers

Препятствует включению директив '#line' в выходной файл.

-nooptimize

Отключает некоторые оптимизации. Единственная оптимизация, на которую в настоящее время влияет, — это использование target-ов в выходном C-коде (см. perlguts). Это может значительно замедлить сгенерированный код, но так работал xsubpp версии 5.005 и более ранних.

-noinout

Отключить распознавание объявлений IN, OUT_LIST и INOUT_LIST.

-noargtypes

Отключить распознавание описаний сигнатур функций в стиле ANSI.

-C++

В настоящее время ничего не делает. Этот флаг не выполнял никаких действий в течение многих версий perl, по крайней мере, до perl5.003_07. Он включён для обратной совместимости.

-s=... или -strip=...

Этот параметр устарел и не рекомендуется.

Если указано, данная строка будет удалена из начала имени C-функции в сгенерированных XS-функциях (если имя начинается с этого префикса). Это относится только к XSUB-ам без блоков CODE или PPCODE. Например, XS:

void foo_bar(int i);

при вызове xsubpp с -s foo_ установит функцию foo_bar в Perl, но на самом деле вызовет bar(i) в C. В большинстве случаев это обратное тому, что нужно, а режимы сбоев несколько запутанны, поэтому старайтесь избегать этого параметра, если это возможно.

ОКРУЖЕНИЕ

Переменные окружения не используются.

АВТОР

Изначально Лари Уолл. Преобразован в модуль ExtUtils::ParseXS Кен Уильямсом.

ИСТОРИЯ ИЗМЕНЕНИЙ

См. файл Changes.

СМОТРИТЕ ТАКЖЕ

perl(1), perlxs(1), perlxstut(1), ExtUtils::ParseXS