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. Он будет использовать следующий путь для поиска стандартных typemaps, при этом самый правый typemap имеет наивысший приоритет.

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

Он также будет использовать установленный по умолчанию typemap как ExtUtils::typemap.

ПАРАМЕТРЫ

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

-hiertype

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

-except

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

-typemap typemap

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

-output filename

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

-v

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

-prototypes

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

-noversioncheck

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

-nolinenumbers

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

-nooptimize

Отключает некоторые оптимизации. Единственная оптимизация, которая в настоящее время затронута, это использование targets в выводимом коде 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