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 должен иметь приоритет над стандартными typemaps. Этот параметр можно использовать несколько раз, при этом последний 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