2005/5/10

     
 

ACDK Perl Readme

artefaktur

ACDK Perl (acdk_perl)With acdk_perl, you can instrument a perl interpreter inside of your acdk application and you are able to have access to all ACDK-Objects in your perl environment.



Content of this chapter:

   General
     Title
     Version
     Short Description
     Dependencies
     Namespaces
     Authors
     License
   Description
   Notes
   Todo
   Changes



 General

 Title

ACDK Perl (acdk_perl)

 Version

Distribution version: 4.14.
Package version: 4.14.0.

 Short Description

  With acdk_perl, you can instrument a perl interpreter inside of your acdk application
and you are able to have access to all ACDK-Objects in your perl environment.    

 Dependencies

   ACDK Core
 ACDK Text    

 Namespaces

   acdk::perl    

 Authors

  Roger Rene Kommer (kommer@artefaktur.com).    

 License

       ACDK Free Edition Licens.    

 Description

acdk_perl provides an integration of ACDK and Perl with embedding Perl Code in ACDK and  accessing ACDK object from Perl.

In contrast to tradional glue code (XS) with acdk_perl no further code has to be written or generated to access C++ Objects from perl code.


sub foo($$)
{
  my ($string1, $string2) = @_;
  my $sb = pacdk::new("acdk/lang/StringBuffer", $string1);
  $sb->append($string2);
  return $sb->toString();
}
pacdk::peek_static("acdk/lang/System", "out")->println(foo("Hello Perl ", "from ACDK"));


With a few lines of code:

  RAPerlInterpreter pi = new APerlInterpreter();
  pi->parse("print(\"Hello Perl\");\n");
  pi->run();
an full featured Perl interpreter can be embedded into C++ code.

The  acdkperl command line perl interpreter is already prepared to have access to ACDK world.

 Notes

  This version uses the ActiveState Perl 5.6 Libraries for the Windows
platform and 5.00503 for Linux.

You have to adjust the path to header and libraries in the project settings and makefiles.

In the ./acdk_perl/lib/perl directory is a tiny perl script acdk_perl_test.pl, which demonstrates some features To run this, script type ./bin/acdkperl ./acdk_perl/lib/perl/acdk_perl_test.pl in the root acdk directory.

 Todo

  Nothing at the moment.  

 Changes

  ===========================================================
4.10.0
- nothing important
Please refer also to  ChangeLog.

=========================================================== 4.02.0 - Configuration and documentation fixes.

=========================================================== 4.01.1 - Problems with XS implementation of acdk_AUTOLOAD on unix perl versions 5.6 - 5.8. Introduced a perl module pacdk.pm as work-around.
- Ajustments to modified metainfo - minor documentation changes.

=========================================================== 4.00.1 - Ajustments to Unicode and revised metainfo.

=========================================================== 3.01.0 - Varios little fixes.
- Still problems with perl 5.6.1 on linux machines because AUTOLOAD doesn't work, $sb->append("sdf"); doesn't work. But sb->invoke('append', "sdf"); does.
=========================================================== 2.00.1 - Ajuments to the new DMI.
- Bugfixing.

=========================================================== 1.01.0 - Enhanced Metainfo compiler for CORBA functionality.
- Improved configurations.

=========================================================== 1.00.2 Changed configuration managment.

=========================================================== 1.00 Initial version