perl C/C++ 扩展（五）

buser

　　perl 的C++扩展，返回值为自定义类型。
　　在 perl C/C++扩展(三) 中，我已经介绍了，如何让perl 认识 c++的类，但是前面的介绍中，包括我参考的博客http://chunyemen.org/archives/493，都提到，返回值必须是基础类型。对于开发者而言，如果返回值只能是基础类型，那么对于扩展的开发热情就大大降低了。楼主排除万难，终于在《高级perl编程（第二版）》.(（美）simon cozens)一书的第十八章与第二十章中得到些许启发。
　　下面我来介绍一下玩法。
　　首先创建一个新的工程，名为Cat



h2xs -A -n Cat
　　创建好工程后，进入Cat目录



cd Cat
　　创建一个mylib目录，并将c++代码拷贝到mylib目录下



mkdie mylib
　　Cat.h



#ifndef INCLUDE_CAT_H
#define INCLUDE_CAT_H 1
#include <iostream>
class Cat
{
public:
Cat(char *,int);
Cat(const Cat &);
void display();
char * getName();
int getAge();
~Cat();
private:
char * name;
int age;
};
#endif
　　Cat.cpp



#include "Cat.h"
Cat::Cat(char * name, int age)
{
this->name = name;
this->age = age;
}
Cat::Cat(const Cat & incat)
{
name = incat.name;
age = incat.age;
}
void Cat::display()
{
std::cout<<"~~~~~~~~~~~~Cat.display()~~~~~~~~~~~~~~~~~~~~"<<std::endl;
std::cout<<"name="<<name<<"\tage="<<age<<std::endl;
}
char * Cat::getName()
{
return name;
}
int Cat::getAge()
{
return age;
}
Cat::~Cat(){}
　　Animal.h



#ifndef INCLUDE_ANIMAL_H
#define INCLUDE_ANIMAL_H 1
#include <iostream>
#include "Cat.h"
class Animal
{
public:
Animal(char *, int);
void display();
Cat * getAnimal();
Cat * setAnimal(Cat *);
bool haveAnimal();
~Animal();
private:
Cat * cat;
};
#endif
　　Animal.cpp



#include "Animal.h"
Animal::Animal( char * name, int age):
cat( new Cat(name, age) )
{}
void Animal::display()
{
std::cout<<"~~~~~~~~~~~Animal.display()~~~~~~~~~~~~~~~~~\n";
cat->display();
}
Cat * Animal::getAnimal()
{
return cat;
}
Cat * Animal::setAnimal(Cat * lcat)
{
//delete cat;
cat = new Cat(*lcat);
return cat;
}
bool Animal::haveAnimal()
{
//return false;
return 1;
//throw 1;
}
Animal::~Animal()
{
//delete cat;
}
　　在mylib 目录下创建Makefile.PL 文件
　　mylib/Makefile.PL



1 use ExtUtils::MakeMaker;
2  $Verbose = 1;
3  WriteMakefile(
4  NAME   => 'Animal::mylib',
5  SKIP   => [qw(all static static_lib dynamic dynamic_lib)],
6  clean  => {'FILES' => 'libanimal.so'},
7  'CC'   => 'g++',
8  );
9
10 sub MY::top_targets {
11 '
12 all :: static
13 pure_all :: static
14 static ::  libanimal.so
15 libanimal.so: $(C_FILES)
16    $(CC) -shared -fpic -g -Wall -o libanimal.so $(C_FILES)
17    $(RANLIB) libanimal.so
18 ';
19 }
　　注意：mylib/Makefile.PL 的16 17 行前的不是空格键，而且table 键，因为这里是Makefile的代码，如果不按照Makefile格式编写，make 操作就会报错
　　退回Cat 目录



cd ../
　　创建一个typemap 文件，并写入如下内容。
　　typemap



TYPEMAP
Cat * ANIMAL_OBJECT
OUTPUT
ANIMAL_OBJECT
sv_setref_pv($arg, CLASS, (void *) $var);
INPUT
ANIMAL_OBJECT
$var = ($type) SvIV((SV*) SvRV($arg));
　　这个typemap 文件是让xs 识别新定义的类。在（三）那里是在Makefile.PL 文件中指定了一个perlobject。map的文件，其实内容和这个差不多，我们没有必要定义那么多的别名。
　　修改Ma ke f ile.PL



1 #use 5.018002;
2 use ExtUtils::MakeMaker;
3 # See lib/ExtUtils/MakeMaker.pm for details of how to influence
4 # the contents of the Makefile that is written.
5 $CC = 'g++';
6 WriteMakefile(
7     NAME              => 'Cat',
8     VERSION_FROM      => 'lib/Cat.pm', # finds $VERSION
9     PREREQ_PM         => {}, # e.g., Module::Name => 1.1
10     ($] >= 5.005 ?     ## Add these new keywords supported since 5.005
11       (ABSTRACT_FROM  => 'lib/Cat.pm', # retrieve abstract from module
12        AUTHOR         => 'chen <chen@>') : ()),
13     LIBS              => ['-Lmylib -lanimal'], # e.g., '-lm'
14     DEFINE            => '', # e.g., '-DHAVE_SOMETHING'
15     INC               => '-Imylib', # e.g., '-I. -I/usr/include/other'
16    # Un-comment this if you add C files to link with later:
17     # OBJECT            => '$(O_FILES)', # link all the C files too
18     'XSOPT'           => '-C++',
19     'CC'              => $CC,
20     'LD'              => '$(CC)',
21 );
22
23 sub MY::postamble {
24 '
25 mylib/libanimal.so: mylib/Makefile
26    cd mylib && $(MAKE) $(PASSTHRU)
27 ';
28 }
　　红色的代码为添加或修改代码。注意：26 行代码前是table 键，而不是普通空格
　　函数 MY::postmable 是往Makefile 文件插入的一段代码，作用是让编译Cat的扩展库之前，首先编译依赖的libanimal.so包。
　　其余添加的代码主要是定义编译使用g++。再一次提醒，需要注释第一行代码#use 5.018002;
　　修改Cat.xs 文件
　　Cat.xs



#ifdef __cplusplus
extern "C"{
#endif
#define PERL_NO_GET_CONTEXT
#include "EXTERN.h"
#include "perl.h"
#include "XSUB.h"
#ifdef __cplusplus
}
#endif
#include "ppport.h"
#include "mylib/Cat.h"

MODULE = Cat      PACKAGE = Cat
Cat *
Cat::new(char * name, int age)
void
Cat::display()
char *
Cat::getName()
int
Cat::getAge()
void
Cat::DESTROY()
　　格式和之前的（三）一样，这里就不再展开讲了。
　　生成Makefile 文件，编译



perl Makefile.PL && make
　　割一下############################################################
　　第二部分，创建Animal的工程



h2xs -A -n Animal
　　将Cat工程的mylib 软链接过来



ln -sf /home/chen/learn/perl_c/Cat/mylib /home/chen/learn/perl_c/Animal/mylib
　　创建并编辑typemap



1 TYPEMAP
2 Animal * ANIMAL_OBJECT
3 Cat * CAT_OBJECT
4
5 OUTPUT
6 ANIMAL_OBJECT
7    sv_setref_pv($arg, CLASS, (void *) $var);
8 CAT_OBJECT
9    sv_setref_pv($arg, "Cat", (void *) $var);
10
11 INPUT
12 ANIMAL_OBJECT
13    $var = ($type) SvIV((SV*) SvRV($arg));
14 CAT_OBJECT
15    $var = ($type) SvIV((SV*) SvRV($arg));
　　实际上，这里就是本次博客的核心。
　　我们仔细观察Animal工程的 typemap 和Cat 工程的typemap 有什么不一样。Animal 工程的typemap 多了一个CAT_OBJECT 的定义，并且在 CAT_OBJECT 的 OUTPUT 中（第九行），是写明指向Cat的类。
　　如果我们仔细看一下前面的Cat 工程编译命令，有



g++ -c  -Imylib -D_REENTRANT -D_GNU_SOURCE -DDEBIAN -fstack-protector -fno-strict-aliasing -pipe -I/usr/local/include -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64 -O2 -g   -DVERSION=\"0.01\" -DXS_VERSION=\"0.01\" -fPIC "-I/usr/lib/perl/5.18/CORE"   Cat.c
　　Cat.c这个文件是在make 命令执行时产生的文件，我们打开Cat.c 文件查看的话，会发现一些有趣的东西



XS_EUPXS(XS_Cat_new)
{
dVAR; dXSARGS;
if (items != 3)
croak_xs_usage(cv,  "CLASS, name, age");
{
char *   CLASS = (char *)SvPV_nolen(ST(0))
;
Cat * RETVAL;
char *   name = (char *)SvPV_nolen(ST(1))
;
int   age = (int)SvIV(ST(2))
;
RETVAL = new Cat(name, age);
ST(0) = sv_newmortal();
sv_setref_pv(ST(0), CLASS, (void *) RETVAL);
}
XSRETURN(1);
}
　　上面的代码实际上就是Cat::new() 的真实代码。我们可以发现CLASS 的变量，其实就是一个字符串数组。我在实验过程中，将CLASS 字符串打印了一下，发现原来它记录的就是Cat的工程名“Cat"。
　　分析到这里，我们就不难反推，如果需要返回值是自定义的类，我们只需要将”CLASS“ 字段写成我们自己的工程名即可。
　　有兴趣的同学也可以深挖一下，为什么CLASS 会自动识别当前工程名，与（三）的perlobject.map文件中其他玩法。
　　
　　后面的事情就很简单了，不过是修改Makefile.PL 与 Aniaml.xs 文件
　　Makefile.PL



1 #use 5.018002;
2 use ExtUtils::MakeMaker;
3 # See lib/ExtUtils/MakeMaker.pm for details of how to influence
4 # the contents of the Makefile that is written.
5 $CC = 'g++';
6 WriteMakefile(
7     NAME              => 'Animal',
8     VERSION_FROM      => 'lib/Animal.pm', # finds $VERSION
9     PREREQ_PM         => {}, # e.g., Module::Name => 1.1
10     ($] >= 5.005 ?     ## Add these new keywords supported since 5.005
11       (ABSTRACT_FROM  => 'lib/Animal.pm', # retrieve abstract from module
12        AUTHOR         => 'chen <chen@>') : ()),
13     LIBS              => ['-Lmylib -lanimal'], # e.g., '-lm'
14     DEFINE            => '', # e.g., '-DHAVE_SOMETHING'
15     INC               => '-Imylib', # e.g., '-I. -I/usr/include/other'
16     'CC'              => $CC,
17     'LD'              => '$(CC)',
18    # Un-comment this if you add C files to link with later:
19     # OBJECT            => '$(O_FILES)', # link all the C files too
20     'XSOPT'           => '-C++',
21     #'LDDLFLAGS'       => '-r',
22 );
23
24 sub MY::postamble {
25 '
26 $(MYEXTLIB): mylib/Makefile
27    cd mylib && $(MAKE) $(PASSTHRU)
28 ';
29 }
　　红色部分为增改内容。
　　注意：27行代码前的为table 键，而不是普通空格
　　Animal.xs



1 #ifdef __cplusplus
2 extern "C"{
3 #endif
4
5 #define PERL_NO_GET_CONTEXT
6 #include "EXTERN.h"
7 #include "perl.h"
8 #include "XSUB.h"
9 #ifdef __cplusplus
10 }
11 #endif
12 #include "ppport.h"
13 #include "mylib/Cat.h"
14 #include "mylib/Animal.h"
15
16 MODULE = Animal      PACKAGE = Animal
17
18 Animal *
19 Animal::new(char * name, int age)
20
21 void
22 Animal::display()
23
24 Cat *
25 Animal::getAnimal()
26
27 Cat *
28 Animal::setAnimal(Cat * lcat)
29
30 bool
31 Animal::haveAnimal()
32
33 void
34 Animal::DESTROY()
　　生成Makefile并编译



perl Makefile.PL && make
　　编写测试代码，test.pl



1 #!/usr/bin/perl
2 use Animal;
3 use Cat;
4 $animal = new Animal("chen",123);
5 $animal->display();
6 $cat = $animal->getAnimal();
7 $cat->display();
8
9 $name = $cat->getName();
10
11 print $name;
12
13 $name = "sdjlfa";
14 $animal->display();
15
16 print "~~~~~~###############~~~~~~~~~~~~~~~\n";
17
18 $lcat = new Cat("ASKJKLF",889);
19 $lcat->display();
20 print "~~~~~~###############~~~~~~~~~~~~~~~\n";
21
22 $tcat = $animal->setAnimal( $lcat );
23 $animal->display();
24
25 $test = $animal->haveAnimal();
26 print "@@@@@@@@@$test@@@@@@\n";
27
28
29 $animal2 = $animal;
30
31 $animal2->display();
　　添加环境变量



export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/home/chen/learn/perl_c/Animal/blib/arch/auto/Animal:/home/chen/learn/perl_c/Animal/mylib:/home/chen/learn/perl_c/Cat/blib/arch/auto/Cat
export PERLLIB=${PERLLIB}:/home/chen/learn/perl_c/Animal/lib:/home/chen/learn/perl_c/Cat/lib
　　Animal 的扩展包动态库在Animal  工程的 blib/arch/auto/Animal 目录下，pm 文件则在 Animal 工程的 lib 目录下
　　同样，Cat 的扩展包动态库在Cat 工程的blib/arch/auto/Animal 目录下，pm 文件则在 Cat 工程的 lib 目录下
　　同时需要将libanimal.so 文件添加到LD_LIBRARY_PATH 环境变量中。
　　
　　运行一下测试程序



perl test.pl
　　输出：



~~~~~~~~~~~Animal.display()~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~Cat.display()~~~~~~~~~~~~~~~~~~~~
name=chen    age=123
~~~~~~~~~~~~Cat.display()~~~~~~~~~~~~~~~~~~~~
name=chen    age=123
~~~~~~~~~~~Animal.display()~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~Cat.display()~~~~~~~~~~~~~~~~~~~~
name=chen    age=123
chen~~~~~~###############~~~~~~~~~~~~~~~
~~~~~~~~~~~~Cat.display()~~~~~~~~~~~~~~~~~~~~
name=ASKJKLF    age=889
~~~~~~###############~~~~~~~~~~~~~~~
~~~~~~~~~~~Animal.display()~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~Cat.display()~~~~~~~~~~~~~~~~~~~~
name=ASKJKLF    age=889
@@@@@@@@@@@@@@
~~~~~~~~~~~Animal.display()~~~~~~~~~~~~~~~~~
~~~~~~~~~~~~Cat.display()~~~~~~~~~~~~~~~~~~~~
name=ASKJKLF    age=889
　　测试成功。