首页 > 代码库 > perl C/C++ 扩展(三)
perl C/C++ 扩展(三)
第三讲
扩展库使用c++实现,在调用函数后,返回对象变量,perl 能正确使用所有对象成员
使用h2xs 命令生成初始文件
h2xs -A -n three_test
登录目录
cd three_test
c++ 头文件
#ifndef INCLUDED_DUCK_H#define INCLUDED_DUCK_H 1#include <string>using std::string;class Duck{public: Duck(char*); char* getName(); void swim(); ~Duck(){}private: bool swimming; string name;};#endif /* INCLUDED_DUCK_H */
c++程序代码
#include "Duck.h"#include <cstdio>using namespace std;Duck::Duck(char* n) : swimming(false), name(n){}const char* Duck::getName(){ return name.c_str();}void Duck::swim(){ if (!swimming) { printf("%s, ok .. go swimming\n", name.c_str()); swimming = true; } else { printf("%s is already swimming , stop\n", name.c_str()); swimming = false; } return;}
使用g++编译成动态库
g++ -g -Wall -fpic -shared -o libduck.so Duck.cpp
将libduck.so 文件与Duck.h 文件拷贝到 three_test 目录下
cp libduck.so three_test;cp Duck.h three_test;
XS是一种用于描述接口的文件格式,当我们希望把我们的C/C++库映射成Perl的package时,需要在一个.xs文件中描述接口的映射。另外,我们还需要进行数据类型的映射,下文会提到 perlobject.map文件的使用。
perlobject.map 内容:(原文件地址:http://cpansearch.perl.org/src/ELEONORA/text_hunspell_1.3/perlobject.map)
# "perlobject.map" Dean Roehrich, version 19960302## TYPEMAPs## HV * -> unblessed Perl HV object.# AV * -> unblessed Perl AV object.## INPUT/OUTPUT maps## O_* -> opaque blessed objects# T_* -> opaque blessed or unblessed objects## O_OBJECT -> link an opaque C or C++ object to a blessed Perl object.# T_OBJECT -> link an opaque C or C++ object to an unblessed Perl object.# O_HvRV -> a blessed Perl HV object.# T_HvRV -> an unblessed Perl HV object.# O_AvRV -> a blessed Perl AV object.# T_AvRV -> an unblessed Perl AV object.TYPEMAPHV * T_HvRVAV * T_AvRV######################################################################OUTPUT# The Perl object is blessed into ‘CLASS‘, which should be a# char* having the name of the package for the blessing.O_OBJECT sv_setref_pv( $arg, CLASS, (void*)$var );T_OBJECT sv_setref_pv( $arg, Nullch, (void*)$var );# Cannot use sv_setref_pv() because that will destroy# the HV-ness of the object. Remember that newRV() will increment# the refcount.O_HvRV# "perlobject.map" Dean Roehrich, version 19960302## TYPEMAPs## HV * -> unblessed Perl HV object.# AV * -> unblessed Perl AV object.## INPUT/OUTPUT maps## O_* -> opaque blessed objects# T_* -> opaque blessed or unblessed objects## O_OBJECT -> link an opaque C or C++ object to a blessed Perl object.# T_OBJECT -> link an opaque C or C++ object to an unblessed Perl object.# O_HvRV -> a blessed Perl HV object.# T_HvRV -> an unblessed Perl HV object.# O_AvRV -> a blessed Perl AV object.# T_AvRV -> an unblessed Perl AV object.TYPEMAPHV * T_HvRVAV * T_AvRV######################################################################OUTPUT# The Perl object is blessed into ‘CLASS‘, which should be a# char* having the name of the package for the blessing.O_OBJECT sv_setref_pv( $arg, CLASS, (void*)$var );T_OBJECT sv_setref_pv( $arg, Nullch, (void*)$var );# Cannot use sv_setref_pv() because that will destroy# the HV-ness of the object. Remember that newRV() will increment# the refcount.O_HvRV $arg = sv_bless( newRV((SV*)$var), gv_stashpv(CLASS,1) );T_HvRV $arg = newRV((SV*)$var);# Cannot use sv_setref_pv() because that will destroy# the AV-ness of the object. Remember that newRV() will increment# the refcount.O_AvRV $arg = sv_bless( newRV((SV*)$var), gv_stashpv(CLASS,1) );T_AvRV $arg = newRV((SV*)$var);######################################################################INPUTO_OBJECT if( sv_isobject($arg) && (SvTYPE(SvRV($arg)) == SVt_PVMG) ) $var = ($type)SvIV((SV*)SvRV( $arg )); else{ warn( \"${Package}::$func_name() -- $var is not a blessed SV reference\" ); XSRETURN_UNDEF; }T_OBJECT if( SvROK($arg) ) $var = ($type)SvIV((SV*)SvRV( $arg )); else{ warn( \"${Package}::$func_name() -- $var is not an SV reference\" ); XSRETURN_UNDEF; }O_HvRV if( sv_isobject($arg) && (SvTYPE(SvRV($arg)) == SVt_PVHV) ) $var = (HV*)SvRV( $arg ); else { warn( \"${Package}::$func_name() -- $var is not a blessed HV reference\" ); XSRETURN_UNDEF; }T_HvRV if( SvROK($arg) && (SvTYPE(SvRV($arg)) == SVt_PVHV) ) $var = (HV*)SvRV( $arg ); else { warn( \"${Package}::$func_name() -- $var is not an HV reference\" ); XSRETURN_UNDEF; }O_AvRV if( sv_isobject($arg) && (SvTYPE(SvRV($arg)) == SVt_PVAV) ) $var = (AV*)SvRV( $arg ); else { warn( \"${Package}::$func_name() -- $var is not a blessed AV reference\" ); XSRETURN_UNDEF; }T_AvRV if( SvROK($arg) && (SvTYPE(SvRV($arg)) == SVt_PVAV) ) $var = (AV*)SvRV( $arg ); else { warn( \"${Package}::$func_name() -- $var is not an AV reference\" ); XSRETURN_UNDEF; }
将文件perlobject.map 拷贝到 three_test 目录下
cp perlobject.map three_test
增加一个Duck类型,保存在文件typemap
touch three_test/typemap
typemap 文件内容
TYPEMAPDuck* O_OBJECT
修改Makefile.PL 文件
#use 5.014002;use ExtUtils::MakeMaker;$CC = ‘g++‘;# See lib/ExtUtils/MakeMaker.pm for details of how to influence# the contents of the Makefile that is written.WriteMakefile( NAME => ‘three_test‘, VERSION_FROM => ‘lib/three_test.pm‘, # finds $VERSION PREREQ_PM => {}, # e.g., Module::Name => 1.1 ($] >= 5.005 ? ## Add these new keywords supported since 5.005 (ABSTRACT_FROM => ‘lib/three_test.pm‘, # retrieve abstract from module AUTHOR => ‘root <root@>‘) : ()), LIBS => [‘-L./ -lduck‘], # e.g., ‘-lm‘ DEFINE => ‘‘, # e.g., ‘-DHAVE_SOMETHING‘ ‘CC‘ => $CC, ‘LD‘ => ‘$(CC)‘, INC => ‘-I.‘, # e.g., ‘-I. -I/usr/include/other‘ # Un-comment this if you add C files to link with later: # OBJECT => ‘$(O_FILES)‘, # link all the C files too ‘XSOPT‘ => ‘-C++‘, ‘TYPEMAPS‘ => [‘perlobject.map‘]);
注意,红色部分为增加会修改内容,特别需要指出的是,第一行use 5.014002; 一定需要注释,否则无法正确生成makefile
修改部分,主要是指定编译使用g++
修改three_test.xs 文件
#ifdef __cplusplusextern "C"{#endif#include "EXTERN.h"#include "perl.h"#include "XSUB.h"#ifdef __cplusplus}#endif#include "ppport.h"#include "Duck.h"using namespace std;MODULE = three_test PACKAGE = three_testDuck*Duck::new(char * name)char*Duck::getName()voidDuck::swim()voidDuck::DESTROY()
红色部分为增加内容
编译并安装
perl Makefile.PL makemake install
编写一个perl 测试程序 test.pl
use three_test;my $duck = new three_test("Dan");my $name = $duck->getName();$duck->swim();$duck->swim();print "$name\n";
执行
perl test.pl
输出:
Dan, ok .. go swimming
Dan is already swimming , stop
Dan
正确调用了C++的库
参考文章:
http://chunyemen.org/archives/493
http://www.johnkeiser.com/perl-xs-c++.html