XML-LibXSLT-1.95/0000755000076400007640000000000012747105600013225 5ustar shlomifshlomifXML-LibXSLT-1.95/perl-libxml-mm.h0000644000076400007640000001542512321504405016235 0ustar shlomifshlomif/** * perl-libxml-mm.h * $Id$ * * Basic concept: * perl varies in the implementation of UTF8 handling. this header (together * with the c source) implements a few functions, that can be used from within * the core module inorder to avoid cascades of c pragmas */ /* * This is free software, you may use it and distribute it under the same terms as * Perl itself. * * Copyright 2001-2009 AxKit.com Ltd. */ #ifndef __PERL_LIBXML_MM_H__ #define __PERL_LIBXML_MM_H__ #ifdef __cplusplus extern "C" { #endif #include "EXTERN.h" #include "perl.h" #include #ifdef __cplusplus } #endif /* * NAME xs_warn * TYPE MACRO * * this makro is for XML::LibXML development and debugging. * * SYNOPSIS * xs_warn("my warning") * * this makro takes only a single string(!) and passes it to perls * warn function if the XS_WARNRINGS pragma is used at compile time * otherwise any xs_warn call is ignored. * * pay attention, that xs_warn does not implement a complete wrapper * for warn!! */ #ifdef XS_WARNINGS #define xs_warn(string) warn("%s",string) #else #define xs_warn(string) #endif struct _ProxyNode { xmlNodePtr node; xmlNodePtr owner; int count; }; struct _DocProxyNode { xmlNodePtr node; xmlNodePtr owner; int count; int encoding; /* only used for proxies of xmlDocPtr */ int psvi_status; /* three-state flag for a document */ }; #define Pmm_NO_PSVI 0 #define Pmm_PSVI_TAINTED 1 /* helper type for the proxy structure */ typedef struct _DocProxyNode DocProxyNode; typedef struct _ProxyNode ProxyNode; /* pointer to the proxy structure */ typedef ProxyNode* ProxyNodePtr; typedef DocProxyNode* DocProxyNodePtr; /* this my go only into the header used by the xs */ #define SvPROXYNODE(x) (INT2PTR(ProxyNodePtr,SvIV(SvRV(x)))) #define PmmPROXYNODE(x) (INT2PTR(ProxyNodePtr,x->_private)) #define SvNAMESPACE(x) (INT2PTR(xmlNsPtr,SvIV(SvRV(x)))) #define x_PmmREFCNT(node) node->count #define x_PmmREFCNT_inc(node) node->count++ #define x_PmmNODE(xnode) xnode->node #define x_PmmOWNER(node) node->owner #define x_PmmOWNERPO(node) ((node && x_PmmOWNER(node)) ? (ProxyNodePtr)x_PmmOWNER(node)->_private : node) #define x_PmmENCODING(node) ((DocProxyNodePtr)(node))->encoding #define x_PmmNodeEncoding(node) ((DocProxyNodePtr)(node->_private))->encoding #define x_SetPmmENCODING(node,code) x_PmmENCODING(node)=(code) #define x_SetPmmNodeEncoding(node,code) x_PmmNodeEncoding(node)=(code) #ifndef NO_XML_LIBXML_THREADS #ifdef USE_ITHREADS #define XML_LIBXML_THREADS #endif #endif #ifdef XML_LIBXML_THREADS /* structure for storing thread-local refcount */ struct _LocalProxyNode { ProxyNodePtr proxy; int count; }; typedef struct _LocalProxyNode LocalProxyNode; typedef LocalProxyNode* LocalProxyNodePtr; #define x_PmmUSEREGISTRY (x_PROXY_NODE_REGISTRY_MUTEX != NULL) #define x_PmmREGISTRY (INT2PTR(xmlHashTablePtr,SvIV(SvRV(get_sv("XML::LibXML::__PROXY_NODE_REGISTRY",0))))) #endif /* XML_LIBXML_THREADS */ ProxyNodePtr x_PmmNewNode(xmlNodePtr node); ProxyNodePtr x_PmmNewFragment(xmlDocPtr document); SV* x_PmmCreateDocNode( unsigned int type, ProxyNodePtr pdoc, ...); int x_PmmREFCNT_dec( ProxyNodePtr node ); SV* x_PmmNodeToSv( xmlNodePtr node, ProxyNodePtr owner ); /* x_PmmFixProxyEncoding * TYPE * Method * PARAMETER * @dfProxy: The proxystructure to fix. * * DESCRIPTION * * This little helper allows to fix the proxied encoding information * after a not standard operation was done. This is required for * XML::LibXSLT */ void x_PmmFixProxyEncoding( ProxyNodePtr dfProxy ); /* x_PmmSvNodeExt * TYPE * Function * PARAMETER * @perlnode: the perl reference that holds the scalar. * @copy : copy flag * * DESCRIPTION * * The function recognizes XML::LibXML and XML::GDOME * nodes as valid input data. The second parameter 'copy' * indicates if in case of GDOME nodes the libxml2 node * should be copied. In some cases, where the node is * cloned anyways, this flag has to be set to '0', while * the default value should be allways '1'. */ xmlNodePtr x_PmmSvNodeExt( SV * perlnode, int copy ); /* x_PmmSvNode * TYPE * Macro * PARAMETER * @perlnode: a perl reference that holds a libxml node * * DESCRIPTION * * x_PmmSvNode fetches the libxml node such as x_PmmSvNodeExt does. It is * a wrapper, that sets the copy always to 1, which is good for all * cases XML::LibXML uses. */ #define x_PmmSvNode(n) x_PmmSvNodeExt(n,1) xmlNodePtr x_PmmSvOwner( SV * perlnode ); SV* x_PmmSetSvOwner(SV * perlnode, SV * owner ); void x_PmmFixOwner(ProxyNodePtr node, ProxyNodePtr newOwner ); void x_PmmFixOwnerNode(xmlNodePtr node, ProxyNodePtr newOwner ); int x_PmmContextREFCNT_dec( ProxyNodePtr node ); SV* x_PmmContextSv( xmlParserCtxtPtr ctxt ); xmlParserCtxtPtr x_PmmSvContext( SV * perlctxt ); /** * NAME x_PmmCopyNode * TYPE function * * returns libxml2 node * * DESCRIPTION * This function implements a nodetype independant node cloning. * * Note that this function has to stay in this module, since * XML::LibXSLT reuses it. */ xmlNodePtr x_PmmCloneNode( xmlNodePtr node , int deep ); /** * NAME x_PmmNodeToGdomeSv * TYPE function * * returns XML::GDOME node * * DESCRIPTION * creates an Gdome node from our XML::LibXML node. * this function is very usefull for the parser. * * the function will only work, if XML::LibXML is compiled with * XML::GDOME support. * */ SV * x_PmmNodeToGdomeSv( xmlNodePtr node ); /** * NAME x_PmmNodeTypeName * TYPE function * * returns the perl class name for the given node * * SYNOPSIS * CLASS = x_PmmNodeTypeName( node ); */ const char* x_PmmNodeTypeName( xmlNodePtr elem ); xmlChar* x_PmmEncodeString( const char *encoding, const char *string ); char* x_PmmDecodeString( const char *encoding, const xmlChar *string); /* string manipulation will go elsewhere! */ /* * NAME c_string_to_sv * TYPE function * SYNOPSIS * SV *my_sv = c_string_to_sv( "my string", encoding ); * * this function converts a libxml2 string to a SV*. although the * string is copied, the func does not free the c-string for you! * * encoding is either NULL or a encoding string such as provided by * the documents encoding. if encoding is NULL UTF8 is assumed. * */ SV* C2Sv( const xmlChar *string, const xmlChar *encoding ); /* * NAME sv_to_c_string * TYPE function * SYNOPSIS * SV *my_sv = sv_to_c_string( my_sv, encoding ); * * this function converts a SV* to a libxml string. the SV-value will * be copied into a *newly* allocated string. (don't forget to free it!) * * encoding is either NULL or a encoding string such as provided by * the documents encoding. if encoding is NULL UTF8 is assumed. * */ xmlChar * Sv2C( SV* scalar, const xmlChar *encoding ); SV* nodeC2Sv( const xmlChar * string, xmlNodePtr refnode ); xmlChar * nodeSv2C( SV * scalar, xmlNodePtr refnode ); #endif XML-LibXSLT-1.95/benchmark/0000755000076400007640000000000012747105600015157 5ustar shlomifshlomifXML-LibXSLT-1.95/benchmark/Driver/0000755000076400007640000000000012747105600016412 5ustar shlomifshlomifXML-LibXSLT-1.95/benchmark/Driver/Sablotron.pm0000644000076400007640000000367712273200647020731 0ustar shlomifshlomif# base class. package Driver::Sablotron; use strict; use warnings; use Driver::BaseClass; our @ISA = qw(Driver::BaseClass); use XML::Sablotron; use IO::File; use vars qw( $xslt $stylesheet $input $handler ); sub init { my %options = @_; $xslt = XML::Sablotron->new(); $handler = Driver::Sablotron::Handler->new(%options); $xslt->RegHandler(0, $handler); } sub shutdown { $xslt->ClearError(); $xslt->UnregHandler(0, $handler); undef $handler; undef $xslt; undef $input; undef $stylesheet; } sub load_stylesheet { my ($filename) = @_; my $fh = new IO::File; if ($fh->open("< $filename")) { local $/; $stylesheet = <$fh>; $fh->close; } } sub load_input { my ($filename) = @_; my $fh = new IO::File; if ($fh->open("< $filename")) { local $/; $input = <$fh>; $fh->close; } } use Cwd; sub run_transform { my ($output) = @_; $handler->{show_error} = 1; open(OUT, ">$output") || die "Can't write $output : $!"; my $result = ''; my $args = ['template', "$stylesheet", 'xml_resource', "$input"]; my $retcode = $xslt->RunProcessor("arg:/template", "arg:/xml_resource", "arg:/result", [], $args); $result = $xslt->GetResultArg("result"); print OUT $result; close OUT; } package Driver::Sablotron::Handler; sub new { my $class = shift; my %options = @_; bless \%options, $class; } sub MHMakeCode { my $self = shift; my $processor = shift; my ($severity, $facility, $code) = @_; return $code; } sub MHLog { return 1; } sub MHError { my $self = shift; my $processor = shift; my ($code, $level, @fields) = @_; return unless $self->{show_error}; $self->{show_error} = 0; warn "Sablotron [Error]: ", join(' :: ', @fields), "\n" if $self->{verbose}; return 1; } 1; XML-LibXSLT-1.95/benchmark/Driver/LibXSLT.pm0000644000076400007640000000137312273200656020176 0ustar shlomifshlomif# base class. package Driver::LibXSLT; use strict; use warnings; use Driver::BaseClass; our @ISA = qw(Driver::BaseClass); use XML::LibXSLT; use XML::LibXML; use vars qw( $parser $xslt $stylesheet $input ); sub init { $parser = XML::LibXML->new(); $xslt = XML::LibXSLT->new(); } sub load_stylesheet { my ($filename) = @_; my $styledoc = $parser->parse_file($filename); $stylesheet = $xslt->parse_stylesheet($styledoc); } sub load_input { my ($filename) = @_; $input = $parser->parse_file($filename); } sub run_transform { my ($output) = @_; my $results; $results = $stylesheet->transform($input); $stylesheet->output_file($results, $output); # print STDERR "\n"; } 1; XML-LibXSLT-1.95/benchmark/Driver/BaseClass.pm0000644000076400007640000000074412273200665020616 0ustar shlomifshlomif# base class. package Driver::BaseClass; use strict; use warnings; use Carp; sub init { my %options = @_; } sub chdir { my ($dir) = @_; chdir($dir); } sub load_stylesheet { my ($filename) = @_; croak("load_stylesheet(filename) unimplemented"); } sub load_input { my ($filename) = @_; croak("load_input(filename) unimplemented"); } sub run_transform { my ($output) = @_; croak("run_transform(output) unimplemented"); } sub shutdown { } 1; XML-LibXSLT-1.95/benchmark/benchmark.pl0000644000076400007640000001702612321504425017450 0ustar shlomifshlomifuse Benchmark; use Getopt::Long; use File::Basename; use XML::XPath; use strict; use warnings; $|++; my @default_drivers = qw( LibXSLT Sablotron ); use vars qw( $component $iter $ms $kb_in $kb_out $kb_sec $result $ref_size ); my @getopt_args = ( 'c=s', # config file 'n=i', # number of benchmark times 'd=s@', # drivers 't', # only 1 iteration per test 'v', # verbose 'h', # help 'x', # XSLTMark emulation ); my %options; Getopt::Long::config("bundling"); unless (GetOptions(\%options, @getopt_args)) { usage(); } usage() if $options{h}; $options{c} ||= 'testcases/default.conf'; my $basedir = dirname($options{c}); $options{d} ||= [@default_drivers]; $options{n} ||= 1; # load drivers for my $driver (@{$options{d}}) { warn "Loading $driver Driver\n" if $options{v}; require "Driver/$driver.pm"; } # load config my @config; open(CONFIG, $options{c}) || die "Can't open config file '$options{c}' : $!"; my $current = {}; while(my $line = ) { if ($line =~ /^\s*$/m && %$current) { push @config, $current; $current = {}; } # ignore comments and full line comments $line =~ s/#.*$//; next unless $line =~ /\S/; if ($line =~ /^\s*\[(.*)\]\s*$/) { $current->{component} = $1; } elsif ($line =~ /^(.*?)\s*=\s*(.*)$/) { $current->{$1} = $2; } } for my $driver (@{$options{d}}) { my $pkg = "Driver::${driver}"; $pkg->can('init')->(verbose => $options{v}); $pkg->can('chdir')->($basedir); print "Testing: $driver\n\n"; print_header(); my %totals; COMPONENT: for my $cmp (@config) { warn "Running test: $cmp->{component}\n" if $options{v}; for (1..$options{n}) { $component = $cmp->{component}; $iter = $ms = $kb_in = $kb_out = $kb_sec = $ref_size = 0; if ($cmp->{skipdriver} =~ /\b\Q$driver\E\b/) { $result = 'SKIPPED'; print_output() unless $cmp->{written}; $cmp->{written}++; next COMPONENT; } eval { $pkg->can('load_stylesheet')->($cmp->{stylesheet}); $pkg->can('load_input')->($cmp->{input}); $iter = $cmp->{iterations}; $iter = 1 if $options{t}; my $bench = timeit($iter, sub { $pkg->can('run_transform')->($cmp->{output}); }); my $str = timestr($bench, 'all', '5.4f'); if ($str =~ /\((\d+\.\d+)/) { $ms = $1; $ms *= 1000; } $kb_in = (stat($cmp->{input}))[7]; if ($options{x}) { $kb_in /= 1000; } else { $kb_in += (stat($cmp->{stylesheet}))[7]; $kb_in /= 1024; } $kb_in *= $iter; $kb_out = (stat($cmp->{output}))[7]; $kb_out /= 1024; $kb_out *= $iter; die "failed - no output\n" unless $kb_out > 0; $kb_sec = ($kb_in + $kb_out) / ( $ms / 500 ); if ($cmp->{reference}) { $ref_size = (stat($cmp->{reference}))[7]; $ref_size /= 1024; open(REFERENCE, $cmp->{reference}) || die "Can't open reference '$cmp->{reference}' : $!"; open(NEW, $cmp->{output}) || die "Can't open transform output '$cmp->{output}' : $!"; local $/; my $ref = ; my $new = ; close REFERENCE; close NEW; $new =~ s/\A<\?xml.*?\?>\s*//; $new =~ s/\A\s*//; if (!length($new)) { die "output length failed\n"; } if ($new eq $ref) { $result = 'OK'; } else { $result = 'CHECK OUTPUT'; eval { my $rpp = XML::XPath->new(xml => $ref); my $ppp = XML::XPath::XMLParser->new(xml => $new); my $npp; eval { $npp = $ppp->parse; }; if ($@) { $npp = $ppp->parse("$new"); } my @rnodes = $rpp->findnodes('//*'); my @nnodes = $npp->findnodes('//*'); # warn "ref nodes: ", scalar(@rnodes), "\n"; # warn "new nodes: ", scalar(@nnodes), "\n"; if (@rnodes == @nnodes) { $result = 'COUNT OK'; } }; if ($@) { warn $@ if $options{v}; } } } else { $result = 'NO REFERENCE'; } }; if ($@) { warn "$component failed: $@" if $options{v}; $result = 'ERROR'; } if (($result =~ /OK/) || ($result eq 'NO REFERENCE')) { $totals{iter} += $iter; $totals{ms} += $ms; $totals{kb_in} += $kb_in; $totals{kb_out} += $kb_out; } print_output() unless $cmp->{written}; $cmp->{written}++; } # $options{n} loop delete $cmp->{written}; } # each component $pkg->can('shutdown')->(); $component = 'total'; $iter = $totals{iter}; $ms = $totals{ms}; $kb_in = $totals{kb_in}; $kb_out = $totals{kb_out}; $kb_sec = ($kb_in + $kb_out) / ( $ms / 500 ); $ref_size = 0; $result = ''; print_output(); } sub usage { print < load configuration from defaults to testcases/default.conf -n run each test case times. Default = 1. -t only one iteration per test case (note this is different to -n 1) -d test . Use multiple -d options to test more than one driver. Defaults are set in this script (the \@default_drivers variable). -x XSLTMark emulation. Infuriatingly XSLTMark thinks there are 1000 bytes in a Kilobyte. Someone please tell them some basic computer science... Without this option, this benchmark also includes the size of the stylesheet in the KB In figure. -v be verbose. Copyright 2001 AxKit.com Ltd. This is free software, you may use it and distribute it under either the GNU GPL Version 2, or under the Perl Artistic License. EOT exit(0); } sub print_header { print STDOUT <<'EOF'; Test Component Iter ms KB In KB Out KB/s Result ========================================================================== EOF } sub print_output { printf STDOUT "%-15.15s %5.0d %5.0d %7.0f %7.0f %9.2f %-15.15s\n", $component, $iter, $ms, $kb_in, $kb_out, $kb_sec, $result; } XML-LibXSLT-1.95/Changes0000644000076400007640000002744612747105341014537 0ustar shlomifshlomifRevision history for Perl extension XML::LibXSLT. 1.95 2016-07-30 - Hopefully fix RT#116461 - https://rt.cpan.org/Public/Bug/Display.html?id=116461 - “Makefile.PL shouldn't run "pkg-config libexslt" if LIBS or INC were provided” - Thanks to NWELLNHOF for the report and a suggested fix. 1.94 2015-01-19 - Fix builds on older versions of libxslt. - Breakage caused by the MaxVars change. - https://rt.cpan.org/Ticket/Display.html?id=101605 - Thanks to Deyan Ginev for the report. 1.93 2015-01-17 - Add the ->max_vars function to set the MaxVars. - https://rt.cpan.org/Ticket/Display.html?id=101413 - Thanks to Thomas Krichel for the report/request. 1.92 2014-04-12 - Add scripts/tag-release.pl . 1.91 2014-04-12 - t/cpan-changes.t : minimum version of Test::CPAN::Changes. - This is to avoid test failures such as: - http://www.cpantesters.org/cpan/report/5af7d5eb-6bfa-1014-b84e-eb85912f2992 1.90 2014-04-10 - Handle $Config{dlext} correctly on Windows. - https://rt.cpan.org/Ticket/Display.html?id=94516 - Thanks to kmx for the report and fix. - Add t/pod.t . - Fix some POD problems. - Add t/cpan-changes.t and convert Changes to CPAN::Changes format. - Add t/style-trailing-space.t. - Remove trailing whitespace. 1.89 2014-03-05 - Fix memory management of node-sets returned from extension functions. Without calling xsltExtensionInstructionResultRegister, node-sets could be freed too early, leading to strange errors or segfaults. - https://bugzilla.gnome.org/show_bug.cgi?id=562302 - https://rt.cpan.org/Ticket/Display.html?id=93349 - Thanks to Alexander Schepanovski for the report. - Document input_callbacks methods - Don't register libxml2 input callbacks twice - https://rt.cpan.org/Public/Bug/Display.html?id=60313 - Fix memory leak with extension functions returning node lists - https://rt.cpan.org/Public/Bug/Display.html?id=55623 - https://rt.cpan.org/Public/Bug/Display.html?id=76596 - Thanks to Jozef Kutej and Slaven Rezic for the reports. - Thanks to Nick Wellnhofer for the pull requests and fixes. 1.88 2014-02-17 - Fix t/xml-grammar-failures.t based on the xml:space commentary here: - https://mail.gnome.org/archives/xml/2014-February/msg00000.html - Caused some failures which were ultimately our fault. 1.87 2014-02-03 - Decrease the minimum libxslt version again. - Setting it as 1.1.28 did not fix the failures, and now we have some more tests to test against it. - https://rt.cpan.org/Ticket/Display.html?id=92659 - Thanks to Slaven Rezic for the report. 1.86 2014-02-02 - Add t/xml-grammar-failures.t to catch test failures in dependent modules. - Add some data files for it under t/data/*. - This fails on FreeBSD 9.2 currently. 1.85 2014-02-01 - Add "use strict;" and "use warnings;" globally (CPANTS). - Add LICENSE to the MANIFEST. 1.84 2013-12-26 - Hopefully fix a segmentation fault on Win32 introduced in the last ver. - https://rt.cpan.org/Ticket/Display.html?id=91652 - Thanks to Alexandr Ciornii for the report, and to Nikolay Sivov for providing help. 1.83 2013-12-22 - Get rid of compiler warnings when compiling using CLANG. - https://rt.cpan.org/Public/Bug/Display.html?id=91118 - Thanks to Daniel Macks for the report. 1.82 2013-11-06 - Makefile.PL: Report LibXSLT mismatch correctly. - https://rt.cpan.org/Ticket/Display.html?id=90085 - Thanks to David Schmidt for the report, and to joel and brother from the channel #perl-help for analysis. 1.81 2013-07-05 - Fix a typo reported by dsteinbrunner: - https://rt.cpan.org/Ticket/Display.html?id=86689 1.80 2013-01-23 - Bump the minimum version of libxslt2 to 1.1.28. - due to failures such as http://www.cpantesters.org/cpan/report/6f5029ee-639a-11e2-8465-2a97270fb964 1.79 2012-11-26 - Die when libxslt is 1.1.27. - Due to this bug - https://bugzilla.gnome.org/show_bug.cgi?id=684564 1.78 2012-09-06 - Add output_method method, update documentation of media_type (dorian@cpan). - Thanks, Dorian! 1.77 2012-02-25 - Apply a patch from Michael Ludwig clarifying the quoting of string parameters to the XSLT transformation. - Thanks, Michael! 1.76 2012-01-12 - Made LibXSLT.xs compile with C compilers that don't accept declarations inside blocks: - https://rt.cpan.org/Public/Bug/Display.html?id=73905 - These include Microsoft Visual C++ (in C-mode). 1.75 2011-10-28 - Convert the following test scripts from Test.pm to Test::More : - t/03input.t - Fix for https://rt.cpan.org/Public/Bug/Display.html?id=71345 by Tim Brody: - «segfault in free()» - Thanks, Tim! 1.74 2011-10-25 - Convert the following test scripts from Test.pm to Test::More : - t/01basic.t - t/02dromeds.t - t/04params.t - t/05quick.t - t/06output.t - t/06entities.t - t/07blankdoc.t - t/08literal.t - t/09exslt.t - t/10functions.t - t/11utf8.t - t/12import.t - t/13error.t - t/14security.t - t/15misc.t - In the process made "Encode" and perl-5.8.1. pre-requisites of this distribution. - Add the "make runtest" and "make distruntest" targets to test using Test-Run. 1.73 2011-10-09 - Possible fix for https://rt.cpan.org/Ticket/Display.html?id=71456 : - made the port reservation on t/14security.t for the non-existent URL more robust. 1.72 2011-10-06 - Moved the benchmarking code under benchmark/ so it won't be indexed by CPAN (Tim Brody). - Avoid leaking memory inside extension elements by cleaning up on stylesheet DESTROY (Tim Brody). - xsltInit() and xsltCleanupGlobals() to avoid leaking memory on init/shutdown (Tim Brody). - Added support for stylesheet context functions via a $stylesheet->register_function() method with the same arguments as XML::LibXSLT->register_function(). (Tim Brody) - Added support for register_element() on stylesheet objects. The callback may leak memory though - nothing frees the _private attributes of the node + document owner for the passed arguments? (Tim Brody) 1.71 2011-09-10 - Fixed https://rt.cpan.org/Ticket/Display.html?id=50487 : - add a blacklist for libxslt-1.1.25 which has a deadlock that hangs a test. - Fixed https://rt.cpan.org/Ticket/Display.html?id=52422 : - Unexpected webserver dependency in test - Updated the version control instructions in the README to bitbucket.org. 1.70 Unknown - fixed various bugs - documentation updates - #48247: Win32 patch kindly provided by KMX@cpan.org - sync with latest XML::LibXML ABI and add a compatibility check - do not force -lgcrypt and -lgpg-error linker flags - fix for attribute nodes returned by user-defined XPath functions - address #41542: restore internalDTD subset on the source document of a transformation (libxslt unlinks it) 1.68 Unknown - fix compilation problems - skip exslt tests if not available - added XML::LibXSLT::HAVE_EXSLT() (1/0) 1.67 Unknown - sync the binary internals to those of XML::LibXML 1.67 - update regression tests for compatibility with up-to-date libxslt 1.66 Unknown - bump requirements to libxslt 1.1.8 - sync the binary internals to those of XML::LibXML 1.66 1.63 Unknown - fix SIGSEGV regarding freeing nodes created by extension functions (reported by Elizabeth Mattijsen) - use pkg-config to determine linker flags for libexslt 1.62 Unknown - security callback interface contributed by Shane Corgatelli - check libxslt version - added XML::LibXML-like API to retrieve libxslt version - added output_as_bytes() and output_as_chars() - added regression tests for output_as_* to 11utf8.t - output_as_string documentation fixed to match reality - make 06entities.t to pass with older libxml2/libxslt - POD uses items instead of headings - fixed media_type and output_encoding for imported stylesheets [rt.cpan.org #23440] 1.61 Unknown - fixed error reporting: die on fatal errors, warn otherwise (in particular, warn rather than die on ) 1.60 Unknown - fix a huge memory leak in transform_file (bug #1314) - make it clear from the docs that output_string returns bytes (bug #8875) - added missing type-casting to fix compile-time warnings (bug #18508) - using call_* instead of perl_call_* (perl_ variants are obsolete) - in callbacks, POPs on error before croaking, otherwise it has no effect (and we probably leak) - added test case which used to fail (provided in rt #15723) - apply patch for Makefile.PL for non-standard libxslt paths (bug #16224) - fix segfault with registered functions returning nodes - fix leaks in parse_stylesheet - error reporting 1.59 Unknown - (revision bumped to match XML::LibCould not parse Line '0.95 & 0.96' at /home/shlomif/bin/upgrade-to-CPAN-Changes line 40, line 300. XML) - adapted for new XML::LibXML::InputCallback API - support for static linking against libxml2 1.57 Unknown - (revision bumped to match XML::LibXML) - Some minor fixes to perl extension functions support - Fixed callbacks support - Enable xinclude in XSLT files - Fixed some memory leaks - Fixed some segfaults 1.53 Unknown - Fixed ordering of params to perl extension funcs - Implemented nodelist and other data type passing to extension functions, and returning nodelist and elements (some code from Ido Ben-Zvi) - Slightly better error handling 1.52 Unknown - Perl extension functions (whee!) 1.51 Unknown - Mac OS X fixes - Cleaned up XPath quoting - Fixed document('') test (though if it still doesn't work in your code, see t/07blankdoc.t for details about how to make it work). 1.50 Unknown - Cleaned up media_type method so it doesn't segfault. 1.49 Unknown - Migrated to new XML::LibXML 1.49 (with new memory stuff) 1.31 Unknown - removed global callbacks - changed callbacks to using LibXML globals 1.30 Unknown - Compatibility with XML::LibXML 1.30 (esp callbacks) - EXSLT support - Better test files 1.09 Unknown - Some fixes and tests for document('') - Better have_library implementation in Makefile.PL 1.08 Unknown - Fixed Makefile.PL check for libxslt > 0.7.0 to work with 1.0.0 1.07 Unknown - Fixes to work with XML::LibXML 0.94 1.06 Unknown - Support text/html defaulting for media_type when document element is . - Support building on Win32 1.05 Unknown - More tests and fixes for media_type 1.04 Unknown - Fixed media_type method 1.03 Unknown - Added output_encoding and media_type methods 1.02 Unknown - Fixed Makefile.PL to work with libxslt 0.10 1.01 Unknown - Removed hack where we set dom->standalone = 42 to prevent XML::LibXML from garbage collecting - Removed XML::LibXML from the distribution. Now separate. 1.00 Unknown - More segfault fixes - Benchmark updates 0.99_01 Unknown - More segfault fixes 0.99 Unknown - Fixed segfaults on 5.00503 0.98 Unknown - Fixed output encoding problems 0.97 Unknown - Now needs libxslt 0.7.0 - Removed add_param() (now passed to transform()) - Makefile.PL works without gnome-config now XML-LibXSLT-1.95/LICENSE0000644000076400007640000000054011647605042014234 0ustar shlomifshlomifLICENSE ======= This is free software, you may use it and distribute it under the same terms as Perl itself. Copyright 2001-2006 AxKit.com Ltd. DISCLAIMER ========== THIS PROGRAM IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT WITHOUT ANY WARRANTY; WITHOUT EVEN THE IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. XML-LibXSLT-1.95/LibXSLT.pm0000644000076400007640000007413212747105501015013 0ustar shlomifshlomif# $Id$ # # This is free software, you may use it and distribute it under the same terms as # Perl itself. # # Copyright 2001-2009 AxKit.com Ltd. # # package XML::LibXSLT; use strict; use warnings; use 5.008; use vars qw($VERSION @ISA $USE_LIBXML_DATA_TYPES $MatchCB $ReadCB $OpenCB $CloseCB); sub REQUIRE_XML_LIBXML_ABI_VERSION { 2 } use XML::LibXML 1.70; use XML::LibXML::Literal; use XML::LibXML::Boolean; use XML::LibXML::Number; use XML::LibXML::NodeList; BEGIN { use Carp; require Exporter; $VERSION = '1.95'; require DynaLoader; @ISA = qw(DynaLoader); # avoid possible shared library name conflict on Win32 # not using this trick on 5.10.0 (suffering from DynaLoader bug) local $DynaLoader::dl_dlext = "xs.$DynaLoader::dl_dlext" if (($^O eq 'MSWin32') && ($] ne '5.010000')); bootstrap XML::LibXSLT $VERSION; # the following magic lets XML::LibXSLT internals know # where to register XML::LibXML proxy nodes INIT_THREAD_SUPPORT() if XML::LibXML::threads_shared_enabled(); $USE_LIBXML_DATA_TYPES = 0; } sub new { my $class = shift; my %options = @_; my $self = bless \%options, $class; return $self; } # ido - perl dispatcher sub perl_dispatcher { my $func = shift; my $owner_doc = shift; my @params = @_; my @perlParams; my $i = 0; while (@params) { my $type = shift(@params); if ($type eq 'XML::LibXML::Literal' or $type eq 'XML::LibXML::Number' or $type eq 'XML::LibXML::Boolean') { my $val = shift(@params); unshift(@perlParams, $USE_LIBXML_DATA_TYPES ? $type->new($val) : $val); } elsif ($type eq 'XML::LibXML::NodeList') { my $node_count = shift(@params); my @nodes = splice(@params, 0, $node_count); # warn($_->getName) for @nodes; unshift(@perlParams, $type->new(@nodes)); } } $func = "main::$func" unless ref($func) || $func =~ /(.+)::/; no strict 'refs'; my $res = $func->(@perlParams); return $res; } sub xpath_to_string { my @results; while (@_) { my $value = shift(@_); $value = '' unless defined $value; push @results, $value; if (@results % 2) { # key $results[-1] =~ s/:/_/g; # XSLT doesn't like names with colons } else { if ($value =~ s/'/', "'", '/g) { $results[-1] = "concat('$value')"; } else { $results[-1] = "'$results[-1]'"; } } } return @results; } #-------------------------------------------------------------------------# # callback functions # #-------------------------------------------------------------------------# sub security_callbacks { my $self = shift; my $scbclass = shift; if ( defined $scbclass ) { $self->{XML_LIBXSLT_SECPREFS} = $scbclass; } return $self->{XML_LIBXSLT_SECPREFS}; } sub input_callbacks { my $self = shift; my $icbclass = shift; if ( defined $icbclass ) { $self->{XML_LIBXSLT_CALLBACK_STACK} = $icbclass; } return $self->{XML_LIBXSLT_CALLBACK_STACK}; } sub match_callback { my $self = shift; if ( ref $self ) { if ( scalar @_ ) { $self->{XML_LIBXSLT_MATCH_CB} = shift; $self->{XML_LIBXSLT_CALLBACK_STACK} = undef; } return $self->{XML_LIBXSLT_MATCH_CB}; } else { $MatchCB = shift if scalar @_; return $MatchCB; } } sub read_callback { my $self = shift; if ( ref $self ) { if ( scalar @_ ) { $self->{XML_LIBXSLT_READ_CB} = shift; $self->{XML_LIBXSLT_CALLBACK_STACK} = undef; } return $self->{XML_LIBXSLT_READ_CB}; } else { $ReadCB = shift if scalar @_; return $ReadCB; } } sub close_callback { my $self = shift; if ( ref $self ) { if ( scalar @_ ) { $self->{XML_LIBXSLT_CLOSE_CB} = shift; $self->{XML_LIBXSLT_CALLBACK_STACK} = undef; } return $self->{XML_LIBXSLT_CLOSE_CB}; } else { $CloseCB = shift if scalar @_; return $CloseCB; } } sub open_callback { my $self = shift; if ( ref $self ) { if ( scalar @_ ) { $self->{XML_LIBXSLT_OPEN_CB} = shift; $self->{XML_LIBXSLT_CALLBACK_STACK} = undef; } return $self->{XML_LIBXSLT_OPEN_CB}; } else { $OpenCB = shift if scalar @_; return $OpenCB; } } sub callbacks { my $self = shift; if ( ref $self ) { if (@_) { my ($match, $open, $read, $close) = @_; @{$self}{qw(XML_LIBXSLT_MATCH_CB XML_LIBXSLT_OPEN_CB XML_LIBXSLT_READ_CB XML_LIBXSLT_CLOSE_CB)} = ($match, $open, $read, $close); $self->{XML_LIBXSLT_CALLBACK_STACK} = undef; } else { return @{$self}{qw(XML_LIBXSLT_MATCH_CB XML_LIBXSLT_OPEN_CB XML_LIBXSLT_READ_CB XML_LIBXSLT_CLOSE_CB)}; } } else { if (@_) { ( $MatchCB, $OpenCB, $ReadCB, $CloseCB ) = @_; } else { return ( $MatchCB, $OpenCB, $ReadCB, $CloseCB ); } } } sub _init_callbacks{ my $self = shift; my $icb = $self->{XML_LIBXSLT_CALLBACK_STACK}; unless ( defined $icb ) { $self->{XML_LIBXSLT_CALLBACK_STACK} = XML::LibXML::InputCallback->new(); $icb = $self->{XML_LIBXSLT_CALLBACK_STACK}; } my $mcb = $self->match_callback(); my $ocb = $self->open_callback(); my $rcb = $self->read_callback(); my $ccb = $self->close_callback(); if ( defined $mcb and defined $ocb and defined $rcb and defined $ccb ) { $icb->register_callbacks( [$mcb, $ocb, $rcb, $ccb] ); } $icb->init_callbacks(); } sub _cleanup_callbacks { my $self = shift; $self->{XML_LIBXSLT_CALLBACK_STACK}->cleanup_callbacks(); my $mcb = $self->match_callback(); if ( defined $mcb ) { $self->{XML_LIBXSLT_CALLBACK_STACK}->unregister_callbacks( [$mcb] ); } } sub parse_stylesheet { my $self = shift; $self->_init_callbacks(); my $stylesheet; eval { $stylesheet = $self->_parse_stylesheet(@_); }; $self->_cleanup_callbacks(); my $err = $@; if ($err) { croak $err; } my $rv = { XML_LIBXSLT_STYLESHEET => $stylesheet, XML_LIBXSLT_CALLBACK_STACK => $self->{XML_LIBXSLT_CALLBACK_STACK}, XML_LIBXSLT_MATCH_CB => $self->{XML_LIBXSLT_MATCH_CB}, XML_LIBXSLT_OPEN_CB => $self->{XML_LIBXSLT_OPEN_CB}, XML_LIBXSLT_READ_CB => $self->{XML_LIBXSLT_READ_CB}, XML_LIBXSLT_CLOSE_CB => $self->{XML_LIBXSLT_CLOSE_CB}, XML_LIBXSLT_SECPREFS => $self->{XML_LIBXSLT_SECPREFS}, XML_LIBXSLT_FUNCTIONS => {}, XML_LIBXSLT_ELEMENTS => {}, }; return bless $rv, "XML::LibXSLT::StylesheetWrapper"; } sub parse_stylesheet_file { my $self = shift; $self->_init_callbacks(); my $stylesheet; eval { $stylesheet = $self->_parse_stylesheet_file(@_); }; $self->_cleanup_callbacks(); my $err = $@; if ($err) { croak $err; } my $rv = { XML_LIBXSLT_STYLESHEET => $stylesheet, XML_LIBXSLT_CALLBACK_STACK => $self->{XML_LIBXSLT_CALLBACK_STACK}, XML_LIBXSLT_MATCH_CB => $self->{XML_LIBXSLT_MATCH_CB}, XML_LIBXSLT_OPEN_CB => $self->{XML_LIBXSLT_OPEN_CB}, XML_LIBXSLT_READ_CB => $self->{XML_LIBXSLT_READ_CB}, XML_LIBXSLT_CLOSE_CB => $self->{XML_LIBXSLT_CLOSE_CB}, XML_LIBXSLT_SECPREFS => $self->{XML_LIBXSLT_SECPREFS}, XML_LIBXSLT_FUNCTIONS => {}, XML_LIBXSLT_ELEMENTS => {}, }; return bless $rv, "XML::LibXSLT::StylesheetWrapper"; } sub register_xslt_module { my $self = shift; my $module = shift; # Not implemented } 1; package XML::LibXSLT::StylesheetWrapper; use strict; use vars qw($MatchCB $ReadCB $OpenCB $CloseCB); use XML::LibXML; use Carp; sub security_callbacks { my $self = shift; my $scbclass = shift; if ( defined $scbclass ) { $self->{XML_LIBXSLT_SECPREFS} = $scbclass; } return $self->{XML_LIBXSLT_SECPREFS}; } sub input_callbacks { my $self = shift; my $icbclass = shift; if ( defined $icbclass ) { $self->{XML_LIBXSLT_CALLBACK_STACK} = $icbclass; } return $self->{XML_LIBXSLT_CALLBACK_STACK}; } sub match_callback { my $self = shift; if ( ref $self ) { if ( scalar @_ ) { $self->{XML_LIBXSLT_MATCH_CB} = shift; $self->{XML_LIBXSLT_CALLBACK_STACK} = undef; } return $self->{XML_LIBXSLT_MATCH_CB}; } else { $MatchCB = shift if scalar @_; return $MatchCB; } } sub read_callback { my $self = shift; if ( ref $self ) { if ( scalar @_ ) { $self->{XML_LIBXSLT_READ_CB} = shift; $self->{XML_LIBXSLT_CALLBACK_STACK} = undef; } return $self->{XML_LIBXSLT_READ_CB}; } else { $ReadCB = shift if scalar @_; return $ReadCB; } } sub close_callback { my $self = shift; if ( ref $self ) { if ( scalar @_ ) { $self->{XML_LIBXSLT_CLOSE_CB} = shift; $self->{XML_LIBXSLT_CALLBACK_STACK} = undef; } return $self->{XML_LIBXSLT_CLOSE_CB}; } else { $CloseCB = shift if scalar @_; return $CloseCB; } } sub open_callback { my $self = shift; if ( ref $self ) { if ( scalar @_ ) { $self->{XML_LIBXSLT_OPEN_CB} = shift; $self->{XML_LIBXSLT_CALLBACK_STACK} = undef; } return $self->{XML_LIBXSLT_OPEN_CB}; } else { $OpenCB = shift if scalar @_; return $OpenCB; } } sub callbacks { my $self = shift; if ( ref $self ) { if (@_) { my ($match, $open, $read, $close) = @_; @{$self}{qw(XML_LIBXSLT_MATCH_CB XML_LIBXSLT_OPEN_CB XML_LIBXSLT_READ_CB XML_LIBXSLT_CLOSE_CB)} = ($match, $open, $read, $close); $self->{XML_LIBXSLT_CALLBACK_STACK} = undef; } else { return @{$self}{qw(XML_LIBXSLT_MATCH_CB XML_LIBXSLT_OPEN_CB XML_LIBXSLT_READ_CB XML_LIBXSLT_CLOSE_CB)}; } } else { if (@_) { ( $MatchCB, $OpenCB, $ReadCB, $CloseCB ) = @_; } else { return ( $MatchCB, $OpenCB, $ReadCB, $CloseCB ); } } } sub _init_callbacks { my $self = shift; my $icb = $self->{XML_LIBXSLT_CALLBACK_STACK}; unless ( defined $icb ) { $self->{XML_LIBXSLT_CALLBACK_STACK} = XML::LibXML::InputCallback->new(); $icb = $self->{XML_LIBXSLT_CALLBACK_STACK}; } my $mcb = $self->match_callback(); my $ocb = $self->open_callback(); my $rcb = $self->read_callback(); my $ccb = $self->close_callback(); if ( defined $mcb and defined $ocb and defined $rcb and defined $ccb ) { $icb->register_callbacks( [$mcb, $ocb, $rcb, $ccb] ); } $icb->init_callbacks(); my $scb = $self->{XML_LIBXSLT_SECPREFS}; if ( $scb ) { $scb->init_callbacks(); } } sub _cleanup_callbacks { my $self = shift; $self->{XML_LIBXSLT_CALLBACK_STACK}->cleanup_callbacks(); my $mcb = $self->match_callback(); if ( defined $mcb ) { $self->{XML_LIBXSLT_CALLBACK_STACK}->unregister_callbacks( [$mcb] ); } my $scb = $self->{XML_LIBXSLT_SECPREFS}; if ( $scb ) { $scb->cleanup_callbacks(); } } sub transform { my $self = shift; my $doc; $self->_init_callbacks(); eval { $doc = $self->{XML_LIBXSLT_STYLESHEET}->transform($self,@_); }; $self->_cleanup_callbacks(); my $err = $@; if ($err) { croak $err; } return $doc; } sub transform_file { my $self = shift; my $doc; $self->_init_callbacks(); eval { $doc = $self->{XML_LIBXSLT_STYLESHEET}->transform_file($self,@_); }; $self->_cleanup_callbacks(); my $err = $@; if ($err) { croak $err; } return $doc; } sub register_function { my $self = shift; $self->{XML_LIBXSLT_FUNCTIONS}->{"{$_[0]}$_[1]"} = [@_[0,1,2]]; } sub register_element { my $self = shift; $self->{XML_LIBXSLT_ELEMENTS}->{"{$_[0]}$_[1]"} = [@_[0,1,2]]; } sub output_string { shift->{XML_LIBXSLT_STYLESHEET}->_output_string($_[0],0) } sub output_as_bytes { shift->{XML_LIBXSLT_STYLESHEET}->_output_string($_[0],1) } sub output_as_chars { shift->{XML_LIBXSLT_STYLESHEET}->_output_string($_[0],2) } sub output_fh { shift->{XML_LIBXSLT_STYLESHEET}->output_fh(@_) } sub output_file { shift->{XML_LIBXSLT_STYLESHEET}->output_file(@_) } sub media_type { shift->{XML_LIBXSLT_STYLESHEET}->media_type(@_) } sub output_method { shift->{XML_LIBXSLT_STYLESHEET}->output_method(@_) } sub output_encoding { shift->{XML_LIBXSLT_STYLESHEET}->output_encoding(@_) } 1; # XML::LibXSLT::Security Interface # #-------------------------------------------------------------------------# package XML::LibXSLT::Security; use strict; use Carp; use vars qw(%OPTION_MAP %_GLOBAL_CALLBACKS); # Maps the option names used in the perl interface to the numeric values # used by libxslt. my %OPTION_MAP = ( read_file => 1, write_file => 2, create_dir => 3, read_net => 4, write_net => 5, ); %_GLOBAL_CALLBACKS = (); #-------------------------------------------------------------------------# # global callback # #-------------------------------------------------------------------------# sub _security_check { my $option = shift; my $retval = 1; if ($option == 3) { $retval = 0; # Default create_dir to no access } if (exists $_GLOBAL_CALLBACKS{$option}) { $retval = $_GLOBAL_CALLBACKS{$option}->(@_); } return $retval; } #-------------------------------------------------------------------------# # member functions and methods # #-------------------------------------------------------------------------# sub new { my $class = shift; return bless {'_CALLBACKS' => {}}, $class; } # Add a callback for the given security option (read_file, write_file, # create_dir, read_net, write_net). # # To register a callback that handle network read requests: # $scb->register_callback( read_net => \&callback ); sub register_callback { my $self = shift; my $option = shift; my $callback = shift; unless ( exists $OPTION_MAP{$option} ) { croak "Invalid security option '$option'. Must be one of: " . join(', ', keys %OPTION_MAP) . "."; } if ( ref $callback eq 'CODE' ) { $self->{_CALLBACKS}{ $OPTION_MAP{$option} } = $callback; } else { croak "Invalid argument. The callback must be a reference to a subroutine"; } } # Removes the callback for the given security option. Causes the given option # to use the default security handler (which always allows the action). sub unregister_callback { my $self = shift; my $option = shift; unless ( exists $OPTION_MAP{$option} ) { croak "Invalid security option '$option'. Must be one of: " . join(', ', keys %OPTION_MAP) . "."; } delete $self->{_CALLBACKS}{ $OPTION_MAP{$option} }; } # make it so libxslt can use the callbacks sub init_callbacks { my $self = shift; %_GLOBAL_CALLBACKS = %{ $self->{_CALLBACKS} }; } # reset libxslt callbacks sub cleanup_callbacks { my $self = shift; %_GLOBAL_CALLBACKS = (); } 1; __END__ =head1 NAME XML::LibXSLT - Interface to the GNOME libxslt library =head1 SYNOPSIS use XML::LibXSLT; use XML::LibXML; my $xslt = XML::LibXSLT->new(); my $source = XML::LibXML->load_xml(location => 'foo.xml'); my $style_doc = XML::LibXML->load_xml(location=>'bar.xsl', no_cdata=>1); my $stylesheet = $xslt->parse_stylesheet($style_doc); my $results = $stylesheet->transform($source); print $stylesheet->output_as_bytes($results); =head1 DESCRIPTION This module is an interface to the GNOME project's libxslt. This is an extremely good XSLT engine, highly compliant and also very fast. I have tests showing this to be more than twice as fast as Sablotron. =head1 OPTIONS XML::LibXSLT has some global options. Note that these are probably not thread or even fork safe - so only set them once per process. Each one of these options can be called either as class methods, or as instance methods. However either way you call them, it still sets global options. Each of the option methods returns its previous value, and can be called without a parameter to retrieve the current value. =over =item max_depth XML::LibXSLT->max_depth(1000); This option sets the maximum recursion depth for a stylesheet. See the very end of section 5.4 of the XSLT specification for more details on recursion and detecting it. If your stylesheet or XML file requires seriously deep recursion, this is the way to set it. Default value is 250. =item max_vars XML::LibXSLT->max_vars(100_000); This option sets the maximum number of variables for a stylesheet. If your stylesheet or XML file requires many variables, this is the way to increase their limit. Default value is system-specific and may vary. =item debug_callback XML::LibXSLT->debug_callback($subref); Sets a callback to be used for debug messages. If you don't set this, debug messages will be ignored. =item register_function XML::LibXSLT->register_function($uri, $name, $subref); $stylesheet->register_function($uri, $name, $subref); Registers an XSLT extension function mapped to the given URI. For example: XML::LibXSLT->register_function("urn:foo", "bar", sub { scalar localtime }); Will register a C function in the C namespace (which you have to define in your XSLT using C) that will return the current date and time as a string: The time is: Parameters can be in whatever format you like. If you pass in a nodelist it will be a XML::LibXML::NodeList object in your perl code, but ordinary values (strings, numbers and booleans) will be ordinary perl scalars. If you wish them to be C, C and C values respectively then set the variable C<$XML::LibXSLT::USE_LIBXML_DATA_TYPES> to a true value. Return values can be a nodelist or a plain value - the code will just do the right thing. But only a single return value is supported (a list is not converted to a nodelist). =item register_element $stylesheet->register_element($uri, $name, $subref) Registers an XSLT extension element $name mapped to the given URI. For example: $stylesheet->register_element("urn:foo", "hello", sub { my $name = $_[2]->getAttribute( "name" ); return XML::LibXML::Text->new( "Hello, $name!" ); }); Will register a C element in the C namespace that returns a "Hello, X!" text node. You must define this namespace in your XSLT and include its prefix in the C list: The callback is passed the input document node as $_[1] and the stylesheet node as $_[2]. $_[0] is reserved for future use. =back =head1 API The following methods are available on the new XML::LibXSLT object: =over =item parse_stylesheet($stylesheet_doc) C<$stylesheet_doc> here is an XML::LibXML::Document object (see L) representing an XSLT file. This method will return a XML::LibXSLT::Stylesheet object, or undef on failure. If the XSLT is invalid, an exception will be thrown, so wrap the call to parse_stylesheet in an eval{} block to trap this. IMPORTANT: C<$stylesheet_doc> should not contain CDATA sections, otherwise libxslt may misbehave. The best way to assure this is to load the stylesheet with no_cdata flag, e.g. my $stylesheet_doc = XML::LibXML->load_xml(location=>"some.xsl", no_cdata=>1); =item parse_stylesheet_file($filename) Exactly the same as the above, but parses the given filename directly. =back =head1 Input Callbacks To define XML::LibXSLT or XML::LibXSLT::Stylesheet specific input callbacks, reuse the XML::LibXML input callback API as described in L. =over 4 =item input_callbacks($icb) Enable the callbacks in C<$icb> only for this XML::LibXSLT object. C<$icb> should be a C object. This will call C and C automatically during parsing or transformation. =back =head1 Security Callbacks To create security preferences for the transformation see L. Once the security preferences have been defined you can apply them to an XML::LibXSLT or XML::LibXSLT::Stylesheet instance using the C method. =head1 XML::LibXSLT::Stylesheet The main API is on the stylesheet, though it is fairly minimal. One of the main advantages of XML::LibXSLT is that you have a generic stylesheet object which you call the transform() method passing in a document to transform. This allows you to have multiple transformations happen with one stylesheet without requiring a reparse. =over =item transform(doc, %params) my $results = $stylesheet->transform($doc, foo => "'bar'"); print $stylesheet->output_as_bytes($results); Transforms the passed in XML::LibXML::Document object, and returns a new XML::LibXML::Document. Extra hash entries are used as parameters. Be sure to keep in mind the caveat with regard to quotes explained in the section on L below. =item transform_file(filename, %params) my $results = $stylesheet->transform_file($filename, bar => "'baz'"); Note the string parameter caveat, detailed in the section on L below. =item output_as_bytes(result) Returns a scalar that is the XSLT rendering of the XML::LibXML::Document object using the desired output format (specified in the xsl:output tag in the stylesheet). Note that you can also call $result->toString, but that will *always* output the document in XML format which may not be what you asked for in the xsl:output tag. The scalar is a byte string encoded in the output encoding specified in the stylesheet. =item output_as_chars(result) Like C, but always return the output as (UTF-8 encoded) string of characters. =item output_string(result) DEPRECATED: This method is something between C and C: The scalar returned by this function appears to Perl as characters (UTF8 flag is on) if the output encoding specified in the XSLT stylesheet was UTF-8 and as bytes if no output encoding was specified or if the output encoding was other than UTF-8. Since the behavior of this function depends on the particular stylesheet, it is deprecated in favor of C and C. =item output_fh(result, fh) Outputs the result to the filehandle given in C<$fh>. =item output_file(result, filename) Outputs the result to the file named in C<$filename>. =item output_encoding() Returns the output encoding of the results. Defaults to "UTF-8". =item output_method() Returns the value of the C attribute from C (usually C, C or C). If this attribute is unspecified, the default value is initially C. If the L method is used to produce an HTML document, as per the L, the default value will change to C. To override this behavior completely, supply an C element in the stylesheet source document. =item media_type() Returns the value of the C attribute from C. If this attribute is unspecified, the default media type is initially C. This default changes to C under the same conditions as L. =item input_callbacks($icb) Enable the callbacks in C<$icb> only for this stylesheet. C<$icb> should be a C object. This will call C and C automatically during transformation. =back =cut =head1 Parameters LibXSLT expects parameters in XPath format. That is, if you wish to pass a string to the XSLT engine, you actually have to pass it as a quoted string: $stylesheet->transform($doc, param => "'string'"); Note the quotes within quotes there! Obviously this isn't much fun, so you can make it easy on yourself: $stylesheet->transform($doc, XML::LibXSLT::xpath_to_string( param => "string" )); The utility function does the right thing with respect to strings in XPath, including when you have quotes already embedded within your string. =head1 XML::LibXSLT::Security Provides an interface to the libxslt security framework by allowing callbacks to be defined that can restrict access to various resources (files or URLs) during a transformation. The libxslt security framework allows callbacks to be defined for certain actions that a stylesheet may attempt during a transformation. It may be desirable to restrict some of these actions (for example, writing a new file using exsl:document). The actions that may be restricted are: =over =item read_file Called when the stylesheet attempts to open a local file (ie: when using the document() function). =item write_file Called when an attempt is made to write a local file (ie: when using the exsl:document element). =item create_dir Called when a directory needs to be created in order to write a file. NOTE: By default, create_dir is not allowed. To enable it a callback must be registered. =item read_net Called when the stylesheet attempts to read from the network. =item write_net Called when the stylesheet attempts to write to the network. =back =head2 Using XML::LibXSLT::Security The interface for this module is similar to XML::LibXML::InputCallback. After creating a new instance you may register callbacks for each of the security options listed above. Then you apply the security preferences to the XML::LibXSLT or XML::LibXSLT::Stylesheet object using C. my $security = XML::LibXSLT::Security->new(); $security->register_callback( read_file => $read_cb ); $security->register_callback( write_file => $write_cb ); $security->register_callback( create_dir => $create_cb ); $security->register_callback( read_net => $read_net_cb ); $security->register_callback( write_net => $write_net_cb ); $xslt->security_callbacks( $security ); -OR- $stylesheet->security_callbacks( $security ); The registered callback functions are called when access to a resource is requested. If the access should be allowed the callback should return 1, if not it should return 0. The callback functions should accept the following arguments: =over =item $tctxt This is the transform context (XML::LibXSLT::TransformContext). You can use this to get the current XML::LibXSLT::Stylesheet object by calling C. my $stylesheet = $tctxt->stylesheet(); The stylesheet object can then be used to share contextual information between different calls to the security callbacks. =item $value This is the name of the resource (file or URI) that has been requested. =back If a particular option (except for C) doesn't have a registered callback, then the stylesheet will have full access for that action. =head2 Interface =over =item new() Creates a new XML::LibXSLT::Security object. =item register_callback( $option, $callback ) Registers a callback function for the given security option (listed above). =item unregister_callback( $option ) Removes the callback for the given option. This has the effect of allowing all access for the given option (except for C). =back =head1 BENCHMARK Included in the distribution is a simple benchmark script, which has two drivers - one for LibXSLT and one for Sablotron. The benchmark requires the testcases files from the XSLTMark distribution which you can find at http://www.datapower.com/XSLTMark/ Put the testcases directory in the directory created by this distribution, and then run: perl benchmark.pl -h to get a list of options. The benchmark requires XML::XPath at the moment, but I hope to factor that out of the equation fairly soon. It also requires Time::HiRes, which I could be persuaded to factor out, replacing it with Benchmark.pm, but I haven't done so yet. I would love to get drivers for XML::XSLT and XML::Transformiix, if you would like to contribute them. Also if you get this running on Win32, I'd love to get a driver for MSXSLT via OLE, to see what we can do against those Redmond boys! =head1 LIBRARY VERSIONS For debugging purposes, XML::LibXSLT provides version information about the libxslt C library (but do not confuse it with the version number of XML::LibXSLT module itself, i.e. with C<$XML::LibXSLT::VERSION>). XML::LibXSLT issues a warning if the runtime version of the library is less then the compile-time version. =over =item XML::LibXSLT::LIBXSLT_VERSION() Returns version number of libxslt library which was used to compile XML::LibXSLT as an integer. For example, for libxslt-1.1.18, it will return 10118. =item XML::LibXSLT::LIBXSLT_DOTTED_VERSION() Returns version number of libxslt library which was used to compile XML::LibXSLT as a string, e.g. "1.1.18". =item XML::LibXSLT::LIBXSLT_RUNTIME_VERSION() Returns version number of libxslt library to which XML::LibXSLT is linked at runtime (either dynamically or statically). For example, for example, for libxslt.so.1.1.18, it will return 10118. =item XML::LibXSLT::HAVE_EXLT() Returns 1 if the module was compiled with libexslt, 0 otherwise. =back =head1 LICENSE This is free software, you may use it and distribute it under the same terms as Perl itself. Copyright 2001-2009, AxKit.com Ltd. =head1 AUTHOR Matt Sergeant, matt@sergeant.org Security callbacks implementation contributed by Shane Corgatelli. =head1 MAINTAINER Petr Pajas , pajas@matfyz.org =head1 BUGS Please report bugs via http://rt.cpan.org/NoAuth/Bugs.html?Dist=XML-LibXSLT =head1 SEE ALSO XML::LibXML =cut XML-LibXSLT-1.95/MANIFEST0000644000076400007640000000172312747105601014362 0ustar shlomifshlomifChanges LICENSE LibXSLT.pm LibXSLT.xs MANIFEST Makefile.PL README benchmark/Driver/BaseClass.pm benchmark/Driver/LibXSLT.pm benchmark/Driver/Sablotron.pm benchmark/benchmark.pl example/1.xml example/1.xsl example/2.xml example/2.xsl example/bad1.xsl example/bad2.xsl example/bad3.xsl example/fatal.xsl example/nonfatal.xsl perl-libxml-mm.c perl-libxml-mm.h ppport.h scripts/tag-release.pl t/01basic.t t/02dromeds.t t/03input.t t/04params.t t/05quick.t t/06entities.t t/06output.t t/07blankdoc.t t/08literal.t t/09exslt.t t/10functions.t t/11utf8.t t/12import.t t/13error.t t/14security.t t/15misc.t t/cpan-changes.t t/data/perl-begin-page.xml-grammar-vered.xml t/data/vered-xml-to-docbook.xslt t/pod.t t/rt71345_a.t t/rt71345_b.t t/style-trailing-space.t t/xml-grammar-failures.t testcases/default.conf typemap META.yml Module YAML meta-data (added by MakeMaker) META.json Module JSON meta-data (added by MakeMaker) XML-LibXSLT-1.95/testcases/0000755000076400007640000000000012747105600015223 5ustar shlomifshlomifXML-LibXSLT-1.95/testcases/default.conf0000644000076400007640000001160111647605042017520 0ustar shlomifshlomif[alphabetize] input=db100.xml stylesheet=alphabetize.xsl output=alphabetize.out reference=alphabetize.ref iterations=10 skipdriver=ExternalDriver:txdriver [attsets] input=chart.xml stylesheet=attsets.xsl output=attsets.out reference=attsets.ref iterations=100 [avts] input=db100.xml stylesheet=avts.xsl output=avts.out reference=avts.ref iterations=100 [axis] input=axis.xml stylesheet=axis.xsl output=axis.out reference=axis.ref iterations=100 skipdriver=Sablotron [backwards] input=game.xml stylesheet=backwards.xsl output=backwards.out reference=backwards.ref iterations=100 skipdriver=ExternalDriver:txdriver [bottles] input=bottles.xml stylesheet=bottles.xsl output=bottles.out reference=bottles.ref iterations=100 skipdriver=ExternalDriver:txdriver;Sablotron [breadth] input=breadth.xml stylesheet=find.xsl output=breadth.out reference=breadth.ref iterations=100 [brutal] input=brutal.xml stylesheet=brutal.xsl output=brutal.out reference=brutal.ref iterations=100 skipdriver=Sablotron [chart] input=chart.xml stylesheet=chart.xsl output=chart.out reference=chart.ref iterations=100 skipdriver=ExternalDriver:txdriver;Sablotron [creation] input=db100.xml stylesheet=creation.xsl output=creation.out reference=creation.ref iterations=50 [current] input=current.xml stylesheet=current.xsl output=current.out reference=current.ref iterations=100 skipdriver=Sablotron [dbonerow] input=db10000.xml stylesheet=dbonerow.xsl output=dbonerow.out reference=dbonerow.ref iterations=10 skipdriver=ExternalDriver:txdriver [dbtail] input=db100.xml stylesheet=dbtail.xsl output=dbtail.out reference=dbtail.ref iterations=100 [decoy] input=db100.xml stylesheet=decoy.xsl output=decoy.out reference=patterns.ref iterations=100 skipdriver=ExternalDriver:txdriver [depth] input=depth.xml stylesheet=find.xsl output=depth.out reference=depth.ref iterations=100 skipdriver=XalanJDriver [encrypt] input=db100.xml stylesheet=encrypt.xsl output=encrypt.out reference=encrypt.ref iterations=10 [functions] input=db100.xml stylesheet=functions.xsl output=functions.out reference=functions.ref iterations=100 skipdriver=ExternalDriver:txdriver [game] input=game.xml stylesheet=game.xsl output=game.out reference=game.ref iterations=100 skipdriver=ExternalDriver:txdriver [html] input=html.xml stylesheet=html.xsl output=html.out reference=html.ref iterations=100 skipdriver=ExternalDriver:txdriver [identity] input=db1000.xml stylesheet=identity.xsl output=identity.out reference=identity.ref iterations=10 [inventory] input=inventory.xml stylesheet=inventory.xsl output=inventory.out reference=inventory.ref iterations=100 [metric] input=metric.xml stylesheet=metric.xsl output=metric.out reference=metric.ref iterations=100 skipdriver=ExternalDriver:txdriver [number] input=number.xml stylesheet=number.xsl output=number.out iterations=100 skipdriver=ExternalDriver:txdriver [oddtemplate] input=oddtemplate.xml stylesheet=oddtemplate.xsl output=oddtemplate.out reference=oddtemplate.ref iterations=100 skipdriver=ExternalDriver:txdriver [patterns] input=db100.xml stylesheet=patterns.xsl output=patterns.out reference=patterns.ref iterations=100 skipdriver=ExternalDriver:txdriver [prettyprint] input=db100.xml stylesheet=prettyprint.xsl output=prettyprint.out reference=prettyprint.ref iterations=10 skipdriver=ExternalDriver:txdriver [priority] input=priority.xml stylesheet=priority.xsl output=priority.out reference=priority.ref iterations=100 [products] input=products.xml stylesheet=products.xsl output=products.out reference=products.ref iterations=100 skipdriver=Sablotron [queens] input=queens.xml stylesheet=queens.xsl output=queens.out reference=queens.ref iterations=10 skipdriver=ExternalDriver:txdriver [reverser] input=gettysburg.xml stylesheet=reverser.xsl output=reverser.out reference=reverser.ref iterations=100 skipdriver=ExternalDriver:txdriver [stringsort] input=db1000.xml stylesheet=stringsort.xsl output=stringsort.out reference=stringsort.ref iterations=10 [summarize] input=queens.xsl stylesheet=summarize.xsl output=summarize.out reference=summarize.ref iterations=100 [total] input=chart.xml stylesheet=total.xsl output=total.out reference=total.ref iterations=100 skipdriver=ExternalDriver:txdriver [tower] input=tower.xml stylesheet=tower.xsl output=tower.out reference=tower.ref iterations=20 skipdriver=ExternalDriver:txdriver [trend] input=trend.xml stylesheet=trend.xsl output=trend.out reference=trend.ref iterations=100 skipdriver=ExternalDriver:txdriver [union] input=union.xml stylesheet=union.xsl output=union.out reference=union.ref iterations=100 [xpath] input=xpath.xml stylesheet=xpath.xsl output=xpath.out reference=xpath.ref iterations=100 [xslbench1] input=xslbench1.xml stylesheet=xslbench1.xsl output=xslbench1.out iterations=100 [xslbench2] input=xslbenchdream.xml stylesheet=xslbench2.xsl output=xslbench2.out iterations=20 [xslbench3] input=xslbenchdream.xml stylesheet=xslbench3.xsl output=xslbench3.out iterations=20 XML-LibXSLT-1.95/example/0000755000076400007640000000000012747105600014660 5ustar shlomifshlomifXML-LibXSLT-1.95/example/fatal.xsl0000644000076400007640000000035111647605042016501 0ustar shlomifshlomif Fatal message. XML-LibXSLT-1.95/example/2.xml0000644000076400007640000000001511647605042015542 0ustar shlomifshlomif XML-LibXSLT-1.95/example/bad3.xsl0000644000076400007640000000032411647605042016223 0ustar shlomifshlomif XML-LibXSLT-1.95/example/nonfatal.xsl0000644000076400007640000000033511647605042017216 0ustar shlomifshlomif Non-fatal message. XML-LibXSLT-1.95/example/1.xml0000644000076400007640000000173411647605042015552 0ustar shlomifshlomif Brian Behlendorf: Apache co-founder talks about open source InfoWorld.com http://www.infoworld.com/articles/hn/xml/00/11/17/001117hnapache.xml 20001117 "the fact that we don't have a multibillion-dollar marketing organization means that, sure, Microsoft is going to be able to claim things or do things that we can't, but that hasn't hurt us so far." Apache founders hit Vegas in search of cash http://www.infoworld.com/articles/hn/xml/00/11/13/001113hnapache.xml InfoWorld.com 20001113 "Behlendorf said the ASF may need to look for a little cash to keep up with the demands that developing the leading Web server requires" XML-LibXSLT-1.95/example/bad2.xsl0000644000076400007640000000032711647605042016225 0ustar shlomifshlomif XML-LibXSLT-1.95/example/1.xsl0000644000076400007640000000653512321504720015553 0ustar shlomifshlomif Apache in the News

Apache in the News -

Since becoming the #1 Web server, Apache has featured in a number of reviews and articles. If you have seen a story about Apache on the Web or in the press let us know so that we can include it here.

Also check out the awards won by the Apache software.

, ""

January February March April May June July August September October November December : XML-LibXSLT-1.95/example/2.xsl0000644000076400007640000000050211647605042015551 0ustar shlomifshlomif ]> &foo; XML-LibXSLT-1.95/example/bad1.xsl0000644000076400007640000000031011647605042016214 0ustar shlomifshlomif XML-LibXSLT-1.95/Makefile.PL0000644000076400007640000003413412747105115015205 0ustar shlomifshlomif# -------------------------------------------------------------------------- # # $Id$ # -------------------------------------------------------------------------- # # Makefile.PL for XML::LibXML. # This file is required to generate a localized Makefile # -------------------------------------------------------------------------- # use strict; use warnings; use vars qw/$DEVNULL $is_Win32/; BEGIN { if ($] < 5.008_001) { warn "\nSorry, at least Perl 5.8.1 is required for this module!\n\n"; exit; } } use ExtUtils::MakeMaker; use Config; $|=0; my %config; while($_ = shift) { my ($key, $val) = split(/=/, $_, 2); $config{$key} = $val; } my $DEBUG = delete $config{DEBUG}; if ( $] < 5.008 or $config{NO_THREADS} ) { warn "disabling XML::LibXML support for Perl threads\n"; $config{DEFINE} .= " -DNO_XML_LIBXML_THREADS"; } delete $config{NO_THREADS}; # We use it several times later. See: # https://rt.cpan.org/Public/Bug/Display.html?id=116461 my $HAVE_USER_DEFINED = (defined($config{LIBS}) or defined($config{INC}) ); unless ( $::is_Win32 ) { # cannot get config in W32 my $xsltcfg = "xslt-config"; my $libprefix = $ENV{XSLTPREFIX} || $config{XSLTPREFIX}; delete $config{XSLTPREFIX}; # delete if exists, otherwise MakeMaker gets confused if ( defined $libprefix ) { $xsltcfg = $libprefix . '/bin/' . $xsltcfg; } # if a user defined INC and LIBS on the command line we must not # override them if ( ! $HAVE_USER_DEFINED ) { # get libs and inc from gnome-config eval { print "running xslt-config... "; my $ver = backtick("$xsltcfg --version"); my ($major, $minor, $point) = $ver =~ /(\d+)\.(\d+)\.(\d+)/g; if (not ( ($major > 1) or (($major == 1) && ($minor > 1)) or (($major == 1) && ($minor == 1) && ($point >= 18)) ) ) { die +{ type => "ver", msg => <<'EOF'}; libxslt versions before 1.1.18 are buggy. Please install the latest version EOF } elsif ($major == 1 and $minor == 1 and $point == 25) { die +{ type => "ver", msg => <<'EOF'}; libxslt-1.1.25 contains a deadlock that breaks the tests, and is not supported. See: https://rt.cpan.org/Ticket/Display.html?id=50487 . EOF } elsif ($major == 1 and $minor == 1 and $point == 27) { die +{ type => "ver", msg => <<'EOF'}; libxslt-1.1.27 does not handle namespaces well, and is not supported. See: https://bugzilla.gnome.org/show_bug.cgi?id=684564 . EOF } $config{LIBS} ||= backtick("$xsltcfg --libs"); $config{INC} ||= backtick("$xsltcfg --cflags"); print "ok\n"; }; my $Err = $@; if ($Err) { print "failed\n"; if ((ref($Err) eq 'HASH') && (($Err->{type} || '') eq 'ver')) { print {*STDERR} ($Err->{msg}, "\n"); exit 0; # 0 recommended by http://cpantest.grango.org (Notes for CPAN Authors) } warn "*** ", $@ if $DEBUG; warn "using fallback values for LIBS and INC\n"; # backtick fails if gnome-config didn't exist... $config{LIBS} = '-L/usr/local/lib -L/usr/lib -lxslt -lxml2 -lz -lm'; $config{INC} = '-I/usr/local/include -I/usr/include'; print < " $ldflags " }; } # Avoid possible shared library name conflict. On Win32 systems # the name of system DLL libxlst.dll clashes with module's LibXSLT.dll. # To handle this we are gonna rename module's DLL to LibXSLT.xs.dll. if ($::is_Win32) { if ($] eq '5.010000') { print STDERR <<'BUG'; ******************************** !!!WARNING!!! ******************************** According to the version string you are running a win32 perl 5.10.0 that is known to be suffering from dynaloader bug that prevents using non-default module's DLL name. Therefore we have to use LibXSLT.dll that will clash with the standard name of xslt library DLL. Please consider renaming your xslt library to e.g. libxslt_win32.dll and then make the appropriate changes to this module's build process to look for that instead of standard libxslt.dll. If you do not make the proposed changes you will got during the tests many error popups with slightly confusing message about "xsltApplyOneTemplate" function. This bug is not present in perl 5.8.* and will be fixed in 5.10.1. ******************************************************************************* BUG } else { # Fix for RT #94516 : # https://rt.cpan.org/Ticket/Display.html?id=94516 $config{DLEXT} = 'xs.'.$Config{dlext}; } } WriteMakefile( 'NAME' => 'XML::LibXSLT', 'VERSION_FROM' => 'LibXSLT.pm', # finds $VERSION 'AUTHOR' => 'Matt Sergeant', 'ABSTRACT' => 'Interface to GNOME libxslt library', 'LICENSE' => 'perl_5', 'PREREQ_PM' => { 'Encode' => 0, 'XML::LibXML' => "1.70", 'strict' => 0, 'warnings' => 0, }, 'OBJECT' => '$(O_FILES)', (($ExtUtils::MakeMaker::VERSION >= 6.48) ? (MIN_PERL_VERSION => '5.008001',) : () ), 'META_MERGE' => { 'meta-spec' => { 'version' => 2, }, 'resources' => { 'repository' => { 'type' => 'hg', 'url' => 'https://bitbucket.org/shlomif/perl-xml-libxslt', 'web' => 'https://bitbucket.org/shlomif/perl-xml-libxslt', }, }, }, %config, ); ################################################################### # Functions # - these should really be in MakeMaker... But &shrug; ################################################################### use Config; use Cwd; use Symbol; use File::Spec; BEGIN { $::is_Win32 = ($^O =~ /Win32/); if ($::is_Win32) { $DEVNULL = 'DEVNULL'; } else { $DEVNULL = eval { File::Spec->devnull }; if ($@) { $DEVNULL = '/dev/null' } } } sub rm_f { my @files = @_; my @realfiles; foreach (@files) { push @realfiles, glob($_); } if (@realfiles) { chmod(0777, @realfiles); unlink(@realfiles); } } sub rm_fr { my @files = @_; my @realfiles; foreach (@files) { push @realfiles, glob($_); } foreach my $file (@realfiles) { if (-d $file) { # warn("$file is a directory\n"); rm_fr("$file/*"); rm_fr("$file/.exists"); rmdir($file) || die "Couldn't remove $file: $!"; } else { # warn("removing $file\n"); chmod(0777, $file); unlink($file); } } } sub xsystem { my (@command)=@_; if ($DEBUG) { print "@command\n"; if (system(@command) != 0) { die "system call to '@command' failed"; } return 1; } open(OLDOUT, ">&STDOUT"); open(OLDERR, ">&STDERR"); open(STDOUT, ">$DEVNULL"); open(STDERR, ">$DEVNULL"); my $retval = system(@command); open(STDOUT, ">&OLDOUT"); open(STDERR, ">&OLDERR"); if ($retval != 0) { die "system call to '@command' failed"; } return 1; } sub backtick { my $command = shift; if ($DEBUG) { print $command, "\n"; my $results = `$command`; chomp $results; if ($? != 0) { die "backticks call to '$command' failed"; } return $results; } open(OLDOUT, ">&STDOUT"); open(OLDERR, ">&STDERR"); open(STDOUT, ">$DEVNULL"); open(STDERR, ">$DEVNULL"); my $results = `$command`; my $retval = $?; open(STDOUT, ">&OLDOUT"); open(STDERR, ">&OLDERR"); if ($retval != 0) { die "backticks call to '$command' failed"; } chomp $results; return $results; } sub try_link0 { my ($src, $opt) = @_; my $cfile = gensym(); # local $config{LIBS}; # $config{LIBS} .= $opt; unless (mkdir(".testlink", 0777)) { rm_fr(".testlink"); mkdir(".testlink", 0777) || die "Cannot create .testlink dir: $!"; } chdir(".testlink"); open($cfile, ">Conftest.xs") || die "Cannot write to file Conftest.xs: $!"; print $cfile < #include #include #ifdef __cplusplus } #endif EOT print $cfile $src; print $cfile <Conftest.pm") || die "Cannot write to file Conftest.pm: $!"; print $cfile <<'EOT'; package Conftest; $VERSION = 1.0; require DynaLoader; @ISA = ('DynaLoader'); bootstrap Conftest $VERSION; 1; EOT close($cfile); open($cfile, ">Makefile.PL") || die "Cannot write to file Makefile.PL: $!"; print $cfile <<'EOT'; use ExtUtils::MakeMaker; my %config; while($_ = shift @ARGV) { my ($k, $v) = split /=/, $_, 2; warn("$k = $v\n"); $config{$k} = $v; } WriteMakefile(NAME => "Conftest", VERSION_FROM => "Conftest.pm", %config); EOT close($cfile); open($cfile, ">test.pl") || die "Cannot write to file test.pl: $!"; print $cfile < 1; } END { ok(\$loaded) } use Conftest; \$loaded++; EOT close($cfile); xsystem($^X,'Makefile.PL',map "$_=$config{$_}", keys %config); xsystem($Config{make}, ($config{MAKEAPERL} ? qw(-f Makefile.aperl FIRST_MAKEFILE=Makefile.aperl) : ()), 'test'); #,"OTHERLDFLAGS=".$opt); } sub try_link { my $start_dir = cwd(); my $result = eval { try_link0(@_); }; warn $@ if $DEBUG && $@; chdir($start_dir); rm_fr(".testlink"); return $result; } sub have_library { my ($lib, $func) = (@_, "blank"); printf("checking for %s() in -l%s... ", $func, $lib) if $func ne "blank"; printf("looking for -l%s... ", $lib) if $func eq "blank"; my $result; if ($func) { my $libs = $::is_Win32 ? " $lib.lib " : "-l$lib"; if ($::is_Win32) { $result = try_link(<<"SRC", $libs); #include #include blank() { return 0; } int t() { ${func}(); return 0; } SRC unless ($result) { $result = try_link(<<"SRC", $libs); #include #include blank() { return 0; } int t() { void ((*p)()); p = (void ((*)()))${func}; return 0; } SRC } } else { $result = try_link(<<"SRC", $libs); blank() { return 0; } int t() { ${func}(); return 0; } SRC } } unless ($result) { print "no\n"; return 0; } if ($func ne "main") { $config{DEFINE} .= uc(" -Dhave_$func"); } print "yes\n"; return 1; } sub MY::postamble { return <<'MAKE_FRAG'; runtest: pure_all perl -MFile::Spec -MTest::Run::CmdLine::Iface -e \ "local @INC = @INC; unshift @INC, map { File::Spec->rel2abs(\$$_) } ('$(INST_LIB)', '$(INST_ARCHLIB)'); Test::Run::CmdLine::Iface->new({test_files => [glob(q{t/*.t})]})->run();" distruntest: distdir cd $(DISTVNAME) && $(ABSPERLRUN) Makefile.PL cd $(DISTVNAME) && $(MAKE) $(PASTHRU) cd $(DISTVNAME) && $(MAKE) runtest $(PASTHRU) MAKE_FRAG } XML-LibXSLT-1.95/META.yml0000644000076400007640000000125112747105600014475 0ustar shlomifshlomif--- abstract: 'Interface to GNOME libxslt library' author: - 'Matt Sergeant' build_requires: ExtUtils::MakeMaker: '0' configure_requires: ExtUtils::MakeMaker: '0' dynamic_config: 1 generated_by: 'ExtUtils::MakeMaker version 7.16, CPAN::Meta::Converter version 2.150005' license: perl meta-spec: url: http://module-build.sourceforge.net/META-spec-v1.4.html version: '1.4' name: XML-LibXSLT no_index: directory: - t - inc requires: Encode: '0' XML::LibXML: '1.70' perl: '5.008001' strict: '0' warnings: '0' resources: repository: https://bitbucket.org/shlomif/perl-xml-libxslt version: '1.95' x_serialization_backend: 'CPAN::Meta::YAML version 0.012' XML-LibXSLT-1.95/META.json0000644000076400007640000000235112747105600014647 0ustar shlomifshlomif{ "abstract" : "Interface to GNOME libxslt library", "author" : [ "Matt Sergeant" ], "dynamic_config" : 1, "generated_by" : "ExtUtils::MakeMaker version 7.16, CPAN::Meta::Converter version 2.150005", "license" : [ "perl_5" ], "meta-spec" : { "url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec", "version" : "2" }, "name" : "XML-LibXSLT", "no_index" : { "directory" : [ "t", "inc" ] }, "prereqs" : { "build" : { "requires" : { "ExtUtils::MakeMaker" : "0" } }, "configure" : { "requires" : { "ExtUtils::MakeMaker" : "0" } }, "runtime" : { "requires" : { "Encode" : "0", "XML::LibXML" : "1.70", "perl" : "5.008001", "strict" : "0", "warnings" : "0" } } }, "release_status" : "stable", "resources" : { "repository" : { "type" : "hg", "url" : "https://bitbucket.org/shlomif/perl-xml-libxslt", "web" : "https://bitbucket.org/shlomif/perl-xml-libxslt" } }, "version" : "1.95", "x_serialization_backend" : "JSON::PP version 2.27300" } XML-LibXSLT-1.95/README0000644000076400007640000000550112321504724014104 0ustar shlomifshlomifThis module is a fast XSLT library, based on the GNOME libxslt engine that you can find at http://www.xmlsoft.org/XSLT/ Performance is currently about twice that of XML::Sablotron (based on XSLTMark tests converted to Perl). The libxslt processor is also highly standards compliant implementation of XSLT 1.0. A NOTE ON INSTALLATION ---------------------- The library depends on libxslt. You have to have both the library and its header files installed (on various Linux/UNIX distributions thay are usually packaged as libxslt-dev or libxslt-devel). The module can further make use of libexslt, which is distributed with libxslt, but on some systems packaged separately. These libraries may have their own dependencies (usually resolved automatically by the packaging system). Note that if you want any global data to be shared between the libxml2 libraries used by this module and XML-LibXML, e.g. the input callback table, then each module must link dynamically against libxml2 so that they both use the same shared library (this is in fact default on most UNIX/POSIX platforms). The Makefile.PL tries to determine the correct compiler and linker flags for its library dependencies using pkg-config and xslt-config. If this fails, you may override the values like this perl Makefile.PL INC="..." LIBS="..." where INC contains flags for the compiler (such as -I/some_path/include etc.) and LIBS contains linker flags (such as -L/some_path/lib -llibsomething ...). WIN32 BUILDING ISSUES --------------------- It is recommended that when building this module on Win32 you also link dynamically against libxslt and libexslt, since linking statically against these libraries but dynamically against libxml2 may cause some "unresolved symbol" linker errors. Dynamic linking, however, causes a name clash between the name of this module's DLL (LibXSLT.dll) and that of libxslt (libxslt.dll) on Win32's case-insensitive filesystem. So, if you link dynamically then you'll probably have to build your libxslt DLL as, say, libxslt_win32.dll and then make the appropriate changes to this module's build process to look for that instead of libxslt.dll. PATCHES AND DEVELOPER VERSION ============================= As XML::LibXSLT is open source software help and patches are appreciated. If you find a bug in the current release, make sure this bug still exists in the developer version of XML::LibXSLT. This version can be downloaded from its Mercurial repository. The repository can be cloned via: hg clone ssh://hg@bitbucket.org/shlomif/perl-xml-libxslt Note this account does not allow direct commits. Please consider the tests as correct. If any test fails it is most certainly related to a bug. COPYRIGHT AND LICENSE --------------------- This is free software, you may use it and distribute it under the same terms as Perl itself. Copyright 2001 AxKit.com Ltd. XML-LibXSLT-1.95/t/0000755000076400007640000000000012747105600013470 5ustar shlomifshlomifXML-LibXSLT-1.95/t/04params.t0000644000076400007640000000275212321504727015313 0ustar shlomifshlomifuse strict; use warnings; # Should be 7. use Test::More tests => 7; use XML::LibXSLT; use XML::LibXML; my $parser = XML::LibXML->new(); my $xslt = XML::LibXSLT->new(); my $source = $parser->parse_string(<<'EOF'); NEXT LAST EOF # TEST ok($source, ' TODO : Add test name'); my $style_doc = $parser->parse_string(<<'EOF'); EOF # TEST ok($style_doc, ' TODO : Add test name'); my $stylesheet = $xslt->parse_stylesheet($style_doc); # TEST ok($stylesheet, ' TODO : Add test name'); my $results = $stylesheet->transform($source, 'incoming' => "'INCOMINGTEXT'", # 'incoming' => "'INCOMINGTEXT2'", 'outgoing' => "'OUTGOINGTEXT'", ); # TEST ok($results, ' TODO : Add test name'); # TEST ok($stylesheet->output_string($results), ' TODO : Add test name'); my @params = XML::LibXSLT::xpath_to_string('empty' => undef); $results = $stylesheet->transform($source, @params); # TEST ok($results, ' TODO : Add test name'); # TEST ok($stylesheet->output_string($results), ' TODO : Add test name'); XML-LibXSLT-1.95/t/style-trailing-space.t0000644000076400007640000000104512321504273017712 0ustar shlomifshlomif#!/usr/bin/perl use strict; use warnings; use Test::More; eval "use Test::TrailingSpace"; if ($@) { plan skip_all => "Test::TrailingSpace required for trailing space test."; } else { plan tests => 1; } # TODO: add .pod, .PL, the README/Changes/TODO/etc. documents and possibly # some other stuff. my $finder = Test::TrailingSpace->new( { root => '.', filename_regex => qr/(?:\.(?:t|pm|pl|xs|c|h|txt|pod|PL)|README|Changes|TODO|LICENSE)\z/, }, ); # TEST $finder->no_trailing_space( "No trailing space was found." ); XML-LibXSLT-1.95/t/rt71345_a.t0000644000076400007640000000210312321504732015177 0ustar shlomifshlomifuse Test::More tests => 2; # See: # https://rt.cpan.org/Ticket/Display.html?id=71345 { use strict; use warnings; use XML::LibXSLT; use XML::LibXML; my $xslt = XML::LibXSLT->new(); my $ext_uri = "urn:local"; my @keep; XML::LibXSLT->register_function($ext_uri, "uc", sub { push @keep, @_; return uc shift; } ); my $stylesheet = $xslt->parse_stylesheet(XML::LibXML->load_xml(string => <<'EOF')); EOF my $input = XML::LibXML->load_xml(string => ""); # TEST like ($stylesheet->transform($input)->toString, qr{\QFOO\E}, 'transformation works.', ); # Next line crashes Perl @keep = undef; } # TEST ok(1, 'Did not crash.'); XML-LibXSLT-1.95/t/09exslt.t0000644000076400007640000000260711651561654015202 0ustar shlomifshlomifuse strict; use warnings; use Test::More; use XML::LibXSLT; use XML::LibXML; if (not XML::LibXSLT::HAVE_EXSLT()) { plan skip_all => "this test requires XML::LibXSLT to be compiled with libexslt" } else { # Should be 6. plan tests => 6; } my $parser = XML::LibXML->new(); # TEST ok($parser, '$parser was initted.'); my $doc = $parser->parse_string(<<'EOT'); EOT # TEST ok($doc, '$doc is true.'); my $xslt = XML::LibXSLT->new(); my $style_doc = $parser->parse_string(<<'EOT'); ; str:tokenize('2001-06-03T11:40:23', '-T:') ; str:tokenize('date math str') ; EOT # TEST ok($style_doc, '$style_doc is true.'); # warn "Style_doc = \n", $style_doc->toString, "\n"; my $stylesheet = $xslt->parse_stylesheet($style_doc); # TEST ok($stylesheet, '$stylesheet is true.'); my $results = $stylesheet->transform($doc); # TEST ok($results, '$results is true.'); my $output = $stylesheet->output_string($results); # TEST ok($output, '$output is true.'); # warn "Results:\n", $output, "\n"; XML-LibXSLT-1.95/t/06output.t0000644000076400007640000000600512321504736015365 0ustar shlomifshlomifuse strict; use warnings; # Should be 28. use Test::More tests => 28; use XML::LibXSLT; use XML::LibXML; my $parser = XML::LibXML->new(); my $xslt = XML::LibXSLT->new(); my $source = $parser->parse_string(<<'EOF'); EOF # TEST:$n=0; my @style_docs; # XML # TEST:$n++; push @style_docs, "text/xml", <<'EOF'; EOF # HTML # TEST:$n++; push @style_docs, "text/html", <<'EOF'; EOF # TEXT # TEST:$n++; push @style_docs, "text/plain", <<'EOF'; EOF # Default XML # TEST:$n++; push @style_docs, "text/xml", <<'EOF'; EOF # Default HTML (broken for now!) # TEST:$n++; push @style_docs, "text/html", <<'EOF'; EOF # Text, other # TEST:$n++; push @style_docs, "text/rtf", <<'EOF'; EOF # XML, other # TEST:$n++; push @style_docs, "text/vnd.wap.wml", <<'EOF'; EOF # TEST:$num_style_docs=$n; while (@style_docs) { my ($media_type, $style_str) = splice(@style_docs, 0, 2); my $style_doc = $parser->parse_string($style_str); # TEST*$num_style_docs ok($style_doc, ' TODO : Add test name'); my $stylesheet = $xslt->parse_stylesheet($style_doc); # TEST*$num_style_docs ok($stylesheet, ' TODO : Add test name'); my $results = $stylesheet->transform($source); # TEST*$num_style_docs ok($results, ' TODO : Add test name'); # TEST*$num_style_docs is($stylesheet->media_type, $media_type, ' TODO : Add test name'); } XML-LibXSLT-1.95/t/03input.t0000644000076400007640000001321312321504742015155 0ustar shlomifshlomifuse strict; use warnings; # Should be 28. use Test::More tests => 28; use XML::LibXSLT; use XML::LibXML 1.59; my $parser = XML::LibXML->new(); # parser # TEST ok ($parser, 'Parser was initted.'); my $doc = $parser->parse_string(<<'EOT'); random contents EOT # doc # TEST ok ($doc, 'Doc was initted.'); my $xslt = XML::LibXSLT->new(); # xslt # TEST ok ($xslt, 'xslt was initted.'); my $stylsheetstring = <<'EOT'; Know Your Dromedaries

foo:

EOT my $icb = XML::LibXML::InputCallback->new(); # TEST ok ($icb, 'icb was initted.'); # registering callbacks $icb->register_callbacks( [ \&match_cb, \&open_cb, \&read_cb, \&close_cb ] ); $xslt->input_callbacks($icb); my $stylesheet = $xslt->parse_stylesheet($parser->parse_string($stylsheetstring)); # stylesheet # TEST ok ($stylesheet, 'stylesheet is OK.'); #$stylesheet->input_callbacks($icb); # warn "transforming\n"; my $results = $stylesheet->transform($doc); # results # TEST ok ($results, 'results is OK.'); my $output = $stylesheet->output_string($results); # warn "output: $output\n"; # TEST ok ($output, 'output is OK.'); # test a dying close callback # callbacks can only be registered as a callback group $stylesheet->match_callback( \&match_cb ); $stylesheet->open_callback( \&dying_open_cb ); $stylesheet->read_callback( \&read_cb ); $stylesheet->close_callback( \&close_cb ); # check if transform throws an exception # dying callback test eval { $stylesheet->transform($doc); }; { my $E = $@; # TEST ok ($E, "Threw: $E"); } # # test the old global|local-variables-using callback interface # $xslt = undef; $stylesheet = undef; $xslt = XML::LibXSLT->new(); $stylesheet = $xslt->parse_stylesheet($parser->parse_string($stylsheetstring)); { # setting callbacks local $XML::LibXML::match_cb = \&match_cb; local $XML::LibXML::open_cb = \&open_cb; local $XML::LibXML::close_cb = \&close_cb; local $XML::LibXML::read_cb = \&read_cb; # warn "transform!\n"; $results = $stylesheet->transform($doc); # results # TEST ok ($results, 'results is OK - 2.'); $output = $stylesheet->output_string($results); # warn "output: $output\n"; # output # TEST ok ($output, 'output is OK - 2.'); $XML::LibXML::open_cb = \&dying_open_cb; # check if the transform throws an exception eval { $stylesheet->transform($doc); }; { my $E = $@; # TEST ok ($E, "Transform Threw: $E"); } } # # test callbacks for parse_stylesheet() # $xslt = undef; $stylesheet = undef; $icb = undef; $xslt = XML::LibXSLT->new(); $icb = XML::LibXML::InputCallback->new(); # registering callbacks $icb->register_callbacks( [ \&match_cb, \&stylesheet_open_cb, \&read_cb, \&close_cb ] ); $xslt->input_callbacks($icb); $stylsheetstring = <<'EOT'; Know Your Dromedaries

Dahut!

 EOT $stylesheet = $xslt->parse_stylesheet($parser->parse_string($stylsheetstring)); # stylesheet # TEST ok ($stylesheet, 'stylesheet is OK - 2.'); # # Test not matching callback # This also verifies that all the previous callbacks were unregistered. # $xslt = undef; $stylesheet = undef; $icb = undef; $xslt = XML::LibXSLT->new(); $icb = XML::LibXML::InputCallback->new(); # registering callbacks $icb->register_callbacks( [ \&match_cb, \&stylesheet_open_cb, \&read_cb, \&close_cb ] ); $xslt->input_callbacks($icb); my $no_match_count = 0; $stylsheetstring = <<'EOT'; EOT $stylesheet = $xslt->parse_stylesheet($parser->parse_string($stylsheetstring)); # stylesheet # TEST ok ($stylesheet, 'stylesheet is OK - 3.'); $results = $stylesheet->transform($doc); # results # TEST ok ($results, 'results is OK - 3.'); # no_match_count # TEST is ($no_match_count, 1, 'match_cb called once if no match'); # # input callback functions # sub match_cb { my $uri = shift; # match_cb if ($uri eq "foo.xml") { # TEST*5 ok(1, 'URI is OK in match_cb.'); return 1; } if ($uri eq "not-found.xml") { ++$no_match_count; return 0; } return 0; } sub open_cb { my $uri = shift; # TEST*2 is ($uri, 'foo.xml', 'URI is OK in open_cb.'); my $str ="Text here"; return \$str; } sub dying_open_cb { my $uri = shift; # dying_open_cb: $uri # TEST*2 is ($uri, 'foo.xml', 'dying_open_cb'); die "Test a die from open_cb"; } sub stylesheet_open_cb { my $uri = shift; # TEST is ($uri, 'foo.xml', 'stylesheet_open_cb uri compare.'); my $str = ''; return \$str; } sub close_cb { # warn("close\n"); # TEST*3 ok(1, 'close_cb()'); } sub read_cb { # warn("read\n"); return substr(${$_[0]}, 0, $_[1], ""); } XML-LibXSLT-1.95/t/08literal.t0000644000076400007640000000206712022073774015470 0ustar shlomifshlomifuse strict; use warnings; # Should be 8. use Test::More tests => 8; use XML::LibXSLT; my $parser = XML::LibXML->new(); my $xslt = XML::LibXSLT->new(); # TEST ok ($parser, '$parser was initted.'); # TEST ok ($xslt, '$xslt was initted.'); my $source = $parser->parse_string(<<'EOT'); EOT my $style = $parser->parse_string(<<'EOT'); EOT # TEST ok ($style, '$style is true.'); my $stylesheet = $xslt->parse_stylesheet($style); # TEST is ($stylesheet->output_method, 'xml', 'output method is xml BEFORE processing'); # TEST is ($stylesheet->media_type, 'text/xml', 'media_type is text/xml BEFORE processing'); my $results = $stylesheet->transform($source); # TEST ok ($results, '$results are true.'); # TEST is ($stylesheet->output_method, 'html', 'output method is html AFTER processing'); # TEST is ($stylesheet->media_type, 'text/html', 'media_type is text/html AFTER processing'); XML-LibXSLT-1.95/t/cpan-changes.t0000644000076400007640000000026712322172535016211 0ustar shlomifshlomif#!/usr/bin/perl use strict; use warnings; use Test::More; eval 'use Test::CPAN::Changes 0.27'; plan skip_all => 'Test::CPAN::Changes required for this test' if $@; changes_ok(); XML-LibXSLT-1.95/t/02dromeds.t0000644000076400007640000000357011647606330015465 0ustar shlomifshlomifuse strict; use warnings; use Test::More tests => 6; use XML::LibXSLT; use XML::LibXML; my $parser = XML::LibXML->new(); # TEST ok($parser, ' TODO : Add test name'); my $doc = $parser->parse_string(<<'EOT'); 1 or 2 Cranky 1 (sort of) Aloof (see Llama) Friendly EOT # TEST ok($doc, ' TODO : Add test name'); my $xslt = XML::LibXSLT->new(); my $style_doc = $parser->parse_string(<<'EOT'); Know Your Dromedaries
Species No of Humps Disposition
EOT # TEST ok($style_doc, ' TODO : Add test name'); # warn "Style_doc = \n", $style_doc->toString, "\n"; my $stylesheet = $xslt->parse_stylesheet($style_doc); # TEST ok($stylesheet, ' TODO : Add test name'); my $results = $stylesheet->transform($doc); # TEST ok($results, ' TODO : Add test name'); my $output = $stylesheet->output_string($results); # TEST ok($output, ' TODO : Add test name'); # warn "Results:\n", $output, "\n"; XML-LibXSLT-1.95/t/xml-grammar-failures.t0000644000076400007640000000207612273457253017726 0ustar shlomifshlomif#!/usr/bin/perl use strict; use warnings; # Failures with doing this were reported against several XML::Grammar::* # modules on various systems, and we want to catch them as soon as we can. # # See for example: # http://www.cpantesters.org/cpan/report/b0e211b6-8b4d-11e3-9847-e214e1bfc7aa use File::Spec; use Test::More tests => 1; use XML::LibXSLT; use XML::LibXML; { my $xslt = XML::LibXSLT->new(); my $input_fn = File::Spec->catfile( File::Spec->curdir(), "t", "data", "perl-begin-page.xml-grammar-vered.xml", ); my $xslt_fn = File::Spec->catfile( File::Spec->curdir(), "t", "data", "vered-xml-to-docbook.xslt", ); my $source = XML::LibXML->load_xml(location => $input_fn); my $style_doc = XML::LibXML->load_xml(location=>$xslt_fn, no_cdata=>1); my $stylesheet = $xslt->parse_stylesheet($style_doc); my $results = $stylesheet->transform($source); # TEST like (scalar($stylesheet->output_as_bytes($results)), qr/ 2; use XML::LibXML; use XML::LibXSLT; my $parser = XML::LibXML->new(); my $xslt = XML::LibXSLT->new(); # $parser->expand_entities(1); my $source = $parser->parse_string(qq{ foo}); my $style_doc = $parser->parse_string(' ]> fooöbar '); my $stylesheet = $xslt->parse_stylesheet($style_doc); my $results = $stylesheet->transform($source); my $tostring = $results->toString; # TEST like ($tostring, qr/foo(?:.|ö)bar/i, '$tostring matches entity.'); my $content = $stylesheet->output_string($results); # libxml2-2.6.16/libxslt-1.1.9 will produce a character entity # latest versions give a UTF-8 encoded character # TEST like ($content, qr/foo(?:ö|\xC3\xB6)bar/i, '$content matches entity.'); XML-LibXSLT-1.95/t/pod.t0000644000076400007640000000021412321503370014426 0ustar shlomifshlomif#!perl -T use Test::More; eval "use Test::Pod 1.14"; plan skip_all => "Test::Pod 1.14 required for testing POD" if $@; all_pod_files_ok(); XML-LibXSLT-1.95/t/11utf8.t0000644000076400007640000001023612321505146014704 0ustar shlomifshlomifuse strict; # -*- perl -*- use warnings; use Encode; # Should be 32. use Test::More tests => 32; use XML::LibXSLT; use XML::LibXML; my $parser = XML::LibXML->new(); # TEST ok( $parser, ' TODO : Add test name' ); my $xslt = XML::LibXSLT->new(); { # U+0100 == LATIN CAPITAL LETTER A WITH MACRON my $doc = $parser->parse_string(<\x{0100}dam XML # TEST ok( $doc, ' TODO : Add test name' ); my $style_doc = $parser->parse_string(< XSLT # TEST ok( $style_doc, ' TODO : Add test name' ); my $stylesheet = $xslt->parse_stylesheet($style_doc); # TEST ok( $stylesheet, ' TODO : Add test name' ); my $results = $stylesheet->transform($doc); # TEST ok( $results, ' TODO : Add test name' ); my $output = $stylesheet->output_string( $results ); # TEST ok( $output, ' TODO : Add test name' ); # Test that we've correctly converted to characters seeing as the # output format was UTF-8. # TEST ok( Encode::is_utf8($output), ' TODO : Add test name' ); # TEST is( $output, "\x{0100}dam", ' TODO : Add test name' ); $output = $stylesheet->output_as_chars( $results ); # TEST ok( Encode::is_utf8($output), ' TODO : Add test name' ); # TEST is( $output, "\x{0100}dam", ' TODO : Add test name' ); $output = $stylesheet->output_as_bytes( $results ); # TEST ok( !Encode::is_utf8($output), ' TODO : Add test name' ); # TEST is( $output, "\xC4\x80dam", ' TODO : Add test name' ); } # LATIN-2 character 17E - z caron my $doc = $parser->parse_string(< \x{17E}il XML # TEST ok( $doc, ' TODO : Add test name' ); # no encoding: libxslt chooses either an entity or UTF-8 { my $style_doc = $parser->parse_string(< XSLT # TEST ok( $style_doc, ' TODO : Add test name' ); my $stylesheet = $xslt->parse_stylesheet($style_doc); # TEST ok( $stylesheet, ' TODO : Add test name' ); my $results = $stylesheet->transform($doc); # TEST ok( $results, ' TODO : Add test name' ); my $output = $stylesheet->output_string( $results ); # TEST ok( !Encode::is_utf8($output), ' TODO : Add test name' ); # TEST ok( $output =~ /^(?:ž|\xC5\xBE)il/, ' TODO : Add test name' ); $output = $stylesheet->output_as_chars( $results ); # TEST ok( Encode::is_utf8($output), ' TODO : Add test name' ); # TEST is( $output, "\x{17E}il", ' TODO : Add test name' ); $output = $stylesheet->output_as_bytes( $results ); # TEST ok( !Encode::is_utf8($output), ' TODO : Add test name' ); # TEST like( $output, qr/^(?:ž|\xC5\xBE)il/, ' TODO : Add test name' ); } # doesn't map to latin-1 so will appear as an entity { my $style_doc = $parser->parse_string(< XSLT # TEST ok( $style_doc, ' TODO : Add test name' ); my $stylesheet = $xslt->parse_stylesheet($style_doc); # TEST ok( $stylesheet, ' TODO : Add test name' ); my $results = $stylesheet->transform($doc); # TEST ok( $results, ' TODO : Add test name' ); my $output = $stylesheet->output_string( $results ); # TEST ok( $output, ' TODO : Add test name' ); # TEST ok( !Encode::is_utf8($output), ' TODO : Add test name' ); # TEST is( $output, "žil", ' TODO : Add test name' ); $output = $stylesheet->output_as_chars( $results ); # TEST ok( Encode::is_utf8($output), ' TODO : Add test name' ); # TEST is( $output, "\x{17E}il", ' TODO : Add test name' ); $output = $stylesheet->output_as_bytes( $results ); # TEST ok( !Encode::is_utf8($output), ' TODO : Add test name' ); # TEST is( $output, "žil", ' TODO : Add test name' ); } XML-LibXSLT-1.95/t/10functions.t0000644000076400007640000002461212321504756016036 0ustar shlomifshlomifuse strict; use warnings; # Should be 39. use Test::More tests => 39; use XML::LibXSLT; { my $parser = XML::LibXML->new(); my $xslt = XML::LibXSLT->new(); # TEST ok($parser, '$parser was initted'); # TEST ok($xslt, '$xslt was initted'); $xslt->register_function('urn:foo' => 'test', sub { # TEST*4 ok(1, 'urn:foo was reached.'); return $_[1] ? ($_[0] . $_[1]) : $_[0]; } ); $xslt->register_function('urn:foo' => 'test2', sub { # TEST*2 is(ref($_[0]), 'XML::LibXML::NodeList', 'First argument is a NodeList'); ref($_[0]) } ); $xslt->register_function('urn:foo' => 'test3', sub { # TEST*2 is(scalar(@_), 0, 'No arguments were received.'); return; } ); my $source = $parser->parse_string(<<'EOT'); EOT my $style = $parser->parse_string(<<'EOT'); (( )) (( )) [[ ]] [[ ]] (( )) (( )) EOT # TEST ok($style, '$style is true'); my $stylesheet = $xslt->parse_stylesheet($style); my $results = $stylesheet->transform($source); # TEST ok($results, '$results is true.'); # TEST like ($stylesheet->output_string($results), qr(Foo!), 'Matches Foo!'); # TEST like ($stylesheet->output_string($results), qr(NodeList), 'Matches NodeList'); $xslt->register_function('urn:foo' => 'get_list', \&get_nodelist ); our @words = qw( one two three ); sub get_nodelist { my $nl = XML::LibXML::NodeList->new(); $nl -> push( map { XML::LibXML::Text->new($_) } @words ); return $nl; } $style = $parser->parse_string(<<'EOT');
    • EOT # TEST ok($style, '$style is true - 2'); $stylesheet = $xslt->parse_stylesheet($style); # TEST:$n=5; for my $n (1..5) { $results = $stylesheet->transform($source); # TEST*$n ok($results, '$results is true - 2 (' . $n . ')'); # TEST*$n like($stylesheet->output_string($results), qr(
  • one
    • ), 'Matches li-one - ' . $n ); # TEST*$n like ( $stylesheet->output_string($results), qr(
  • one
  • two
  • three
    • ), 'Output matches multiple lis - ' . $n ); } } { # testcase by Elizabeth Mattijsen my $parser = XML::LibXML->new; my $xsltproc = XML::LibXSLT->new; my $xml = $parser->parse_string( <<'XML' ); XML my $xslt = $parser->parse_string( <<'XSLT' ); XSLT my $aux = <<'XML'; 1st 2nd XML { XML::LibXSLT->register_function( ('http://foo', 'custom') => sub { $parser->parse_string( $aux )->findnodes('//y') } ); my $stylesheet = $xsltproc->parse_stylesheet($xslt); my $result = $stylesheet->transform($xml); # the behavior has changed in some version of libxslt my $expect = qq(1st2nd\n); # TEST like ($result->serialize, qr{(\Q\n\E)?\Q$expect\E}, 'Results serialize matches text.' ); } { XML::LibXSLT->register_function( ('http://foo', 'custom') => sub { $parser->parse_string( $aux )->findnodes('//y')->[0]; }); my $stylesheet = $xsltproc->parse_stylesheet($xslt); my $result = $stylesheet->transform($xml); my $expect = qq(1st\n); # TEST like ( $result->serialize, qr{(\Q\n\E)?\Q$expect\E}, 'Results serialize matches text - 2.' ); } } { my $parser = XML::LibXML->new; my $xsltproc = XML::LibXSLT->new; my $xslt = $parser->parse_string( <<'XSLT' ); XSLT $xsltproc->register_function( ("http://x/x", 'test') => sub { $_[0][0]->findnodes('//b[parent::a]') } ); my $stylesheet = $xsltproc->parse_stylesheet($xslt); my $result = $stylesheet->transform($parser->parse_string( <<'XML' )); XML # TEST is ($result->serialize, qq(\n\n), 'result is right.' ); } { my $callbackNS = "http://x/x"; my $p = XML::LibXML->new; my $xsltproc = XML::LibXSLT->new; $xsltproc->register_function( $callbackNS, "some_function", sub { my($format) = @_; return $format; } ); $xsltproc->register_function( $callbackNS, "some_function2", sub { my($format) = @_; return $format->[0]; } ); my $xsltdoc = $p->parse_string(<<'EOF'); , , , ; , , , ; EOF my $doc = $p->parse_string(<barzzz EOF my $stylesheet = $xsltproc->parse_stylesheet($xsltdoc); my $result = $stylesheet->transform($doc); my $val = $result->findvalue("/root"); # TEST ok ($val, 'val is true.'); # TEST is ($val, "foo,barzzz,bak,bar;foo,barzzz,bak,bar;barbakzzz", 'val has the right value.') or print $stylesheet->output_as_bytes($result); } { my $ns = "http://foo"; my $p = XML::LibXML->new; my $xsltproc = XML::LibXSLT->new; my $xsltdoc = $p->parse_string(< EOF my $doc = $p->parse_string(< EOF my $stylesheet = $xsltproc->parse_stylesheet($xsltdoc); $stylesheet->register_function($ns, "bar", sub { return $_[0] * 2 }); my $result = $stylesheet->transform($doc); my $val = $result->findvalue("/root"); # TEST is ($val, 20, "contextual register_function" ); } { my $ns = "http://foo"; my $p = XML::LibXML->new; my $xsltproc = XML::LibXSLT->new; my $xsltdoc = $p->parse_string(< EOF my $doc = $p->parse_string(< EOF my $stylesheet = $xsltproc->parse_stylesheet($xsltdoc); $stylesheet->register_element($ns, "bar", sub { return XML::LibXML::Text->new( $_[2]->getAttribute( "value" ) ); }); my $result = $stylesheet->transform($doc); my $val = $result->findvalue("/root"); # TEST is ($val, 10, "contextual register_element"); } { # GNOME Bugzilla bug #562302 my $parser = new XML::LibXML; my $xslt = new XML::LibXSLT; # registering function XML::LibXSLT->register_function("urn:perl", 'cfg', sub { return $parser->parse_string(''); }); # loading and parsing stylesheet my $style_doc = $parser->parse_string(<<'EOF'); <xsl:value-of select="$xml_storage"/> hello bye EOF my $stylesheet = $xslt->parse_stylesheet($style_doc); # performing transform my $source = XML::LibXML::Document->new; my $results = $stylesheet->transform($source); my $string = $stylesheet->output_string($results); my $expected = <<'EOF'; EOF # TEST is ($string, $expected, 'GNOME Bugzilla bug #562302'); } # TEST ok(1, 'Reached here.'); XML-LibXSLT-1.95/t/data/0000755000076400007640000000000012747105600014401 5ustar shlomifshlomifXML-LibXSLT-1.95/t/data/perl-begin-page.xml-grammar-vered.xml0000644000076400007640000020540712273450661023423 0ustar shlomifshlomif Perl Elements to Avoid Introduction

    Often when people ask for help with Perl code, they show Perl code that suffers from many bad or outdated elements. This is expected, as there are many bad Perl tutorials out there, and lots of bad code that people have learned from, but it is still not desirable. In order to not get "yelled at" for using these, here is the document of the bad elements that people tend to use and some better practices that should be used instead.

    A book I read said, that as opposed to most previous idea systems, they were trying to liquidate negatives instead of instilling positives in people. So in the spirit of liquidating negatives, this tutorial-in-reverse aims to show you what not to do.

    Note: Please don't think this advice is meant as gospel. There are some instances where one can expect to deviate from it, and a lot of it can be considered only my own opinion. I tried to filter the various advice I found in the sources for this advice and get rid of things that are a matter of taste or not so critical, or have arguments here or there (so-called colour of the bike shed arguments), but some of the advice here may still be controversial.

    The List of Bad Elements No Indentation

    Indentation means that the contents of every block are promoted from their containing environment by using a shift of some space. This makes the code easier to read and follow.

    Code without indentation is harder to read and so should be avoided. The Wikipedia article lists several styles - pick one and follow it.

    No "use strict;" and "use warnings;"

    All modern Perl code should have the "use strict;" and "use warnings;" pragmas that prevent or warn against misspelling variable names, using undefined values, and other bad practices. So start your code (in every file) with this:

    use strict; use warnings;

    Or:

    package MyModule; use strict; use warnings;     Correct style for using the open function

    The open function is used to open files, sub-processes, etc. The correct style for it is:

    open my $input_fh, "<", $input_filename or die "Could not open '$input_filename' - $!";

    some wrong, insecure and/or outdated styles are:

    # Bareword filehandle (type glob), two arguments open (insecure) and no # error handling open INPUT, "<$filename"; # Also opens from $INPUT. open INPUT; # Bareword filehandle with three args open and no exception thrown. open INPUT, "<", $filename; # Bareword filehandle with two-args open and exception (rare, but possible): open INPUT, "<$filename" or die "Cannot open $filename - $!"; # Lexical file handle with two-args open (instead of three-args open) # and no exception open my $input_fh, "<$filename";     Calling variables "file"

    Some people call their variables "file". However, file can mean either file handles, file names, or the contents of the file. As a result, this should be avoided and one can use the abbreviations "fh" for file handle, or "fn" for filenames instead.

    Identifiers without underscores

    Some people name their identifiers as several words all in lowercase and not separated by underscores ("_"). As a result, this makes the code harder to read. So instead of:

    my @namesofpresidents;

    Say:

    my @names_of_presidents;

    Or maybe:

    my @presidents_names;     Don't use prototypes for subroutines

    Some people are tempted to declare their subroutines using sub my_function ($$@), with the signature of the accepted parameter types, which is called a prototype. However, this tends to break code more often than not, and should be avoided.

    If you're looking for parameter lists to functions and methods, take a look at from CPAN. But don't use prototypes.

    For more information, see:

    1. Discussion on the Perl 5 Wiki

    2. “Why are Perl 5’s function prototypes bad?” on Stack Overflow.

    Ampersand in Subroutine Calls

    One should not call a subroutine using &myfunc(@args) unless you're sure that is what you want to do (like overriding prototypes). Normally saying myfunc(@args) is better.

    For more information see the relevant page on the Perl 5 Wiki.

    Assigning from $_

    Some people write code like the following:

    while (<$my_fh>) { my $line = $_; # Do something with $line… }

    Or:

    foreach (@users) { my $user = $_; # Process $user… }

    However, you can easily assign the explicit and lexical variables in the loop's opening line like so:

    while (my $line = <$my_fh>) { # Do something with $line… }

    and:

    foreach my $user (@users) { # Process $user… }     Using "foreach" on lines

    Some people may be tempted to write this code:

    foreach my $line (<$my_file_handle>) { # Do something with $line. }

    This code appears to work but what it does is read the entire contents of the file pointed by $my_file_handle into a (potentially long) list of lines, and then iterate over them. This is inefficient. In order to read one line at a time, use this instead:

    while (my $line = <$my_file_handle>) { # Do something with $line. }     String Notation

    Perl has a flexible way to write strings and other delimiters, and you should utilize it for clarity. If you find yourself writing long strings, write them as here-documents:

    my $long_string_without_interpolation = <<'EOF'; Hello there. I am a long string. I am part of the string. And so am I. EOF

    There are also <<"EOF" for strings with interpolation and <<`EOF` for trapping command output. Make sure you never use bareword here documents <<EOF which are valid syntax, but many people are never sure whether they are <<"EOF" or <<'EOF'.

    If your strings are not too long but contain the special characters that correspond with the default delimiters (e.g: ', ", `, / etc.), then you can use the initial letter followed by any arbitrary delimiter notation: m{\A/home/sophie/perl}, q/My name is 'Jack' and I called my dog "Diego"./.

    Slurping a file (i.e: Reading it all into memory)

    One can see several bad ways to read a file into memory in Perl. Among them are:

    # Not portable and suffers from possible # shell code injection. my $contents = `cat $filename`; # Wasteful of CPU and memory: my $contents = join("", <$fh>); # Even more so: my $contents = ''; while (my $line = <$fh>) { $contents .= $line; }

    You should avoid them all. Instead the proper way to read an entire file into a long string is to either use CPAN distributions for that such as or , or alternatively write down the following function and use it:

    sub _slurp { my $filename = shift; open my $in, '<', $filename or die "Cannot open '$filename' for slurping - $!"; local $/; my $contents = <$in>; close($in); return $contents; }     Write code in Paragraphs using Empty Lines

    If one of your blocks is long, split it into "code paragraphs", with empty lines between them and with each paragraph doing one thing. Then, it may be a good idea to precede each paragraph with a comment explaining what it does, or to extract it into its own function or method.

    Use IO::Socket and friends instead of lower-level calls

    One should use the IO::Socket family of modules for networking Input/Output instead of the lower-level socket()/connect()/bind()/etc. calls. As of this writing, contains outdated information demonstrating how to use the lower-level API which is not recommended.

    Subroutine Arguments Handling

    The first thing to know about handling arguments for subroutines is to avoid referring to them directly by index. Imagine you have the following code:

    sub my_function { my $first_name = $_[0]; my $street = $_[1]; my $city = $_[2]; my $country = $_[3]; . . . }

    Now, what if you want to add $last_name between $first_name and $street? You'll have to promote all the indexes after it! Moreover, this scheme is error-prone and you may reuse the same index more than once, or miss some indexes.

    Instead do either:

    sub my_function { my $first_name = shift; my $street = shift; my $city = shift; my $country = shift; . . . }

    Or:

    sub my_function { my ($first_name, $street, $city, $country) = @_; . . . }

    The same thing holds for unpacking @ARGV, the array containing the command-line arguments for a Perl program, or any other array. Don't use $ARGV[0], $ARGV[1] etc. directly, but instead unpack @ARGV using the methods given above. For processing command line arguments, you should also consider using .

    Don’t clobber arrays or hashes

    Often people ask how to pass arrays or hashes to subroutines. The answer is that the right way to do it is to pass them as a reference as an argument to the subroutine:

    sub calc_polynomial { my ($x, $coefficients) = @_; my $x_power = 1; my $result = 0; foreach my $coeff (@{$coefficients}) { $result += $coeff * $x_power; } continue { $x_power *= $x; } return $result; } print "(4*x^2 + 2x + 1)(x = 5) = ", calc_polynomial(5, [1, 2, 4]);

    You shouldn't clobber the subroutine's arguments list with entire arrays or hashes (e.g: my_func(@array1, @array2); or my_func(%myhash, $scalar) ), as this will make it difficult to extract from @_.

    Named Parameters

    If the number of parameters that your subroutine accepts gets too long, or if you have too many optional parameters, make sure you convert it to use named arguments. The standard way to do it is to pass a hash reference or a hash of arguments to the subroutine:

    sub send_email { my $args = shift; my $from_address = $args->{from}; my $to_addresses = $args->{to}; my $subject = $args->{subject}; my $body = $args->{body}; . . . } send_email( { from => 'shlomif@perl-begin.org', to => ['shlomif@perl-begin.org', 'sophie@perl-begin.org'], subject => 'Perl-Begin.org Additions', . . . } );     Avoid using chop() to trim newlines characters from lines

    Don't use the built-in function chop() in order to remove newline characters from the end of lines read using the diamond operator (<>), because this may cause the last character in a line without a line feed character to be removed. Instead, use chomp().

    If you expect to process DOS/Windows-like text files whose lines end with the dual Carriage Return-Line Feed character on Unix systems then use the following in order to trim them: $line =~ s/\x0d?\x0a\z//;.

    For more information see:

    Don't start Modules and Packages with a Lowercase Letter

    Both modules and packages (the latter also known as namespaces) and all intermediate components thereof should always start with an uppercase letter, because modules and packages that start with a lowercase letter are reserved for pragmas. So this is bad:

    # This is file person.pm package person; use strict; use warnings; 1;

    And this would be better:

    # Better code! # This is file MyProject/Person.pm package MyProject::Person; use strict; use warnings; . . . 1;     Avoid Indirect Object Notation

    Don't use the so-called “Indirect-object notation” which can be seen in a lot of old code and tutorials and is more prone to errors:

    my $new_object = new MyClass @params;

    Instead use the MyClass->new(…) notation:

    my $new_object = MyClass->new(@params);

    For more information and the motivation for this advice, see chromatic’s article “The Problems with Indirect Object Notation”.

    $$myarray_ref[$idx] or $$myhash_ref{$key}

    Don't write $$myarray_ref[$idx], which is cluttered and can be easily confused with (${$myarray_ref})->[$idx]. Instead, use the arrow operator - $myarray_ref->[$idx]. This also applies for hash references - $myhash_ref->{$key}.

    C-style for loops

    Some beginners to Perl tend to use C-style-for-loops to loop over an array's elements:

    for (my $i=0 ; $i < @array ; $i++) { # Do something with $array[$i] }

    However, iterating over the array itself would normally be preferable:

    foreach my $elem (@array) { # Do something with $elem. }

    If you still need the index, do:

    foreach my $idx (0 .. $#array) { my $elem = $array[$idx]; # Do something with $idx and $elem. } # perl-5.12.0 and above: foreach my $idx (keys(@array)) { my $elem = $array[$idx]; # Do something with $idx and $elem. } # Also perl-5.12.0 and above. while (my ($idx, $elem) = each(@array)) { # Do something with $idx and $elem. }

    An arbitrary C-style for loop can be replaced with a while loop with a “continue” block.

    Avoid Intrusive Commenting

    Some commenting is too intrusive and interrupts the flow of reading the code. Examples for that are the ######################## hard-rules that some people put in their code, the comments using multiple number signs ("#"), like ####, or excessively long comment block. Please avoid all those.

    Some schools of software engineering argue that if the code's author feels that a comment is needed, it usually indicates that the code is not clear and should be factored better (like extracting a method or a subroutine with a meaningful name.). It probably does not mean that you should avoid writing comments altogether, but excessive commenting could prove as a red flag.

    If you're interested in documenting the public interface of your modules and command-line programs, refer to , Perl's Plain Old Documentation (POD), which allows one to quickly and easily document one's code. POD has many extensions available on CPAN, which may prove of use.

    Accessing Object Slots Directly

    Since Perl objects are simple references some programmers are tempted to access them directly:

    $self->{'name'} = "John"; print "I am ", $self->{'age'}, " years old\n"; # Or even: (Really bad code) $self->[NAME()] = "John";

    However, this is sub-optimal as explained in the Perl for Newbies section about "Accessors", and one should use accessors using code like that:

    # Good code. $self->_name("John"); print "I am ", $self->_age(), " years old\n";

    As noted in the link, you can use one of CPAN's many accessor generators to generate accessors for you.

    '^' and '$' in Regular Expressions

    Some people use "^" and "$" in regular expressions to mean beginning-of-the-string or end-of-the-string. However, they can mean beginning-of-a-line and end-of-a-line respectively using the /m flag which is confusing. It's a good idea to use \A for start-of-string and \z for end-of-string always, and to specify the /m flag if one needs to use "^" and "$" for start/end of a line.

    Magic Numbers

    Your code should not include unnamed numerical constants also known as "magic numbers" or "magic constants". For example, there is one in this code to shuffle a deck of cards:

    for my $i (0 .. 51) { my $j = $i + int(rand(52-$i)); @cards[$i,$j] = @cards[$j,$i]; }

    This code is bad because the meaning of 52 and 51 is not explained and they are arbitrary. A better code would be:

    # Good code. # One of: my $deck_size = 52; Readonly my $deck_size => 52; for my $i (0 .. $deck_size-1) { my $j = $i + int(rand($deck_size-$i)); @cards[$i,$j] = @cards[$j,$i]; }

    (Of course in this case, you may opt to use a shuffle function from CPAN, but this is just for the sake of demonstration.).

    String Variables Enclosed in Double Quotes

    One can sometimes see people write code like that:

    my $name = shift(@ARGV); print "$name", "\n"; if ("$name" =~ m{\At}i) { print "Your name begins with the letter 't'"; }

    However, it's not necessary to enclose $name in double quotes (i.e: "$name") because it's already a string. Using it by itself as $name will do just fine:

    # Better code. my $name = shift(@ARGV); print $name, "\n"; if ($name =~ m{\At}i) { print "Your name begins with the letter 't'"; }

    Also see our page about text generation for other ways to delimit text.

    Note that sometimes enclosing scalar variables in double-quotes makes sense - for example if they are objects with overloaded stringification. But this is the exception rather than the rule.

    @array[$idx] for array subscripting

    Some newcomers to Perl 5 would be tempted to write @array[$index] to subscript a single element out of the array @array. However, @array[$index] is a single-element array slice. To get a single subscript out of @array use $array[$idx] (with a dollar sign). Note that if you want to extract several elements, you can use an array slice such as @array[@indexes] or @array[$x,$y] = @array[$y,$x]. However, then it's a list which should be used in list context.

    Variables called $a and $b

    One should not create lexical variables called $a and $b because there are built-in-variables called that used for sorting and other uses (such as reduce in ), which the lexical variables will interfere with:

    my ($a, $b) = @ARGV; . . . # Won't work now. my @array = sort { length($a) <=> length($b) } @other_array;

    Instead, use other single-letter variable names such as $x and $y, or better yet give more descriptive names.

    Flow Control Statements Without an Explicit Label

    One can sometimes see flow-control statements such as next, last or redo used without an explicit label following them, in which case they default to re-iterating or breaking out of the innermost loop. However, this is inadvisable, because later on, one may modify the code to insert a loop in between the innermost loop and the flow control statement, which will break the code. So always append a label to "next", "last" and "redo" and label your loops accordingly:

    LINES: while (my $line = <>) { if ($line =~ m{\A#}) { next LINES; } }     ($#array + 1) and Other Abuses of $#.

    The $#array notation gives the last index in @array and is always equal to the array length minus one. Some people use it to signify the length of the array:

    my @flags = ((0) x ($#names +1))

    However this is unnecessary because one can better do it by evaluating @names in scalar context, possibly by saying scalar(@names).

    # Better code. my @flags = ((0) x @names);     $array[$#array], $array[$#array-1], etc.

    One can sometimes see people references the last elements of arrays using notation such as $array[$#array], $array[$#array-1] or even $array[scalar(@array)-1]. This duplicates the identifier and is error prone and there's a better way to do it in Perl using negative indexes. $array[-1] is the last element of the array, $array[-2] is the second-to-last, etc.

    Interpolating Strings into Regular Expressions

    One can often see people interpolate strings directly into regular expressions:

    my $username = shift(@ARGV); open my $pass_fh, '<', '/etc/passwd' or die "Cannot open /etc/passwd - $!"; PASSWD: while (my $line = <$pass_fh>) { if ($line =~ m{\A$username}) \# Bad code here. { print "Your username is in /etc/passwd\n"; last PASSWD; } } close($pass_fh);

    The problem is that when a string is interpolated into a regular expression it is interpolated as a mini-regex, and special characters there behave like they do in a regular expression. So if I input '.*' into the command line in the program above, it will match all lines. This is a special case of code or markup injection.

    The solution to this is to use \Q and \E to signify a quotemeta() portion that will treat the interpolated strings as plaintext with all the special characters escaped. So the line becomes: if ($line =~ m{\A\Q$username\E}).

    Alternatively, if you do intend to interpolate a sub-regex, signify this fact with a comment. And be careful with regular expressions that are accepted from user input.

    Overusing $_

    It's a good idea not to overuse $_ because using it, especially in large scopes, is prone to errors, including many subtle ones. Most Perl operations support operating on other variables and you should use lexical variables with meaningful names instead of $_ whenever possible.

    Some places where you have to use $_ are map, grep and other functions like that, but even in that case it might be desirable to set a lexical variable to the value of $_ right away: map { my $line = $_; … } @lines.

    Mixing Tabs and Spaces

    Some improperly configured text editors may be used to write code that, while indented well at a certain tab size looks terrible on other tab sizes, due to a mixture of tabs and spaces. So either use tabs for indentation or make sure your tab key expands to a constant number of spaces. You may also wish to make use of to properly format your code.

    `…` or qx// for Executing Commands

    Some people are tempted to use backticks (`…`) or qx/…/ for executing commands for their side-effects. E.g:

    use strict; use warnings; my $temp_file = "tempfile.txt"; `rm -f $temp_file`;

    However, this is not idiomatic because `…` and qx/…/ are used to trap a command's output and to return it as a big string or as a list of lines. It would be a better idea to use system() or to seek more idiomatic Perl-based solutions on CPAN or in the Perl core (such as using unlink() to delete a file in our case.).

    Some people even go and ask how to make the qx/…/ output go to the screen, which is a clear indication that they want to use system().

    No Explicit Returns

    As noted in "Perl Best Practices", all functions must have an explicit “return” statement, as otherwise they implicitly return the last expression, which would be subject to change upon changing the code. If you don't want the subroutine to return anything (i.e: it's a so-called "procedure"), then write return; to always return a false value, which the caller won't be able to do anything meaningful with.

    Another mistake is to write "return 0;" or "return undef;" to return false, because in list context, they will return a one-element list which is considered true. So always type return; to return false.

    "Varvarname" - Using a variable as another variable's name.

    Mark Jason Dominus has written about varvarname - "Why it's stupid to `use a variable as a variable name'", namely if $myvar is 'foobar' they want to operate on the value of $foobar. While there are ways to achieve similar things in Perl, the best way is to use hashes (possibly pointing to complex records with more information) and lookup them by the string you want to use. Read the link by Mark Jason Dominus for more information.

    Use Leading Underscores ('_') for Internal Methods and Functions

    When writing a module use leading underscores in identifiers of methods and functions to signify those that are: 1. Subject to change. 2. Are used internally by the module. 3. Should not be used from outside. By using one can make sure that the external API of the module is documented and it will skip the identifiers with leading underscores, that can be thought of as "private" ones.

    Here's an example:

    package Math::SumOfSquares; use strict; use warnings; use List::Utils qw(sum); sub _square { my $n = shift; return $n * $n; } sub sum_of_squares { my ($numbers) = @_; return sum(map { _square($_) } @$numbers); } 1;     print $fh @args

    It is preferable to write print {$write_fh} @args over print $write_fh @args because the latter can more easily be mistaken for print $write_fh, @args (which does something different) and does not provide enough visual hints that you are writing to the $write_fh filehandle. Therefore, always wrap the file-handle in curly braces (so-called "dative block"). (Inspired by "Perl Best Practices").

    Using STDIN instead of ARGV

    One can write code while reading from STDIN:

    use strict; use warnings; # Strip comments. LINES: while (my $line = <STDIN>) { if ($line =~ m{\A *#}) { next LINES; } print $line; }

    However, it is usually better to use ARGV instead of STDIN because it also allows processing the filenames from the command line. This can also be achieved by simply saying <>. So the code becomes:

    # Better code: use strict; use warnings; # Strip comments. LINES: while (my $line = <>) { if ($line =~ m{\A *#}) { next LINES; } print $line; }     Modifying arrays or hashes while iterating through them.

    Some people ask about how to add or remove elements to an existing array or hash when iterating over them using “foreach” and other loops. The answer to that is that Perl will likely not handle it too well, and it expects that during loops the keys of a data structure will remain constant.

    The best way to achieve something similar is to populate a new array or hash during the loop by using push() or a hash lookup and assignment. So do that instead.

    Comments and Identifiers in a Foreign Language

    Apparently, many non-native English speakers write code with comments and even identifiers in their native language. The problem with this is that programmers who do not speak that language will have a hard time understanding what is going on here, especially after the writers of the foreign language code post it in to an Internet forum in order to get help with it.

    Consider what Eric Raymond wrote in his "How to Become a Hacker" document (where hacker is a software enthusiast and not a computer intruder):

    4. If you don't have functional English, learn it.

    As an American and native English-speaker myself, I have previously been reluctant to suggest this, lest it be taken as a sort of cultural imperialism. But several native speakers of other languages have urged me to point out that English is the working language of the hacker culture and the Internet, and that you will need to know it to function in the hacker community.

    Back around 1991 I learned that many hackers who have English as a second language use it in technical discussions even when they share a birth tongue; it was reported to me at the time that English has a richer technical vocabulary than any other language and is therefore simply a better tool for the job. For similar reasons, translations of technical books written in English are often unsatisfactory (when they get done at all).

    Linus Torvalds, a Finn, comments his code in English (it apparently never occurred to him to do otherwise). His fluency in English has been an important factor in his ability to recruit a worldwide community of developers for Linux. It's an example worth following.

    Being a native English-speaker does not guarantee that you have language skills good enough to function as a hacker. If your writing is semi-literate, ungrammatical, and riddled with misspellings, many hackers (including myself) will tend to ignore you. While sloppy writing does not invariably mean sloppy thinking, we've generally found the correlation to be strong — and we have no use for sloppy thinkers. If you can't yet write competently, learn to.

    So if you're posting code for public scrutiny, make sure it is written with English identifiers and comments.

    Using perlform for formatting text.

    One should not use “perlform” for formatting text, because it makes use of global identifiers, and should use the CPAN distribution instead. Also see our text generation page for more information. (Inspired by "Perl Best Practices").

    Using $obj->new for object construction.

    Sometimes you can see class constructors such as:

    sub new { my $proto = shift; my $class = ref($proto) || $proto; my $self = {}; … }

    The problem here is that this allows one to do $my_object_instance->new to create a new instance of the object, but many people will expect it to be invalid or to clone the object. So don't do that and instead write your constructors as:

    # Better code: sub new { my $class = shift; my $self = {}; bless $self, $class; … }

    Which will disable it and will just allow ref($my_object_instance)->new(…). If you need a clone method, then code one called "clone()" and don't use "new" for that.

    (Thanks to Randal L. Schwartz's post "Constructing Objects" for providing the insight to this).

    Law of Demeter

    See the Wikipedia article about "Law of Demeter" for more information. Namely, doing many nested method calls like $self->get_employee('sophie')->get_address()->get_street() is not advisable, and should be avoided.

    A better option would be to provide methods in the containing objects to access those methods of their contained objects. And an even better way would be to structure the code so that each object handles its own domain.

    Passing parameters in delegation

    Sometimes we encounter a case where subroutines each pass the same parameter to one another in delegation, just because the innermost subroutines in the callstack need it.

    To avoid it, create a class, and declare methods that operate on the fields of the class, where you can assign the delegated arguments.

    Duplicate Code

    As noted in Martin Fowler's "Refactoring" book (but held as a fact for a long time beforehand), duplicate code is a code smell, and should be avoided. The solution is to extract duplicate functionality into subroutines, methods and classes.

    Long Functions and Methods

    Another common code smell is long subroutines and methods. The solution to these is to extract several shorter methods out, with meaningful names.

    Using map instead of foreach for side-effects

    You shouldn't be using map to iterate on a list instead of foreach if you're not interested in constructing a new list and all you are interested in are the side-effects. For example:

    use strict; use warnings; map { print "Hello $_!\n"; } @ARGV;

    Would be better written as:

    use strict; use warnings; foreach my $name (@ARGV) { print "Hello $name!\n"; }

    Which better conveys one's intention and may be a bit more efficient.

    Using the ternary operator for side-effects instead of if/else

    A similar symptom to the above is people who wish to use the ternary inline- conditional operator (? :) for choosing to execute between two different statements with side-effects instead of using if and else. For example:

    $cond_var ? ($hash{'if_true'} .= "Cond var is true") : ($hash{'if_false'} .= "Cond var is false")

    (This is assuming the ternary operator was indeed written correctly, which is not always the case).

    However, the ternary operator is meant to be an expression that is a choice between two values and should not be used for its side-effects. To do the latter, just use if and else:

    if ($cond_var) { $hash{'if_true'} .= "Cond var is true"; } else { $hash{'if_false'} .= "Cond var is false"; }

    This is safer, and better conveys one’s intentions.

    For more information, refer to a relevant thread on the Perl beginners mailing list (just make sure you read it in its entirety).

    Nested top-level subroutines

    One should not nest an inner top-level subroutine declared using sub inner inside of an outer one, like so:

    sub outer { sub inner { . . . } # Use inner here }

    This code will compile and run, but may break in subtle ways.

    The first problem with this approach is that inner() will still be visible outside outer(), but the more serious problem is that the inner subroutine will only get one copy of the lexical variables inside outer().

    The proper and safer way to declare an inner subroutine is to declare a lexical variable and set it to an anonymous subroutine, which is also known as a closure:

    sub outer { my ($foo, $bar) = @_; my $print_foo = sub { print "Foo is '$foo'\n"; return; }; $print_foo->(); $foo++; $print_foo->(); return; }     Using grep instead of any and friends

    Sometimes one can see people using grep to find the first matching element in an array, or whether such an element exists at all. However, grep is intended to extract all matching elements out of a list, not just the first one, and as a result will not stop until it finds them all. To remedy this look at either first() from (to find the first match) or "any/all/notall/none" from (to find whether a single element exists). These better convey one's intention and may be more efficient because they stop on the first match.

    One should note that if one does such lookups often, then they should try to use a hash instead.

    Using the FileHandle Module

    The FileHandle module is old and bad, and should not be used. One should use the IO::Handle family of modules instead.

    "Including" files instead of using Modules

    We are often asked how one can "include" a file in a Perl program (similar to PHP's include or the shell's "source" or "." operators. The answer is that the better way is to extract the common functionality from all the programs into modules and load them by using "use" or "require".

    Note that do can be used to evaluate a file (but in a different scope), but it's almost always not needed.

    Some people are looking to supply a common configuration to their programs as global variables in the included files, and those people should look at CPAN configuration modules such as or the various JSON modules for the ability to read configuration files in a safer and better way.

    Using Global Variables as an Interface to the Module

    While it is possible to a large extent, one should generally not use global variables as an interface to a module, and should prefer having a procedural or an object oriented interface instead. For information about this see our page about modules and packages and our our page about object oriented programming in Perl.

    Declaring all variables at the top

    Some inexperienced Perl programmers, possibly by influence from languages such as C, like to declare all variables used by the program at the top of the program or the relevant subroutines. Like so:

    my $first_name; my $last_name; my $address; my @people; my %cities; . . .

    However, this is bad form in Perl, and the preferable way is to declare all the variables when they are first used, and at the innermost scope where they should retain their value. This will allow to keep track of them better.

    Using Switch.pm

    One should not use Switch.pm to implement a switch statement because it's a source filter, tends to break a lot of code, and causes unexpected problems. Instead one should either use given/when, which are only available in perl-5.10 and above, or dispatch tables, or alternatively plain if/elsif/else structures.

    Using threads in Perl

    Some beginners, when thinking they need to multitask their programs start thinking they should use perl threads. However, as mentioned in , perl threads are very much unlike the traditional thread modules, share nothing by default and are in fact heavyweight processes (instead of the usual lightweight ones). See also Elizabeth Mattijsen’s write-up about perl's ithreads on perlmonks.

    To sum up, usually threads are the wrong answer and you should be using forking processes or something like POE (see our page about multitasking) instead.

    Calling Shell Commands Too Much

    Some people are tempted to use shell commands for performing various tasks using `…`, qx/…/, system(), piped-open, etc. However, usually Perl has built-in routines or alternatively CPAN modules, which are more portable, and often would be faster than calling the shell for help, and they should be used instead.

    As an extreme example, the site The Daily WTF had a feature which featured the following code to determine the file size in Perl:

    my $filesize = `wc -c $file | cut -c0-8 | sed 's/ //g'`;

    Reportedly, replacing this line with my $filesize = -s $file (which as noted earlier should have been called $filename instead), resulted in the program being 75 minutes faster on average (!).

    Normally, if you find yourself using UNIX text processing commands such as “sed”, “awk”, “grep”, and “cut”, you should implement it in pure-Perl code.

    Missing Semicolons at the end of blocks

    The perl interpreter allows one to omit the last trailing semicolon (";") in the containing block. Like so:

    if ( COND() ) { print "Success!\n"; call_routine() \# No semicolon here. }

    However, this isn't a good idea, because it is inconsistent, and may cause errors (or obscure failures) if one-or-more statements are added afterwards.

    As a result, you should end every statement with a semicolon (";") even i it’s the last one. A possible exception to this may be single-line and/or single-statement blocks like in map.

    List form of open with one argument.

    Recent versions of of perl introduced the list-forms of piping to and from a command, such as open my $fh, '-|', 'fortune', $collection or open my $printer, '|-', 'lpr', '-Plp1'. However, not only they are not implemented on Windows and other UNIX-like systems yet, but when one passes only one argument to them, they pass it to the shell verbatim.

    As a result, if one passes an array variable to them, as in:

    open my $fh, '-|', @foo or die "Could not open program! - $!"

    One can pass only a single argument to @foo, which would be dangerous. To mitigate that, one should use the or the CPAN distributions.

    Trailing Whitespace

    With many editors, it can be common to write new code or modify existing one, so that some lines will contain trailing whitespace, such as spaces (ASCII 32 or 0x20) or tabs characters. These trailing spaces normally do not cause much harm, but they are not needed and can be distracted.

    While you should not feel bad about having trailing space, it is a good idea to sometimes search for them using a command such as ack '[ \t]+$' (or ack -a '[ \t]+$' for completeness - see ack, and get rid of them.

    Some editors also allow you to highlight trailing whitespace when present. See for example:

    Misusing String Eval

    String eval allows one to compile and execute (possibly generated) strings as Perl expressions. While it is a powerful feature, there are usually better and safer ways to achieve what you want using string eval "". So you should only use it, if you are an expert and really know what you are doing.

    Related to string eval, is using two or more /e flags in the s/// substitution. While one /e flag is often useful (for example when substituting counters like in s/#\./($i++)."."/ge) the second /e flags just evaluates the generated expression again. This can easily be done with using string eval inside the right-hand-side, assuming it is needed which is normally not the case.

    Named Parameters That Start With Dash

    If you're defining interfaces that accept a flattened hash or a hash reference of named parameters, there is no need to call the parameters with keys starting with a dash, like so:

    my $obj = MyClass->new( { -name => "George", -occupation => "carpenter", -city => "Inverness", } );

    The dashes are not needed because Perl can safely escape and deal with plain names that only contain alphanumeric characters and underscores, and they just add clutter to the code. Named arguments starting with dashes were prevalent in some early modules such as or , but they should not be used in more modern modules.

    Instead, design your interfaces with calling conventions like so:

    my $obj = MyClass->new( { name => "George", occupation => "carpenter", city => "Inverness", } );     Code and Markup Injection

    Care must be taken when constructing statements that are passed to an interpreter, when putting arbitrary strings inside (using string interpolation or other methods). This is because if the strings are subject to input from the outside world (including the users), then one can use specially crafted strings for executing arbitrary commands and exploiting the system.

    An example of this is outputting HTML using print "<p>" . $paragraph_text . "</p>\n"; which may allow inserting arbitrary, malicious, markup inside $paragraph_text, which may include malicious JavaScript, that can steal passwords or alter the page’s contents.

    For more information, see:

    1. “Code/Markup Injection and Its Prevention” resource on this site.

    2. Wikipedia articles about SQL injection and Cross-site scripting.

    3. The site Bobby Tables about SQL injections.

    Initializing Arrays and Hashes from Anonymous References

    Some beginners to Perl are tempted to use the anonymous array reference constructor ([ … ]) to initialise array variables, or alternatively anonymous hash references ({ … }) to initialise hash variables, like so:

    my @arr = [1 .. 10]; my %uk_info = { continent => "Europe", capital => "London", };

    However, these reference constructors actually create a single scalar that contains a reference and, as a result, in the case of the array, one will have a single element array, and in case of the hash, one will have an error with a hash that was initialised only with a single key (that was converted to a nonsensical string).

    Array and hash variables should be initialized using lists enclosed in parentheses:

    my @arr = (1 .. 100); my %uk_info = ( continent => "Europe", capital => "London", );

    For more information about the difference between references and aggregate variables, refer to our references page.

    Overly Long Lines in the Source Code

    It is a good idea to avoid overly long lines in the source code, because they need to be scrolled to read, and may not fit within the margins of your co-developers’ text editors. If the lines are too long, you should break them or reformat them (for example, by adding a newline before or after an operator), and by breaking long string constants into several lines using the string concatenation operator - ..

    Many coding standards require lines to fit within 80 characters or 78 characters or so, and you should standardise on a similar limit for your own code.

    Getting rid of special entries in directory contents

    Calling readdir() repetitively, or calling it in list context will normally return the two special entries of . (the same directory) and .. (the parent directory) which should not be checked, and should normally be ignored. One can often find that people are trying to skip them in various sub-optimal ways:

    if ($dir_entry =~ m/\A\./) # Will skip all directories that start with dot. if ($dir_entry =~ m/^\./) # Same but \A is preferable for start-of-string. if ($dir_entry =~ m/\A\.\.?\z/) # Obfuscated. if ($dir_entry =~ m/\A\.{1,2}\z/) # Not much better. if ($dir_entry eq "." or $dir_entry eq "..") # May not be portable.

    The best way to do that is to use ’s no_upwards() function:

    foreach my $entry (File::Spec->no_upwards(readdir($dir_handle)) { }

    Note that wraps that for you in its read_dir() function and other file system abstraction modules provide similar functionality.

    Assigning a List to a Scalar Variable

    Normally, assigning from a function or an expression that returns a list to a scalar variable, will not yield what you want:

    my $characters = split(//, $string);

    This will cause the list as returned by split to be evaluated in scalar context, and to return a single (and not very meaningful) scalar item. You normally want one of those:

    my @characters = split(//, $string); my $chars_aref = [ split(//, $string) ]; my $num_chars = () = split(//, $string); \# Use length instead in this case.

    A lot of the confusion stems from the fact that people expect arrays in Perl to be contained directly in scalars. For more information about that, consult our page about references.

    Regular Expressions starting or ending with “.*”

    It is not necessary to put .* or .*? into the beginning or end of regular expressions to match something anywhere inside the string. So for example if ($hay_stack =~ /.*ab+c.*/) can be replaced with the simpler: if ($hay_stack =~ /ab+c/). If you wish to match and extract the prefix, you should say (.*?) or (.*).

    Recursive Directory Traversal Without Using File::Find and Friends

    Some beginners to Perl are tempted to write a recursive directory traversal (i.e: finding all files in a directory, its sub-directories, its sub-sub-directories, etc.) by using procedural recursion or other sub-optimal means. However, the idiomatic way is to use the core module File::Find or its CPAN friends. For more information, see our resources about directory traversal.

    Using File::Find for listing the contents of a directory non-recursively

    Alternatively, sometimes people are tempted to use File::Find or similar modules to non-recursively list the contents of a single directory. However, in this case, it is a better idea to simply use opendir(), readdir() and closedir(), in conjunction with no_upwards, or an abstraction of them.

    File::Find and friends should be reserved for a recursive traversal.

    Populating an Array with Multiple Copies of the Same Reference

    You can sometimes see code like that:

    my @array_of_arrays = ([]) x $num_rows;

    Or:

    my @row; my @array_of_rows; foreach my $elem (@existing_array) { @row = generate_row($elem); push @array_of_rows, \@row; }

    The problem with code like this is that the same referent (see our resources about references in Perl) is being used in all places in the array, and so they will always be synchronised to the same contents.

    As a result, the two code excerpts should be written as such instead:

    my @array_of_arrays = map { [] } (1 .. $num_rows);

    And:

    my @array_of_rows; foreach my $elem (@existing_array) { my @row = generate_row($elem); push @array_of_rows, \@row; }

    Or alternatively:

    my @array_of_rows; foreach my $elem (@existing_array) { push @array_of_rows, [generate_row($elem)]; }     Conditional my declarations.

    It is not a good idea to append a trailing if statement modifier to a declaration of a lexical variable using my:

    my $var = VALUE() if (COND()); my ($var1, @array2) if (COND());

    This code might compile and appear to run but you probably want to declare a lexical variable for the rest of its scope. If you need to assign to it conditionally, then do it in a separate statement:

    my $var; if (COND()) { $var = VALUE(); }     Using One Variable for Two (or More) Different Purposes

    Within the scope of its declaration, a variable should serve one purpose, and serve it well. One should not re-use a variable for a completely different purpose later on in the scope. Creating new variables is cheap in Perl and should not be a concern to avoid clarity.

    Using \1 instead of $1 on the Right Hand Side of a Substitution

    There is no good reason to use \\1, \\2, etc. in the right-hand-side of a substitution instead of $1 $2 etc. While this may work, the backslash-digits variables are aimed at back-references, such as matching the exact string of a capture again within the left hand side of a regular expression:

    $s =~ s/(H\w+)\s+(W\w+)/\1 [=] \2/;

    Better code:

    $s =~ s/(H\w+)\s+(W\w+)/$1 [=] $2/;     Premature Optimisation

    On various online Perl forums, we are often getting asked questions like: “What is the speediest way to do task X?” or “Which of these pieces of code will run faster?”. The answer is that in this day and age of extremely fast computers, you should optimise for clarity and modularity first, and worry about speed when and if you find it becomes a problem. Remember Professor Don Knuth’s words that “Premature Optimisation is the root of all evil.” (attributing it to C.A.R. Hoare).

    If you do find that your program runs too slowly, refer to our page about Optimising and Profiling Perl code, but don't optimise prematurely.

    Not Using Version Control

    For everything except for short throwaway scripts, or otherwise incredibly short programs, there is no good excuse, not to use a version control system (a.k.a: "revision control systems", "source control systems", or more in general as part of "software configuration management"). This is especially true nowadays given the availability of several powerful, easy to use, open-source (and as a result free-of-charge), and cross-platform, version control systems, that you should have not a lot of problems to deploy, learn and use.

    For more information and the motivation behind using version control systems, see the relevant section out of the fifth part of “Perl for Perl Newbies” for more discussion about the motivation behind that, some links and a demonstration.

    Some links for further discussion:

    Writing Automated Tests

    Automated tests help verify that the code is working correctly, that bugs are not introduced due to refactoring or the addition of new feature, and also provide specifications and interface documentation to the code. As a result, automated tests have been considered a good practise for a long time.

    For more information about how to write automated tests, see our page about quality assurance in Perl.

    Sources of This Advice

    This is a short list of the sources from which this advice was taken which also contains material for further reading:

    1. The Book "Perl Best Practices" by Damian Conway - contains a lot of good advice and food for thought, but sometimes should be deviated from. Also see the "PBP Module Recommendation Commentary" on the Perl 5 Wiki.

    2. "Ancient Perl" on the Perl 5 Wiki.

    3. chromatic's "Modern Perl" Book and Blog

    4. The book Refactoring by Martin Fowler - not particularly about Perl, but still useful.

    5. The book The Pragmatic Programmer: From Journeyman to Master - also not particularly about Perl, and I found it somewhat disappointing, but it is an informative book.

    6. Advice given by people on Freenode's #perl channel, on the Perl Beginners mailing list, and on other Perl forums.

    XML-LibXSLT-1.95/t/data/vered-xml-to-docbook.xslt0000644000076400007640000001723312300401734021254 0ustar shlomifshlomif 5.0 # Bad code http://perldoc.perl.org/ .html http://perldoc.perl.org/functions/ .html http://metacpan.org/module/ http://metacpan.org/module/ http://metacpan.org/release/ XML-LibXSLT-1.95/t/05quick.t0000644000076400007640000000356012022073774015144 0ustar shlomifshlomif use strict; use warnings; # Should be 12. use Test::More tests => 12; use XML::LibXSLT; use XML::LibXML; # this test is here because Mark Cox found a segfault # that occurs when parse_stylesheet is immediately followed # by a transform() my $parser = XML::LibXML->new(); my $xslt = XML::LibXSLT->new(); # TEST ok($parser, ' TODO : Add test name'); # TEST ok($xslt, ' TODO : Add test name'); my $source = $parser->parse_file('example/1.xml'); # TEST ok($source, ' TODO : Add test name'); my ($out1, $out2); { my $style_doc = $parser->parse_file('example/1.xsl'); my $stylesheet = $xslt->parse_stylesheet($style_doc); my $results = $stylesheet->transform($source); $out1 = $stylesheet->output_string($results); # TEST ok($out1, ' TODO : Add test name'); } { $source = $parser->parse_file('example/2.xml'); # TEST ok($source, ' TODO : Add test name'); my $style_doc = $parser->parse_file('example/2.xsl'); my $stylesheet = $xslt->parse_stylesheet($style_doc); my $results = $stylesheet->transform($source); # TEST ok($stylesheet->media_type, ' TODO : Add test name'); # TEST ok($stylesheet->output_method, ' Test existence of output method'); $out2 = $stylesheet->output_string($results); # TEST ok($out2, ' TODO : Add test name'); } { my $style_doc = $parser->parse_file('example/1.xsl'); my $stylesheet = $xslt->parse_stylesheet($style_doc); my $results = $stylesheet->transform_file('example/1.xml'); my $out = $stylesheet->output_string($results); # TEST ok ($out, ' TODO : Add test name' ); # TEST is ($out1, $out, ' TODO : Add test name' ); } { my $style_doc = $parser->parse_file('example/2.xsl'); my $stylesheet = $xslt->parse_stylesheet($style_doc); my $results = $stylesheet->transform_file('example/2.xml'); my $out = $stylesheet->output_string($results); # TEST ok( $out, ' TODO : Add test name' ); # TEST is ($out2, $out, ' TODO : Add test name' ); } XML-LibXSLT-1.95/t/07blankdoc.t0000644000076400007640000000405212321504771015602 0ustar shlomifshlomifuse strict; use warnings; # Should be 5. use Test::More tests => 5; use XML::LibXSLT; my $parser = XML::LibXML->new(); my $xslt = XML::LibXSLT->new(); # TEST ok($parser, 'parser was initted.'); # TEST ok($xslt, 'xslt object was initted.'); local $XML::LibXML::match_cb = \&match_cb; local $XML::LibXML::open_cb = \&open_cb; local $XML::LibXML::close_cb = \&close_cb; local $XML::LibXML::read_cb = \&read_cb; my $source = $parser->parse_string(<<'EOT','/foo'); EOT my $foodoc = <<'EOT'; typed data in stylesheet Data: EOT my $style = $parser->parse_string($foodoc,'foo'); # TEST ok($style, '$style is true'); my $stylesheet = $xslt->parse_stylesheet($style); # my $stylesheet = $xslt->parse_stylesheet_file("example/document.xsl"); my $results = $stylesheet->transform($source); # TEST ok ($results, 'Results are true.'); # TEST like ($results->toString, qr/typed data in stylesheet/, 'found "typed data in stylesheet"'); ############################################################### # Callbacks - this is needed because with document('') now, # libxslt expects to re-get the entire file and re-parse it, # rather than its old behaviour, which was to use the internal # DOM. So we have to use callbacks to be able to return the # original file. We also need to make sure that the call # to $parser->parse_string($foodoc, 'foo') gets a URI (second # param), otherwise it doesn't know what to fetch. sub match_cb { my $uri = shift; if ($uri eq 'foo') { return 1; } return 0; } sub open_cb { my $uri = shift; return \$foodoc; } sub close_cb { } sub read_cb { return substr(${$_[0]}, 0, $_[1], ""); } XML-LibXSLT-1.95/t/13error.t0000644000076400007640000000703612321504776015165 0ustar shlomifshlomifuse strict; use warnings; # Should be 28. use Test::More tests => 28; $|=1; use XML::LibXSLT; # TEST ok(1, ' TODO : Add test name'); my $bad_xsl1 = 'example/bad1.xsl'; my $bad_xsl2 = 'example/bad2.xsl'; my $bad_xsl3 = 'example/bad3.xsl'; my $fatal_xsl = 'example/fatal.xsl'; my $nonfatal_xsl = 'example/nonfatal.xsl'; my $good_xsl = 'example/1.xsl'; my $good_xml = 'example/1.xml'; my $bad_xml = 'example/bad2.xsl'; my $xslt = XML::LibXSLT->new; # TEST ok($xslt, ' TODO : Add test name'); { my $stylesheet = XML::LibXML->new->parse_file($bad_xsl1); undef $@; eval { $xslt->parse_stylesheet($stylesheet) }; # TEST ok( $@, ' TODO : Add test name' ); } { undef $@; eval { XML::LibXML->new->parse_file($bad_xsl2) }; # TEST ok( $@, ' TODO : Add test name' ); } { my $stylesheet = XML::LibXML->new->parse_file($good_xsl); # TEST ok( $stylesheet, ' TODO : Add test name' ); my $parsed = $xslt->parse_stylesheet( $stylesheet ); # TEST ok( $parsed, ' TODO : Add test name' ); undef $@; eval { $parsed->transform_file( $bad_xml ); }; # TEST ok( $@, ' TODO : Add test name' ); } { my $stylesheet = XML::LibXML->new->parse_file($nonfatal_xsl); # TEST ok( $stylesheet, ' TODO : Add test name' ); my $parsed = $xslt->parse_stylesheet( $stylesheet ); # TEST ok( $parsed, ' TODO : Add test name' ); undef $@; my $warn; local $SIG{__WARN__} = sub { $warn = shift; }; eval { $parsed->transform_file( $good_xml ); }; # TEST ok( !$@, ' TODO : Add test name' ); # TEST is( $warn , "Non-fatal message.\n", ' TODO : Add test name' ); } { my $parser = XML::LibXML->new; my $stylesheet = $parser->parse_file($bad_xsl3); # TEST ok( $stylesheet, ' TODO : Add test name' ); my $parsed = $xslt->parse_stylesheet( $stylesheet ); # TEST ok( $parsed, ' TODO : Add test name' ); undef $@; eval { $parsed->transform_file( $good_xml ); }; # TEST ok( $@, ' TODO : Add test name' ); my $dom = $parser->parse_file( $good_xml ); # TEST ok( $dom, ' TODO : Add test name' ); undef $@; eval { $parsed->transform( $dom ); }; # TEST ok( $@, ' TODO : Add test name' ); } { my $parser = XML::LibXML->new; my $stylesheet = $parser->parse_file($fatal_xsl); # TEST ok( $stylesheet, ' TODO : Add test name' ); my $parsed = $xslt->parse_stylesheet( $stylesheet ); # TEST ok( $parsed, ' TODO : Add test name' ); undef $@; eval { $parsed->transform_file( $good_xml ); }; # TEST ok( $@, ' TODO : Add test name' ); my $dom = $parser->parse_file( $good_xml ); # TEST ok( $dom, ' TODO : Add test name' ); undef $@; eval { $parsed->transform( $dom ); }; # TEST ok( $@, ' TODO : Add test name' ); } { my $parser = XML::LibXML->new(); # TEST ok( $parser, ' TODO : Add test name' ); my $doc = $parser->parse_string(< XML # TEST ok( $doc, ' TODO : Add test name' ); my $xslt = XML::LibXSLT->new(); my $style_doc = $parser->parse_string(< XSLT # TEST ok( $style_doc, ' TODO : Add test name' ); my $stylesheet = $xslt->parse_stylesheet($style_doc); # TEST ok( $stylesheet, ' TODO : Add test name' ); my $results; eval { $results = $stylesheet->transform($doc); }; my $E = $@; # TEST ok( $E, ' TODO : Add test name' ); # TEST like ( $E, qr/unregistered variable foo|variable 'foo' has not been declared/i, 'Exception matches.' ); # TEST like ( $E, qr/element value-of/, 'Exception matches "element value-of"' ); } XML-LibXSLT-1.95/t/01basic.t0000644000076400007640000000214311647605042015102 0ustar shlomifshlomifuse strict; use warnings; use vars qw($loaded); use Test::More tests => 4; use XML::LibXSLT; # TEST ok(1, ' TODO : Add test name'); my $p = XML::LibXSLT->new(); # TEST ok($p, ' TODO : Add test name'); # TEST is(XML::LibXSLT::LIBXSLT_VERSION(), XML::LibXSLT::LIBXSLT_RUNTIME_VERSION(), 'LIBXSLT_VERSION is the same as the runtime version.'); # TEST is(XML::LibXML::LIBXML_VERSION(), XML::LibXML::LIBXML_RUNTIME_VERSION(), 'LibXML version is the same as its run time version.'); warn "\n\nCompiled against: ", "libxslt ",XML::LibXSLT::LIBXSLT_VERSION(), ", libxml2 ",XML::LibXML::LIBXML_VERSION(), "\nRunning: ", "libxslt ",XML::LibXSLT::LIBXSLT_RUNTIME_VERSION(), ", libxml2 ",XML::LibXML::LIBXML_RUNTIME_VERSION(), "\nCompiled with EXSLT: ", (XML::LibXSLT::HAVE_EXSLT() ? 'yes' : 'no'), "\n\n"; if (XML::LibXSLT::LIBXSLT_VERSION() != XML::LibXSLT::LIBXSLT_RUNTIME_VERSION() or XML::LibXML::LIBXML_VERSION() != XML::LibXML::LIBXML_RUNTIME_VERSION() ) { warn "DO NOT REPORT THIS FAILURE: Your setup of library paths is incorrect!\n\n"; } XML-LibXSLT-1.95/t/14security.t0000644000076400007640000002257212321505001015664 0ustar shlomifshlomifuse strict; use warnings; # Should be 26. use Test::More tests => 26; use XML::LibXSLT; use XML::LibXML 1.59; use Data::Dumper; use Devel::Peek; use IO::Socket::INET; my $parser = XML::LibXML->new(); print "# parser\n"; # TEST ok($parser, ' TODO : Add test name'); my $xslt = XML::LibXSLT->new(); print "# xslt\n"; # TEST ok($xslt, ' TODO : Add test name'); my $stylsheetstring = <<'EOT'; Know Your Dromedaries

    foo:

    wrote:

    No file given     EOT # We're using input callbacks so that we don't actually need real files while # testing the security callbacks my $icb = XML::LibXML::InputCallback->new(); # TEST ok($icb, ' TODO : Add test name'); print "# registering input callbacks\n"; $icb->register_callbacks( [ \&match_cb, \&open_cb, \&read_cb, \&close_cb ] ); $xslt->input_callbacks($icb); my $scb = XML::LibXSLT::Security->new(); # TEST ok($scb, ' TODO : Add test name'); print "# registering security callbacks\n"; $scb->register_callback( read_file => \&read_file ); $scb->register_callback( write_file => \&write_file ); $scb->register_callback( create_dir => \&create_dir ); $scb->register_callback( read_net => \&read_net ); $scb->register_callback( write_net => \&write_net ); $xslt->security_callbacks($scb); my $stylesheet = $xslt->parse_stylesheet($parser->parse_string($stylsheetstring)); print "# stylesheet\n"; # TEST ok($stylesheet, ' TODO : Add test name'); # test local read # --------------------------------------------------------------------------- # - test allowed my $doc = $parser->parse_string('allow.xml'); my $results = $stylesheet->transform($doc); print "# local read results\n"; # TEST ok($results, ' TODO : Add test name'); my $output = $stylesheet->output_string($results); #warn "output: $output\n"; print "# local read output\n"; # TEST like ($output, qr/foo: Text here/, 'Output matches foo'); # - test denied $doc = $parser->parse_string('deny.xml'); eval { $results = $stylesheet->transform($doc); }; { my $E = $@; print "# local read denied\n"; # TEST like ($E, qr/read for deny\.xml refused/, 'Exception gives read for deny.xml'); } # test local write & create dir # --------------------------------------------------------------------------- # - test allowed (no create dir) my $file = 't/allow.xml'; $doc = $parser->parse_string("$file"); $results = $stylesheet->transform($doc); print "# local write (no create dir) results\n"; # TEST ok($results, ' TODO : Add test name'); $output = $stylesheet->output_string($results); #warn "output: $output\n"; print "# local write (no create dir) output\n"; # TEST like($output, qr/wrote: \Q$file\E/, 'Output matches wrote.'); # TEST ok(scalar(-s $file), ' TODO : Add test name'); unlink $file; # - test allowed (create dir) $file = 't/newdir/allow.xml'; $doc = $parser->parse_string("$file"); $results = $stylesheet->transform($doc); print "# local write (create dir) results\n"; # TEST ok($results, ' TODO : Add test name'); $output = $stylesheet->output_string($results); #warn "output: $output\n"; print "# local write (create dir) output\n"; # TEST like ($output, qr/wrote: \Q$file\E/, 'Output matches wrote'); print "# local write (create dir) file exists\n"; # TEST ok(scalar(-s $file), 'File has non-zero size.'); unlink $file; rmdir 't/newdir'; # - test denied (no create dir) $file = 't/deny.xml'; $doc = $parser->parse_string("$file"); eval { $results = $stylesheet->transform($doc); }; print "# local write (no create dir) denied\n"; { my $E = $@; # TEST like($E, qr/write for \Q$file\E refused/, 'exception matches'); } # TEST ok(scalar(! -e $file), 'File does not exist.'); # - test denied (create dir) $file = 't/baddir/allow.xml'; $doc = $parser->parse_string("$file"); eval { $results = $stylesheet->transform($doc); }; print "# local write (create dir) denied\n"; { my $E = $@; # TEST like($E, qr/creation for \Q$file\E refused/, 'creation for file refused'); } # TEST ok(scalar(!-e $file), 'File does nto exist - create dir.'); # test net read # --------------------------------------------------------------------------- # - test allowed $doc = $parser->parse_string('http://localhost/allow.xml'); $results = $stylesheet->transform($doc); print "# net read results\n"; # TEST ok($results, ' TODO : Add test name'); $output = $stylesheet->output_string($results); #warn "output: $output\n"; print "# net read output\n"; # TEST like($output, qr/foo: Text here/, 'Output matches.'); # - test denied $doc = $parser->parse_string('http://localhost/deny.xml'); eval { $results = $stylesheet->transform($doc); }; print "# net read denied\n"; { my $E = $@; # TEST like($E, qr|read for http://localhost/deny\.xml refused|, 'Exception read for refused.' ); } # test net write # --------------------------------------------------------------------------- # - test allowed { # We reserve a random port to make sure the localhost address is not # valid. See: # # https://rt.cpan.org/Ticket/Display.html?id=52422 # # We need to go to additional lengths to reserve a port due to: # - https://rt.cpan.org/Ticket/Display.html?id=71456 # - http://stackoverflow.com/questions/7704228/perl-how-to-portably-reserve-a-tcp-port-so-there-will-be-a-non-available-url my $listen_sock = IO::Socket::INET->new( Listen => 1, Proto => 'tcp', Blocking => 0, ); my $listen_port = $listen_sock->sockport(); my $conn_sock = IO::Socket::INET->new( PeerAddr => 'localhost', PeerPort => $listen_port, Proto => 'tcp', Blocking => 0, ); my $port = $conn_sock->sockport(); $file = "http://localhost:${port}/allow.xml"; $doc = $parser->parse_string("$file"); eval { $results = $stylesheet->transform($doc); }; print "# net write allowed\n"; { my $E = $@; # TEST like ($E, qr/unable to save to \Q$file\E/, 'unable to save excpetion'); } } # - test denied $file = 'http://localhost/deny.xml'; $doc = $parser->parse_string("$file"); eval { $results = $stylesheet->transform($doc); }; print "# net write denied\n"; { my $E = $@; # TEST like($E, qr/write for \Q$file\E refused/, 'Exception write refused'); } # test a dying security callback (and resetting the callback object through # the stylesheet interface). # --------------------------------------------------------------------------- my $scb2 = XML::LibXSLT::Security->new(); $scb2->register_callback( read_file => \&read_file_die ); $stylesheet->security_callbacks($scb2); # check if transform throws an exception $doc = $parser->parse_string('allow.xml'); print "# dying callback test\n"; eval { $stylesheet->transform($doc); }; { my $E = $@; # TEST like ($E, qr/Test die from security callback/, 'Exception Test die from security callback.'); } # # Security preference callbacks # # TEST:$read_file=1; sub read_file { my ($tctxt, $value) = @_; print "# security read_file: $value\n"; if ($value eq 'allow.xml') { print "# transform context\n"; # TEST*$read_file ok( $tctxt->isa("XML::LibXSLT::TransformContext"), ' TODO : Add test name' ); print "# stylesheet from transform context\n"; # TEST*$read_file ok( $tctxt->stylesheet->isa("XML::LibXSLT::StylesheetWrapper"), ' TODO : Add test name' ); return 1; } else { return 0; } } sub read_file_die { my ($tctxt, $value) = @_; print "# security read_file_die: $value\n"; die "Test die from security callback"; } sub write_file { my ($tctxt, $value) = @_; print "# security write_file: $value\n"; if ($value =~ /allow\.xml|newdir|baddir/) { return 1; } else { return 0; } } sub create_dir { my ($tctxt, $value) = @_; print "# security create_dir: $value\n"; if ($value =~ /newdir/) { return 1; } else { return 0; } } sub read_net { my ($tctxt, $value) = @_; print "# security read_net: $value\n"; if ($value =~ /allow\.xml/) { return 1; } else { return 0; } } sub write_net { my ($tctxt, $value) = @_; print "# security write_net: $value\n"; if ($value =~ /allow\.xml/) { return 1; } else { return 0; } } # # input callback functions (used so we don't have to have an actual file) # sub match_cb { my $uri = shift; print "# input match_cb: $uri\n"; if ($uri =~ /(allow|deny)\.xml/) { return 1; } return 0; } sub open_cb { my $uri = shift; print "# input open_cb: $uri\n"; my $str ="Text here"; return \$str; } sub close_cb { print "# input close_cb\n"; } sub read_cb { print "# input read_cb\n"; return substr(${$_[0]}, 0, $_[1], ""); } XML-LibXSLT-1.95/t/12import.t0000644000076400007640000000142612321505013015323 0ustar shlomifshlomif# -*- cperl -*- use strict; use warnings; use Test::More tests => 6; use vars (qw($loaded)); END { # TEST ok($loaded, 'Everything was properly loaded.'); } use XML::LibXSLT; $loaded = 1; # TEST ok(1, 'Running'); my $x = XML::LibXML->new() ; # TEST ok($x, 'XML::LibXML->new works.') ; my $p = XML::LibXSLT->new(); # TEST ok($p, 'XML::LibXSLT->new owrks.'); my $xsl = < EOF my $xsld = $x->parse_string($xsl) ; # TEST ok($xsld, 'parse_string returned a true value.') ; my $tr = $p->parse_stylesheet($xsld) ; # TEST ok($tr, 'parse_stylesheet returned a true value.') ; XML-LibXSLT-1.95/t/15misc.t0000644000076400007640000000335711651607043014767 0ustar shlomifshlomif# -*- cperl -*- use strict; use warnings; # Should be 4. use Test::More tests => 4; use XML::LibXML 1.70; use XML::LibXSLT; { # test for #41542 - DTD subset disappeare # in the source document after the transformation my $parser = XML::LibXML->new(); $parser->validation(1); $parser->expand_entities(0); my $xml = <<'EOT'; ]>
    &foo;
    EOT my $doc = $parser->parse_string($xml); my $xslt = XML::LibXSLT->new(); $parser->validation(0); my $style_doc = $parser->parse_string(<<'EOX'); hello EOX # TEST is ($doc->toString(), $xml, 'toString() No. 1'); $xslt->parse_stylesheet($style_doc)->transform($doc); # TEST is ($doc->toString(), $xml, 'toString() No. 2'); } { # test work-around for rt #29572 my $parser = XML::LibXML->new(); my $source = $parser->parse_string(<<'EOT'); EOT my $style_doc = $parser->load_xml(string=><<'EOT2',no_cdata=>1); ]]> EOT2 my $xslt = XML::LibXSLT->new(); my $stylesheet = $xslt->parse_stylesheet($style_doc); my $results = $stylesheet->transform($source); # TEST ok($results, ' TODO : Add test name'); my $out = $stylesheet->output_string($results); # TEST is($out, <<'EOF', '$out is equal to '); EOF } XML-LibXSLT-1.95/t/rt71345_b.t0000644000076400007640000000200212321505017015173 0ustar shlomifshlomifuse Test::More tests => 2; # See: # https://rt.cpan.org/Ticket/Display.html?id=71345 { use strict; use warnings; use XML::LibXSLT; use XML::LibXML; my $xslt = XML::LibXSLT->new(); my $ext_uri = "urn:local"; XML::LibXSLT->register_function($ext_uri, "uc", sub { return uc shift; } ); my $stylesheet = $xslt->parse_stylesheet(XML::LibXML->load_xml(string => <<'EOF')); EOF my $input = XML::LibXML->load_xml(string => ""); # TEST like ($stylesheet->transform($input)->toString(), qr{\QFOO\E}, 'transformation works.', ); } # TEST ok(1, 'Did not crash.'); XML-LibXSLT-1.95/typemap0000644000076400007640000000172011647605042014632 0ustar shlomifshlomifTYPEMAP const char * T_PV xmlDocPtr PROXY_OBJECT xsltStylesheetPtr O_OBJECT xsltTransformContextPtr O_OBJECT ProxyObject * O_OBJECT INPUT O_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; } PROXY_OBJECT if( sv_isobject($arg) && (SvTYPE(SvRV($arg)) == SVt_PVMG) ) $var = ($type)(((ProxyObject *)SvIV((SV*)SvRV( $arg )))->object); else{ warn( \"${Package}::$func_name() -- $var is not a blessed SV reference\" ); XSRETURN_UNDEF; } 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, (char *)CLASS, (void*)$var ); PROXY_OBJECT sv_setref_pv( $arg, (char *)CLASS, (void*)$var ); XML-LibXSLT-1.95/scripts/0000755000076400007640000000000012747105600014714 5ustar shlomifshlomifXML-LibXSLT-1.95/scripts/tag-release.pl0000644000076400007640000000065612322173417017451 0ustar shlomifshlomif#!/usr/bin/perl use strict; use warnings; use IO::All; my ($version) = (map { m{\$VERSION *= *'([^']+)'} ? ($1) : () } io->file('LibXSLT.pm')->getlines() ) ; if (!defined ($version)) { die "Version is undefined!"; } my @cmd = ( "hg", "tag", "-m", "Tagging the XML-LibXSLT release as $version", "XML-LibXSLT-$version", ); print join(" ", map { /\s/ ? qq{"$_"} : $_ } @cmd), "\n"; exec(@cmd); XML-LibXSLT-1.95/LibXSLT.xs0000644000076400007640000011411012457141377015031 0ustar shlomifshlomif/* $Id$ */ /* * This is free software, you may use it and distribute it under the same terms as * Perl itself. * * Copyright 2001-2009 AxKit.com Ltd. */ #ifdef __cplusplus extern "C" { #endif #include #include #include #include #include #include #include #include #ifdef HAVE_EXSLT #include #include #endif #include #include #include #include #include #include #include #include "EXTERN.h" #include "perl.h" #include "XSUB.h" #include "perl-libxml-mm.h" #include "ppport.h" #ifdef __cplusplus } #endif #define SET_CB(cb, fld) \ RETVAL = cb ? newSVsv(cb) : &PL_sv_undef;\ if (SvOK(fld)) {\ if (cb) {\ if (cb != fld) {\ sv_setsv(cb, fld);\ }\ }\ else {\ cb = newSVsv(fld);\ }\ }\ else {\ if (cb) {\ SvREFCNT_dec(cb);\ cb = NULL;\ }\ } #define SET_CB2(cb, fld) cb=fld; static SV * LibXSLT_debug_cb = NULL; static HV * LibXSLT_HV_allCallbacks = NULL; SV* x_PROXY_NODE_REGISTRY_MUTEX = NULL; void LibXSLT_free_all_callbacks(void) { if (LibXSLT_debug_cb) { SvREFCNT_dec(LibXSLT_debug_cb); LibXSLT_debug_cb = NULL; } } int LibXSLT_iowrite_scalar(void * context, const char * buffer, int len) { SV * scalar; scalar = (SV *)context; sv_catpvn(scalar, (const char*)buffer, len); return len; } int LibXSLT_ioclose_scalar(void * context) { return 0; } int LibXSLT_iowrite_fh(void * context, const char * buffer, int len) { dSP; SV * ioref; SV * tbuff; SV * results; int cnt; ENTER; SAVETMPS; ioref = (SV *)context; tbuff = newSVpvn((char*)buffer, len); PUSHMARK(SP); EXTEND(SP, 2); PUSHs(ioref); PUSHs(sv_2mortal(tbuff)); PUTBACK; cnt = call_method("print", G_SCALAR | G_EVAL); SPAGAIN; if (cnt != 1) { croak("fh->print() method call failed"); } results = POPs; if (!SvOK(results)) { croak("print to fh failed"); } PUTBACK; FREETMPS; LEAVE; return len; } int LibXSLT_ioclose_fh(void * context) { return 0; /* we let Perl close the FH */ } void LibXSLT_error_handler_ctx(void * ctxt, const char * msg, ...) { va_list args; SV * saved_error = (SV *) ctxt; /* If saved_error is null we croak with the error */ if( saved_error == NULL ) { SV * sv = sv_2mortal(newSV(0)); va_start(args, msg); sv_vsetpvfn(sv, msg, strlen(msg), &args, NULL, 0, NULL); va_end(args); croak("%s", SvPV_nolen(sv)); /* Otherwise, save the error */ } else { va_start(args, msg); sv_vcatpvfn(saved_error, msg, strlen(msg), &args, NULL, 0, NULL); va_end(args); } } static void LibXSLT_init_error_ctx(SV * saved_error) { xmlSetGenericErrorFunc((void *) saved_error, (xmlGenericErrorFunc) LibXSLT_error_handler_ctx); xsltSetGenericErrorFunc((void *) saved_error, (xmlGenericErrorFunc) LibXSLT_error_handler_ctx); } static void LibXSLT_report_error_ctx(SV * saved_error, int warn_only) { if( 0 < SvCUR( saved_error ) ) { if ( warn_only ) { warn("%s", SvPV_nolen(saved_error)); } else { croak("%s", SvPV_nolen(saved_error)); } } } void LibXSLT_debug_handler(void * ctxt, const char * msg, ...) { dSP; va_list args; SV * sv; sv = NEWSV(0,512); va_start(args, msg); sv_vsetpvfn(sv, msg, strlen(msg), &args, NULL, 0, NULL); va_end(args); if (LibXSLT_debug_cb && SvTRUE(LibXSLT_debug_cb)) { int cnt = 0; ENTER; SAVETMPS; PUSHMARK(SP); EXTEND(SP, 1); PUSHs(sv); PUTBACK; cnt = call_sv(LibXSLT_debug_cb, G_SCALAR | G_EVAL); SPAGAIN; if (cnt != 1) { croak("debug handler call failed"); } PUTBACK; FREETMPS; LEAVE; } SvREFCNT_dec(sv); } static void LibXSLT__function (xmlXPathParserContextPtr ctxt, int nargs, SV *perl_function) { SV * owner_doc; xmlXPathObjectPtr obj,ret; xmlNodeSetPtr nodelist = NULL; int count; SV * perl_dispatch; int i; STRLEN len; SV * perl_result; char * tmp_string; STRLEN n_a; double tmp_double; int tmp_int; AV * array_result; xmlNodePtr tmp_node, tmp_node1, tmp_node2 = NULL; xmlDocPtr container = NULL; xsltTransformContextPtr tctxt = xsltXPathGetTransformContext(ctxt); dSP; ENTER; SAVETMPS; PUSHMARK(SP); XPUSHs(perl_function); /* clone all of the arguments into a new owning document */ owner_doc = x_PmmNodeToSv(INT2PTR(xmlNodePtr,xmlNewDoc(NULL)), NULL); XPUSHs( sv_2mortal(owner_doc) ); /* set up call to perl dispatcher function */ for (i = 0; i < nargs; i++) { obj = (xmlXPathObjectPtr)valuePop(ctxt); switch (obj->type) { case XPATH_NODESET: case XPATH_XSLT_TREE: nodelist = obj->nodesetval; if ( nodelist == NULL ) break; XPUSHs(sv_2mortal(newSVpv("XML::LibXML::NodeList", 0))); XPUSHs(sv_2mortal(newSViv(nodelist->nodeNr))); if ( nodelist->nodeNr == 0 ) break; { const char * cls = "XML::LibXML::Node"; xmlNodePtr tnode = NULL; SV * element = NULL; int i; for(i=0; i < nodelist->nodeNr; i++ ){ tnode = nodelist->nodeTab[i]; /* need to copy the node as libxml2 will free it */ if (tnode->type == XML_NAMESPACE_DECL) { element = sv_newmortal(); cls = x_PmmNodeTypeName( tnode ); element = sv_setref_pv( element, (const char *)cls, (void *)xmlCopyNamespace((xmlNsPtr)tnode) ); } else { xmlNodePtr tnode_cpy = xmlDocCopyNode(tnode,INT2PTR(xmlDocPtr,x_PmmNODE(SvPROXYNODE(owner_doc))),1); if( tnode_cpy == NULL ) break; element = x_PmmNodeToSv(tnode_cpy,SvPROXYNODE(owner_doc)); } XPUSHs( sv_2mortal(element) ); } } break; case XPATH_BOOLEAN: XPUSHs(sv_2mortal(newSVpv("XML::LibXML::Boolean", 0))); XPUSHs(sv_2mortal(newSViv(obj->boolval))); break; case XPATH_NUMBER: XPUSHs(sv_2mortal(newSVpv("XML::LibXML::Number", 0))); XPUSHs(sv_2mortal(newSVnv(obj->floatval))); break; case XPATH_STRING: XPUSHs(sv_2mortal(newSVpv("XML::LibXML::Literal", 0))); XPUSHs(sv_2mortal(newSVpv((char*)obj->stringval, 0))); break; default: /* warn("Unknown XPath return type (%d) in call to {%s}%s - assuming string", obj->type, uri, function); */ XPUSHs(sv_2mortal(newSVpv("XML::LibXML::Literal", 0))); XPUSHs(sv_2mortal(newSVpv((char*)xmlXPathCastToString(obj), 0))); } xmlXPathFreeObject(obj); } /* call perl dispatcher */ PUTBACK; perl_dispatch = sv_2mortal(newSVpv("XML::LibXSLT::perl_dispatcher",0)); count = call_sv(perl_dispatch, G_SCALAR|G_EVAL); SPAGAIN; if (SvTRUE(ERRSV)) { (void) POPs; croak("LibXSLT: error coming back from perl-dispatcher in pm file. %s\n", SvPV(ERRSV, n_a)); } if (count != 1) croak("LibXSLT: perl-dispatcher in pm file returned more than one argument!\n"); perl_result = POPs; if (!SvOK(perl_result)) { ret = (xmlXPathObjectPtr)xmlXPathNewCString(""); goto FINISH; } /* convert perl result structures to LibXML structures */ if (sv_isobject(perl_result) && (SvTYPE(SvRV(perl_result)) == SVt_PVMG || SvTYPE(SvRV(perl_result)) == SVt_PVAV)) { if (sv_derived_from(perl_result, "XML::LibXML::NodeList")) { if (tctxt == NULL) { croak("LibXSLT: perl-dispatcher: internal error tctxt == NULL\n"); } ret = xmlXPathNewNodeSet(NULL); ret->boolval = 0; array_result = (AV*)SvRV(perl_result); while (av_len(array_result) >= 0) { tmp_node1 = (xmlNodePtr)x_PmmSvNode(sv_2mortal(av_shift(array_result))); if (tmp_node1) { container = xsltCreateRVT(tctxt); if (container == NULL) { croak("LibXSLT: perl-dispatcher: cannot create container RVT\n"); } #if LIBXSLT_VERSION < 10118 xsltRegisterTmpRVT(tctxt,container); #else xsltRegisterLocalRVT(tctxt,container); #endif tmp_node = xmlDocCopyNode(tmp_node1, container, 1); /* a wraper element is needed to wrap attributes and prevent libxml2 from merging adjacent text nodes */ tmp_node2 = xmlNewDocNode(container,NULL,(xmlChar*) "x",NULL); xmlAddChild((xmlNodePtr)container,tmp_node2); xmlAddChild(tmp_node2,tmp_node); xmlXPathNodeSetAdd(ret->nodesetval, tmp_node); } else { croak("LibXSLT: perl-dispatcher returned nodelist with non-node elements\n"); } } /* * Mark it as a function result in order to avoid garbage * collecting of tree fragments. */ xsltExtensionInstructionResultRegister(tctxt, ret); goto FINISH; } else if (sv_derived_from(perl_result, "XML::LibXML::Node")) { tmp_node1 = (xmlNodePtr)x_PmmSvNode(perl_result); ret = (xmlXPathObjectPtr)xmlXPathNewNodeSet(NULL); ret->boolval = 0; if (tmp_node1) { if (tctxt == NULL) { croak("LibXSLT: perl-dispatcher: internal error tctxt == NULL\n"); } container = xsltCreateRVT(tctxt); if (container == NULL) { croak("LibXSLT: perl-dispatcher: cannot create container RVT\n"); } #if LIBXSLT_VERSION < 10118 xsltRegisterTmpRVT(tctxt,container); #else xsltRegisterLocalRVT(tctxt,container); #endif tmp_node = xmlDocCopyNode(tmp_node1, container, 1); if (tmp_node == NULL) { croak("LibXSLT: perl-dispatcher: cannot copy node for RVT\n"); } if (tmp_node->type != XML_ELEMENT_NODE) { /* create a wrapper element */ tmp_node2 = xmlNewDocNode(container,NULL,(xmlChar*) "x",NULL); xmlAddChild((xmlNodePtr)container,tmp_node2); xmlAddChild(tmp_node2,tmp_node); } else { xmlAddChild((xmlNodePtr)container,tmp_node); } xmlXPathNodeSetAdd(ret->nodesetval,tmp_node); } else { croak("LibXSLT: perl-dispatcher returned a null XML::LibXML::Node object\n"); } /* * Mark it as a function result in order to avoid garbage * collecting of tree fragments. */ xsltExtensionInstructionResultRegister(tctxt, ret); goto FINISH; } else if (sv_derived_from(perl_result, "XML::LibXML::Boolean")) { tmp_int = SvIV(SvRV(perl_result)); ret = (xmlXPathObjectPtr)xmlXPathNewBoolean(tmp_int); goto FINISH; } else if (sv_derived_from(perl_result, "XML::LibXML::Literal")) { tmp_string = SvPV(SvRV(perl_result), len); ret = (xmlXPathObjectPtr)xmlXPathNewCString(tmp_string); goto FINISH; } else if (sv_derived_from(perl_result, "XML::LibXML::Number")) { tmp_double = SvNV(SvRV(perl_result)); ret = (xmlXPathObjectPtr)xmlXPathNewFloat(tmp_double); goto FINISH; } } ret = (xmlXPathObjectPtr)xmlXPathNewCString(SvPV(perl_result, len)); FINISH: valuePush(ctxt, ret); PUTBACK; FREETMPS; LEAVE; } /* * LibXSLT_generic_function * * Callback for global functions * */ static void LibXSLT_generic_function (xmlXPathParserContextPtr ctxt, int nargs) { const char *uri, *name; SV *key; char *strkey; STRLEN len; SV **perl_function; uri = (const char *) ctxt->context->functionURI; name = (const char *) ctxt->context->function; key = newSVpvn("",0); sv_catpv(key, "{"); sv_catpv(key, (const char*)uri); sv_catpv(key, "}"); sv_catpv(key, (const char*)name); strkey = SvPV(key, len); perl_function = hv_fetch(LibXSLT_HV_allCallbacks, strkey, len, 0); SvREFCNT_dec(key); LibXSLT__function (ctxt, nargs, *perl_function); } /* * LibXSLT_context_function * * Callback for context-specific (=stylesheet specific) functions. The * functions themselves are stored in the StylesheetWrapper object which is * retrieved via the xsltTransformContext _private bit * */ static void LibXSLT_context_function (xmlXPathParserContextPtr ctxt, int nargs) { const char *uri, *name; SV *key; char *strkey; STRLEN len; SV *wrapper; HV *functions; SV **ptr; SV **perl_function; AV *val; xsltTransformContextPtr tctxt = xsltXPathGetTransformContext(ctxt); wrapper = (SV *) tctxt->_private; key = newSVpvn("XML_LIBXSLT_FUNCTIONS", 21); strkey = SvPV(key, len); ptr = hv_fetch((HV *) SvRV(wrapper), strkey, len, 0); functions = (HV *) SvRV(*ptr); uri = (const char *) ctxt->context->functionURI; name = (const char *) ctxt->context->function; sv_setpv(key, "{"); sv_catpv(key, (const char*)uri); sv_catpv(key, "}"); sv_catpv(key, (const char*)name); strkey = SvPV(key, len); val = (AV *) SvRV(*hv_fetch(functions, strkey, len, 0)); perl_function = av_fetch(val, 2, 0); SvREFCNT_dec(key); LibXSLT__function (ctxt, nargs, *perl_function); } static void LibXSLT_context_element(xsltTransformContextPtr ctxt, xmlNodePtr node, xmlNodePtr inst, xsltElemPreCompPtr comp) { SV *key, *wrapper, **ptr, **perl_function, *perlnode; HV *elements; AV *val; char *strkey; STRLEN len; HE *ent; int count; xmlNodePtr result; dSP; wrapper = (SV *) ctxt->_private; key = newSVpvn("", 0); sv_setpv(key, "XML_LIBXSLT_ELEMENTS"); strkey = SvPV(key, len); ptr = hv_fetch((HV *) SvRV(wrapper), strkey, len, 0); elements = (HV *) SvRV(*ptr); sv_setpv(key, "{"); sv_catpv(key, (const char*)inst->ns->href); sv_catpv(key, "}"); sv_catpv(key, (const char*)inst->name); strkey = SvPV(key, len); ptr = hv_fetch(elements, strkey, len, 0); val = (AV *) SvRV(*ptr); perl_function = av_fetch(val, 2, 0); SvREFCNT_dec(key); ENTER; SAVETMPS; PUSHMARK(SP); EXTEND(SP, 3); PUSHs(sv_setref_pv(sv_newmortal(), "XML::LibXSLT::TransformContext", (void*)ctxt)); // node and node->doc are the document being transformed PUSHs(sv_2mortal(x_PmmNodeToSv(node, PmmPROXYNODE(node->doc)))); // inst is the stylesheet's private copy of the stylesheet document if (PmmPROXYNODE(inst->doc) == NULL) { inst->doc->_private = x_PmmNewNode(INT2PTR(xmlNodePtr,inst->doc)); // add a private reference which is cleaned up when the stylesheet // is destroyed x_PmmREFCNT_inc(PmmPROXYNODE(inst->doc)); } PUSHs(sv_2mortal(x_PmmNodeToSv(inst, PmmPROXYNODE(inst->doc)))); PUTBACK; count = call_sv(*perl_function, G_SCALAR); SPAGAIN; if (count != 1) croak("LibXSLT: element callback did not return anything"); perlnode = POPs; if (perlnode != &PL_sv_undef) { result = x_PmmSvNodeExt(perlnode, 0); if (result == NULL) croak("LibXSLT: element callback did not return a XML::Node"); x_PmmREFCNT_inc(PmmPROXYNODE(result)); xmlAddChild(ctxt->insert, result); } FREETMPS; LEAVE; } int LibXSLT_security_check(xsltSecurityOption option, xsltSecurityPrefsPtr sec, xsltTransformContextPtr ctxt, const char * value) { int result = 0; { int count; dTHX; dSP; ENTER; SAVETMPS; PUSHMARK(SP); EXTEND(SP, 3); PUSHs(sv_2mortal(newSViv(option))); PUSHs(sv_setref_pv(sv_newmortal(), "XML::LibXSLT::TransformContext", (void*)ctxt)); PUSHs(sv_2mortal(newSVpv((char*)value, 0))); PUTBACK; count = call_pv("XML::LibXSLT::Security::_security_check", G_SCALAR | G_EVAL); SPAGAIN; if (count != 1) { croak("security callbacks must return a single value"); } if (SvTRUE(ERRSV)) { (void) POPs; croak("security callback died: %s", SvPV_nolen(ERRSV)); } result = POPi; PUTBACK; FREETMPS; LEAVE; } return result; } int LibXSLT_security_read_file(xsltSecurityPrefsPtr sec, xsltTransformContextPtr ctxt, const char * value) { return LibXSLT_security_check(XSLT_SECPREF_READ_FILE, sec, ctxt, value); } int LibXSLT_security_write_file(xsltSecurityPrefsPtr sec, xsltTransformContextPtr ctxt, const char * value) { return LibXSLT_security_check(XSLT_SECPREF_WRITE_FILE, sec, ctxt, value); } int LibXSLT_security_create_dir(xsltSecurityPrefsPtr sec, xsltTransformContextPtr ctxt, const char * value) { return LibXSLT_security_check(XSLT_SECPREF_CREATE_DIRECTORY, sec, ctxt, value); } int LibXSLT_security_read_net(xsltSecurityPrefsPtr sec, xsltTransformContextPtr ctxt, const char * value) { return LibXSLT_security_check(XSLT_SECPREF_READ_NETWORK, sec, ctxt, value); } int LibXSLT_security_write_net(xsltSecurityPrefsPtr sec, xsltTransformContextPtr ctxt, const char * value) { return LibXSLT_security_check(XSLT_SECPREF_WRITE_NETWORK, sec, ctxt, value); } xsltSecurityPrefsPtr LibXSLT_init_security_prefs(xsltTransformContextPtr ctxt) { xsltSecurityPrefsPtr sec = NULL; sec = xsltNewSecurityPrefs(); xsltSetSecurityPrefs(sec, XSLT_SECPREF_READ_FILE, LibXSLT_security_read_file); xsltSetSecurityPrefs(sec, XSLT_SECPREF_WRITE_FILE, LibXSLT_security_write_file); xsltSetSecurityPrefs(sec, XSLT_SECPREF_CREATE_DIRECTORY, LibXSLT_security_create_dir); xsltSetSecurityPrefs(sec, XSLT_SECPREF_READ_NETWORK, LibXSLT_security_read_net); xsltSetSecurityPrefs(sec, XSLT_SECPREF_WRITE_NETWORK, LibXSLT_security_write_net); xsltSetCtxtSecurityPrefs(sec, ctxt); return sec; } void LibXSLT_free_security_prefs(xsltSecurityPrefsPtr sec, xsltTransformContextPtr ctxt) { xsltFreeSecurityPrefs(sec); } /* * LibXSLT_init_functions * * Add functions registered in $stylesheet->register_function() to the new * stylesheet context. This iterates over a hash ref keyed on the uri/name of * the functions and adds them to the new context that is used to perform the * transform. The value of the hash is [uri, name, callback] (saves us the * trouble of parsing the key). This is called by transform(). * */ void LibXSLT_init_functions(xsltTransformContextPtr ctxt, SV *wrapper) { SV **ptr; HV *functions; HE *key; AV *val; char *uri, *name; const char strkey[] = "XML_LIBXSLT_FUNCTIONS"; ptr = hv_fetch((HV *) SvRV(wrapper), strkey, strlen(strkey), 0); /* make sure the user hasn't screwed up our StylesheetWrapper object */ if (ptr == NULL) croak("XML_LIBXSLT_FUNCTIONS is undef in StylesheetWrapper"); if (SvTYPE(SvRV(*ptr)) != SVt_PVHV) croak("XML_LIBXSLT_FUNCTIONS is not a HASHREF in StylesheetWrapper"); functions = (HV *) SvRV(*ptr); hv_iterinit(functions); while ((key = hv_iternext(functions))) { val = (AV *) SvRV(HeVAL(key)); /* [uri, name, callback] */ uri = SvPV_nolen (*av_fetch (val, 0, 0)); name = SvPV_nolen (*av_fetch (val, 1, 0)); xsltRegisterExtFunction (ctxt, (const xmlChar *)name, (const xmlChar *)uri, LibXSLT_context_function ); } } void LibXSLT_init_elements(xsltTransformContextPtr ctxt, SV *wrapper) { SV **ptr; HV *functions; HE *key; AV *val; char *uri, *name; const char strkey[] = "XML_LIBXSLT_ELEMENTS"; ptr = hv_fetch((HV *) SvRV(wrapper), strkey, strlen(strkey), 0); /* make sure the user hasn't screwed up our StylesheetWrapper object */ if (ptr == NULL) croak("XML_LIBXSLT_ELEMENTS is undef in StylesheetWrapper"); if (SvTYPE(SvRV(*ptr)) != SVt_PVHV) croak("XML_LIBXSLT_ELEMENTS is not a HASHREF in StylesheetWrapper"); functions = (HV *) SvRV(*ptr); hv_iterinit(functions); while ((key = hv_iternext(functions))) { val = (AV *) SvRV(HeVAL(key)); /* [uri, name, callback] */ uri = SvPV_nolen (*av_fetch (val, 0, 0)); name = SvPV_nolen (*av_fetch (val, 1, 0)); xsltRegisterExtElement (ctxt, (const xmlChar *)name, (const xmlChar *)uri, LibXSLT_context_element ); } } MODULE = XML::LibXSLT PACKAGE = XML::LibXSLT PROTOTYPES: DISABLE BOOT: LIBXML_TEST_VERSION if (xsltLibxsltVersion < LIBXSLT_VERSION) { warn("Warning: XML::LibXSLT compiled against libxslt %d, " "but runtime libxslt is older %d\n", LIBXSLT_VERSION, xsltLibxsltVersion); } xsltInit(); xsltMaxDepth = 250; xsltSetXIncludeDefault(1); LibXSLT_HV_allCallbacks = newHV(); #ifdef HAVE_EXSLT exsltRegisterAll(); #endif void END() CODE: xsltCleanupGlobals(); int HAVE_EXSLT() CODE: #ifdef HAVE_EXSLT RETVAL = 1; #else RETVAL = 0; #endif OUTPUT: RETVAL char * LIBXSLT_DOTTED_VERSION() CODE: RETVAL = LIBXSLT_DOTTED_VERSION; OUTPUT: RETVAL int LIBXSLT_VERSION() CODE: RETVAL = LIBXSLT_VERSION; OUTPUT: RETVAL int LIBXSLT_RUNTIME_VERSION() CODE: RETVAL = xsltLibxsltVersion; OUTPUT: RETVAL int xinclude_default(self, ...) SV * self CODE: PERL_UNUSED_VAR(self); RETVAL = xsltGetXIncludeDefault(); if (items > 1) { xsltSetXIncludeDefault(SvIV(ST(1))); } OUTPUT: RETVAL int max_depth(self, ...) SV * self CODE: PERL_UNUSED_VAR(self); RETVAL = xsltMaxDepth; if (items > 1) { IV val; val = SvIV(ST(1)); if (val > 0) { xsltMaxDepth = val; } } OUTPUT: RETVAL int max_vars(self, ...) SV * self CODE: PERL_UNUSED_VAR(self); #if LIBXSLT_VERSION < 10127 RETVAL = 1; #else RETVAL = xsltMaxVars; if (items > 1) { IV val; val = SvIV(ST(1)); if (val > 0) { xsltMaxVars = val; } } #endif OUTPUT: RETVAL void register_function(self, uri, name, callback) SV * self char * uri char * name SV *callback PPCODE: { SV *key; STRLEN len; char *strkey; PERL_UNUSED_VAR(self); /* todo: Add checking of uri and name in here! */ xsltRegisterExtModuleFunction((const xmlChar *)name, (const xmlChar *)uri, LibXSLT_generic_function); key = newSVpvn("",0); sv_catpv(key, "{"); sv_catpv(key, (const char*)uri); sv_catpv(key, "}"); sv_catpv(key, (const char*)name); strkey = SvPV(key, len); /* warn("Trying to store function '%s' in %d\n", strkey, LibXSLT_HV_allCallbacks); */ (void) hv_store(LibXSLT_HV_allCallbacks, strkey, len, SvREFCNT_inc(callback), 0); SvREFCNT_dec(key); } SV * debug_callback(self, ...) SV * self CODE: PERL_UNUSED_VAR(self); if (items > 1) { SV * debug_cb = ST(1); if (debug_cb && SvTRUE(debug_cb)) { SET_CB(LibXSLT_debug_cb, debug_cb); } else { LibXSLT_debug_cb = NULL; } } RETVAL = LibXSLT_debug_cb ? LibXSLT_debug_cb : &PL_sv_undef; OUTPUT: RETVAL xsltStylesheetPtr _parse_stylesheet(self, sv_doc) SV * self SV * sv_doc PREINIT: char * CLASS = "XML::LibXSLT::Stylesheet"; xmlDocPtr doc_copy; xmlDocPtr doc; SV * saved_error = sv_2mortal(newSVpv("",0)); CODE: PERL_UNUSED_VAR(self); if (sv_doc == NULL) { XSRETURN_UNDEF; } doc = (xmlDocPtr)x_PmmSvNode( sv_doc ); if (doc == NULL) { XSRETURN_UNDEF; } doc_copy = xmlCopyDoc(doc, 1); if (doc_copy->URL == NULL) { doc_copy->URL = xmlStrdup(doc->URL); } /* xmlNodeSetBase((xmlNodePtr)doc_copy, doc_copy->URL); */ if (LibXSLT_debug_cb && SvTRUE(LibXSLT_debug_cb)) { xsltSetGenericDebugFunc(PerlIO_stderr(), (xmlGenericErrorFunc)LibXSLT_debug_handler); } else { xsltSetGenericDebugFunc(NULL, NULL); } LibXSLT_init_error_ctx(saved_error); RETVAL = xsltParseStylesheetDoc(doc_copy); if (RETVAL == NULL) { xmlFreeDoc(doc_copy); LibXSLT_report_error_ctx(saved_error,0); XSRETURN_UNDEF; } LibXSLT_report_error_ctx(saved_error,1); OUTPUT: RETVAL xsltStylesheetPtr _parse_stylesheet_file(self, filename) SV * self const char * filename PREINIT: char * CLASS = "XML::LibXSLT::Stylesheet"; SV * saved_error = sv_2mortal(newSVpv("",0)); CODE: PERL_UNUSED_VAR(self); if (LibXSLT_debug_cb && SvTRUE(LibXSLT_debug_cb)) { xsltSetGenericDebugFunc(PerlIO_stderr(), (xmlGenericErrorFunc)LibXSLT_debug_handler); } else { xsltSetGenericDebugFunc(NULL, NULL); } LibXSLT_init_error_ctx(saved_error); RETVAL = xsltParseStylesheetFile((const xmlChar *)filename); if (RETVAL == NULL) { LibXSLT_report_error_ctx(saved_error,0); XSRETURN_UNDEF; } LibXSLT_report_error_ctx(saved_error,1); OUTPUT: RETVAL void INIT_THREAD_SUPPORT() CODE: if (x_PROXY_NODE_REGISTRY_MUTEX != NULL) { croak("XML::LibXSLT::INIT_THREAD_SUPPORT can only be called once!\n"); } x_PROXY_NODE_REGISTRY_MUTEX = get_sv("XML::LibXML::__PROXY_NODE_REGISTRY_MUTEX",0); MODULE = XML::LibXSLT PACKAGE = XML::LibXSLT::Stylesheet PROTOTYPES: DISABLE SV * transform(self, wrapper, sv_doc, ...) xsltStylesheetPtr self SV * wrapper SV * sv_doc PREINIT: const char *xslt_params[255]; /* note really only 254 entries here - last one is NULL */ xmlDocPtr real_dom; xmlDocPtr doc; xmlNodePtr dtd_prev = NULL; xmlNodePtr dtd_next = NULL; SV * saved_error = sv_2mortal(newSVpv("",0)); xsltTransformContextPtr ctxt; xsltSecurityPrefsPtr sec; CODE: if (sv_doc == NULL) { XSRETURN_UNDEF; } doc = (xmlDocPtr)x_PmmSvNode( sv_doc ); if (doc == NULL) { XSRETURN_UNDEF; } xslt_params[0] = 0; if (items > 256) { croak("Too many parameters in transform()"); } if ((items - 3) % 2) { croak("Odd number of parameters"); } if (items > 3) { int i; for (i = 3; (i < items && i < 256); i++) { xslt_params[i - 3] = (char *)SvPV(ST(i), PL_na); } # set last entry to NULL xslt_params[i - 3] = 0; } if (LibXSLT_debug_cb && SvTRUE(LibXSLT_debug_cb)) { xsltSetGenericDebugFunc(PerlIO_stderr(), (xmlGenericErrorFunc)LibXSLT_debug_handler); } else { xsltSetGenericDebugFunc(NULL, NULL); } LibXSLT_init_error_ctx(saved_error); /* we need own context to distinguish * * from those with terminate="yes" and fatal errors */ ctxt = xsltNewTransformContext(self, doc); if (ctxt == NULL) { croak("Could not create transformation context"); } ctxt->xinclude = 1; ctxt->_private = (void *) wrapper; sec = LibXSLT_init_security_prefs(ctxt); LibXSLT_init_functions(ctxt, wrapper); LibXSLT_init_elements(ctxt, wrapper); if (doc->intSubset != NULL) { /* Note: libxslt will unlink intSubset, we want to restore it when done */ dtd_prev = doc->intSubset->prev; dtd_next = doc->intSubset->next; } real_dom = xsltApplyStylesheetUser(self, doc, xslt_params, NULL, NULL, ctxt); if (doc->intSubset != NULL && doc->prev == NULL && doc->next == NULL) { xmlNodePtr cur = (xmlNodePtr) doc->intSubset; cur->prev = dtd_prev; cur->next = dtd_next; if (dtd_prev) dtd_prev->next = cur; if (dtd_next) dtd_next->prev = cur; if (doc->children == dtd_next) doc->children = cur; if (doc->last == dtd_prev) doc->last = cur; } if ((real_dom != NULL) && (ctxt->state != XSLT_STATE_OK)) { /* fatal error */ xmlFreeDoc(real_dom); real_dom = NULL; } LibXSLT_free_security_prefs(sec, ctxt); xsltFreeTransformContext(ctxt); /* real_dom = xsltApplyStylesheet(self, doc, xslt_params); */ if (real_dom == NULL) { if ( real_dom != NULL ) xmlFreeDoc( real_dom ); LibXSLT_report_error_ctx(saved_error,0); croak("Unknown error applying stylesheet"); } if (real_dom->type == XML_HTML_DOCUMENT_NODE) { if (self->method != NULL) { xmlFree(self->method); } self->method = (xmlChar *) xmlMalloc(5); strcpy((char *) self->method, "html"); } /* non-fatal: probably just a message from the stylesheet */ LibXSLT_report_error_ctx(saved_error,1); RETVAL = x_PmmNodeToSv((xmlNodePtr)real_dom, NULL); OUTPUT: RETVAL SV * transform_file(self, wrapper, filename, ...) xsltStylesheetPtr self SV * wrapper char * filename PREINIT: # note really only 254 entries here - last one is NULL const char *xslt_params[255]; xmlDocPtr real_dom; xmlDocPtr source_dom; SV * saved_error = sv_2mortal(newSVpv("",0)); xsltTransformContextPtr ctxt; xsltSecurityPrefsPtr sec; CODE: xslt_params[0] = 0; if (items > 256) { croak("Too many parameters in transform()"); } if ((items - 3) % 2) { croak("Odd number of parameters"); } if (items > 3) { int i; for (i = 3; (i < items && i < 256); i++) { xslt_params[i - 3] = (char *)SvPV(ST(i), PL_na); } # set last entry to NULL xslt_params[i - 3] = 0; } if (LibXSLT_debug_cb && SvTRUE(LibXSLT_debug_cb)) { xsltSetGenericDebugFunc(PerlIO_stderr(), (xmlGenericErrorFunc)LibXSLT_debug_handler); } else { xsltSetGenericDebugFunc(NULL, NULL); } LibXSLT_init_error_ctx(saved_error); source_dom = xmlParseFile(filename); if ( source_dom == NULL ) { LibXSLT_report_error_ctx(saved_error,0); croak("Unknown error loading source document"); } else { /*real_dom = xsltApplyStylesheet(self, source_dom, xslt_params);*/ ctxt = xsltNewTransformContext(self, source_dom); if (ctxt == NULL) { croak("Could not create transformation context"); } ctxt->xinclude = 1; ctxt->_private = (void *) wrapper; sec = LibXSLT_init_security_prefs(ctxt); LibXSLT_init_functions(ctxt, wrapper); LibXSLT_init_elements(ctxt, wrapper); real_dom = xsltApplyStylesheetUser(self, source_dom, xslt_params, NULL, NULL, ctxt); if ((ctxt->state != XSLT_STATE_OK) && real_dom) { /* fatal error */ xmlFreeDoc(real_dom); real_dom = NULL; } LibXSLT_free_security_prefs(sec, ctxt); xsltFreeTransformContext(ctxt); xmlFreeDoc( source_dom ); } if (real_dom == NULL) { LibXSLT_report_error_ctx(saved_error,0); croak("Unknown error applying stylesheet"); } /* non-fatal: probably just a message from the stylesheet */ LibXSLT_report_error_ctx(saved_error,1); if (real_dom->type == XML_HTML_DOCUMENT_NODE) { if (self->method != NULL) { xmlFree(self->method); } self->method = xmlStrdup((const xmlChar *) "html"); } RETVAL = x_PmmNodeToSv((xmlNodePtr)real_dom, NULL); OUTPUT: RETVAL void DESTROY(self) xsltStylesheetPtr self CODE: if (self == NULL) { XSRETURN_UNDEF; } if (PmmPROXYNODE(self->doc)) { if (x_PmmREFCNT(PmmPROXYNODE(self->doc)) > 1) warn("LibXSLT: reference to stylesheet document outside of stylesheet scope"); // perhaps croak() ? else xmlFree(PmmPROXYNODE(self->doc)); } xsltFreeStylesheet(self); SV * _output_string(self, sv_doc, bytes_vs_chars=0) xsltStylesheetPtr self SV * sv_doc int bytes_vs_chars PREINIT: xmlOutputBufferPtr output; SV * results = newSVpv("", 0); const xmlChar *encoding = NULL; xmlCharEncodingHandlerPtr encoder = NULL; xmlDocPtr doc = (xmlDocPtr)x_PmmSvNode( sv_doc ); CODE: XSLT_GET_IMPORT_PTR(encoding, self, encoding) if (encoding != NULL) { encoder = xmlFindCharEncodingHandler((char *)encoding); if ((encoder != NULL) && (xmlStrEqual((const xmlChar *)encoder->name, (const xmlChar *) "UTF-8"))) encoder = NULL; } if (LibXSLT_debug_cb && SvTRUE(LibXSLT_debug_cb)) { xsltSetGenericDebugFunc(PerlIO_stderr(), (xmlGenericErrorFunc)LibXSLT_debug_handler); } else { xsltSetGenericDebugFunc(NULL, NULL); } output = xmlOutputBufferCreateIO( (xmlOutputWriteCallback) LibXSLT_iowrite_scalar, (xmlOutputCloseCallback) LibXSLT_ioclose_scalar, (void*)results, (bytes_vs_chars == 2) ? NULL : encoder ); if (xsltSaveResultTo(output, doc, self) == -1) { croak("output to scalar failed"); } xmlOutputBufferClose(output); if ((bytes_vs_chars == 2) || ((bytes_vs_chars == 0) && xmlStrEqual(encoding, (const xmlChar *) "UTF-8"))) { SvUTF8_on( results ); } RETVAL = results; OUTPUT: RETVAL void output_fh(self, sv_doc, fh) xsltStylesheetPtr self SV * sv_doc SV * fh PREINIT: xmlOutputBufferPtr output; const xmlChar *encoding = NULL; xmlCharEncodingHandlerPtr encoder = NULL; xmlDocPtr doc = (xmlDocPtr)x_PmmSvNode( sv_doc ); CODE: XSLT_GET_IMPORT_PTR(encoding, self, encoding) if (encoding != NULL) { encoder = xmlFindCharEncodingHandler((char *)encoding); if ((encoder != NULL) && (xmlStrEqual((const xmlChar *)encoder->name, (const xmlChar *) "UTF-8"))) encoder = NULL; } if (LibXSLT_debug_cb && SvTRUE(LibXSLT_debug_cb)) { xsltSetGenericDebugFunc(PerlIO_stderr(), (xmlGenericErrorFunc)LibXSLT_debug_handler); } else { xsltSetGenericDebugFunc(NULL, NULL); } output = xmlOutputBufferCreateIO( (xmlOutputWriteCallback) LibXSLT_iowrite_fh, (xmlOutputCloseCallback) LibXSLT_ioclose_fh, (void*)fh, encoder ); if (xsltSaveResultTo(output, doc, self) == -1) { croak("output to fh failed"); } xmlOutputBufferClose(output); void output_file(self, sv_doc, filename) xsltStylesheetPtr self SV * sv_doc char * filename PREINIT: xmlDocPtr doc = (xmlDocPtr)x_PmmSvNode( sv_doc ); CODE: if (LibXSLT_debug_cb && SvTRUE(LibXSLT_debug_cb)) { xsltSetGenericDebugFunc(PerlIO_stderr(), (xmlGenericErrorFunc)LibXSLT_debug_handler); } else { xsltSetGenericDebugFunc(NULL, NULL); } xsltSaveResultToFilename(filename, doc, self, 0); char * media_type(self) xsltStylesheetPtr self PREINIT: xmlChar *mediaType; xmlChar *method; CODE: XSLT_GET_IMPORT_PTR(mediaType, self, mediaType); if(mediaType == NULL) { XSLT_GET_IMPORT_PTR(method, self, method); RETVAL = "text/xml"; /* this below is rather simplistic, but should work for most cases */ if (method != NULL) { if (xmlStrcmp(method, (xmlChar*) "html") == 0) { RETVAL = "text/html"; } else if (xmlStrcmp(method, (xmlChar*) "text") == 0) { RETVAL = "text/plain"; } } } else { RETVAL = (char*) mediaType; } OUTPUT: RETVAL char * output_method(self) xsltStylesheetPtr self PREINIT: xmlChar *method; CODE: XSLT_GET_IMPORT_PTR(method, self, method) RETVAL = (char*) method; if (RETVAL == NULL) { /* read http://www.w3.org/TR/xslt#output and tell me how you'd implement this the way it says to. */ RETVAL = "xml"; } OUTPUT: RETVAL char * output_encoding(self) xsltStylesheetPtr self PREINIT: xmlChar *encoding; CODE: XSLT_GET_IMPORT_PTR(encoding, self, encoding) RETVAL = (char*) encoding; if (RETVAL == NULL) { RETVAL = "UTF-8"; } OUTPUT: RETVAL MODULE = XML::LibXSLT PACKAGE = XML::LibXSLT::TransformContext SV * stylesheet(self) xsltTransformContextPtr self CODE: RETVAL = SvREFCNT_inc((SV *) self->_private); OUTPUT: RETVAL XML-LibXSLT-1.95/ppport.h0000644000076400007640000045651411647605042014744 0ustar shlomifshlomif#if 0 <<'SKIP'; #endif /* ---------------------------------------------------------------------- ppport.h -- Perl/Pollution/Portability Version 3.13 Automatically created by Devel::PPPort running under perl 5.010000. Do NOT edit this file directly! -- Edit PPPort_pm.PL and the includes in parts/inc/ instead. Use 'perldoc ppport.h' to view the documentation below. ---------------------------------------------------------------------- SKIP =pod =head1 NAME ppport.h - Perl/Pollution/Portability version 3.13 =head1 SYNOPSIS perl ppport.h [options] [source files] Searches current directory for files if no [source files] are given --help show short help --version show version --patch=file write one patch file with changes --copy=suffix write changed copies with suffix --diff=program use diff program and options --compat-version=version provide compatibility with Perl version --cplusplus accept C++ comments --quiet don't output anything except fatal errors --nodiag don't show diagnostics --nohints don't show hints --nochanges don't suggest changes --nofilter don't filter input files --strip strip all script and doc functionality from ppport.h --list-provided list provided API --list-unsupported list unsupported API --api-info=name show Perl API portability information =head1 COMPATIBILITY This version of F is designed to support operation with Perl installations back to 5.003, and has been tested up to 5.10.0. =head1 OPTIONS =head2 --help Display a brief usage summary. =head2 --version Display the version of F. =head2 --patch=I If this option is given, a single patch file will be created if any changes are suggested. This requires a working diff program to be installed on your system. =head2 --copy=I If this option is given, a copy of each file will be saved with the given suffix that contains the suggested changes. This does not require any external programs. Note that this does not automagially add a dot between the original filename and the suffix. If you want the dot, you have to include it in the option argument. If neither C<--patch> or C<--copy> are given, the default is to simply print the diffs for each file. This requires either C or a C program to be installed. =head2 --diff=I Manually set the diff program and options to use. The default is to use C, when installed, and output unified context diffs. =head2 --compat-version=I Tell F to check for compatibility with the given Perl version. The default is to check for compatibility with Perl version 5.003. You can use this option to reduce the output of F if you intend to be backward compatible only down to a certain Perl version. =head2 --cplusplus Usually, F will detect C++ style comments and replace them with C style comments for portability reasons. Using this option instructs F to leave C++ comments untouched. =head2 --quiet Be quiet. Don't print anything except fatal errors. =head2 --nodiag Don't output any diagnostic messages. Only portability alerts will be printed. =head2 --nohints Don't output any hints. Hints often contain useful portability notes. Warnings will still be displayed. =head2 --nochanges Don't suggest any changes. Only give diagnostic output and hints unless these are also deactivated. =head2 --nofilter Don't filter the list of input files. By default, files not looking like source code (i.e. not *.xs, *.c, *.cc, *.cpp or *.h) are skipped. =head2 --strip Strip all script and documentation functionality from F. This reduces the size of F dramatically and may be useful if you want to include F in smaller modules without increasing their distribution size too much. The stripped F will have a C<--unstrip> option that allows you to undo the stripping, but only if an appropriate C module is installed. =head2 --list-provided Lists the API elements for which compatibility is provided by F. Also lists if it must be explicitly requested, if it has dependencies, and if there are hints or warnings for it. =head2 --list-unsupported Lists the API elements that are known not to be supported by F and below which version of Perl they probably won't be available or work. =head2 --api-info=I Show portability information for API elements matching I. If I is surrounded by slashes, it is interpreted as a regular expression. =head1 DESCRIPTION In order for a Perl extension (XS) module to be as portable as possible across differing versions of Perl itself, certain steps need to be taken. =over 4 =item * Including this header is the first major one. This alone will give you access to a large part of the Perl API that hasn't been available in earlier Perl releases. Use perl ppport.h --list-provided to see which API elements are provided by ppport.h. =item * You should avoid using deprecated parts of the API. For example, using global Perl variables without the C prefix is deprecated. Also, some API functions used to have a C prefix. Using this form is also deprecated. You can safely use the supported API, as F will provide wrappers for older Perl versions. =item * If you use one of a few functions or variables that were not present in earlier versions of Perl, and that can't be provided using a macro, you have to explicitly request support for these functions by adding one or more C<#define>s in your source code before the inclusion of F. These functions or variables will be marked C in the list shown by C<--list-provided>. Depending on whether you module has a single or multiple files that use such functions or variables, you want either C or global variants. For a C function or variable (used only in a single source file), use: #define NEED_function #define NEED_variable For a global function or variable (used in multiple source files), use: #define NEED_function_GLOBAL #define NEED_variable_GLOBAL Note that you mustn't have more than one global request for the same function or variable in your project. Function / Variable Static Request Global Request ----------------------------------------------------------------------------------------- PL_signals NEED_PL_signals NEED_PL_signals_GLOBAL eval_pv() NEED_eval_pv NEED_eval_pv_GLOBAL grok_bin() NEED_grok_bin NEED_grok_bin_GLOBAL grok_hex() NEED_grok_hex NEED_grok_hex_GLOBAL grok_number() NEED_grok_number NEED_grok_number_GLOBAL grok_numeric_radix() NEED_grok_numeric_radix NEED_grok_numeric_radix_GLOBAL grok_oct() NEED_grok_oct NEED_grok_oct_GLOBAL load_module() NEED_load_module NEED_load_module_GLOBAL my_snprintf() NEED_my_snprintf NEED_my_snprintf_GLOBAL my_strlcat() NEED_my_strlcat NEED_my_strlcat_GLOBAL my_strlcpy() NEED_my_strlcpy NEED_my_strlcpy_GLOBAL newCONSTSUB() NEED_newCONSTSUB NEED_newCONSTSUB_GLOBAL newRV_noinc() NEED_newRV_noinc NEED_newRV_noinc_GLOBAL newSVpvn_share() NEED_newSVpvn_share NEED_newSVpvn_share_GLOBAL sv_2pv_flags() NEED_sv_2pv_flags NEED_sv_2pv_flags_GLOBAL sv_2pvbyte() NEED_sv_2pvbyte NEED_sv_2pvbyte_GLOBAL sv_catpvf_mg() NEED_sv_catpvf_mg NEED_sv_catpvf_mg_GLOBAL sv_catpvf_mg_nocontext() NEED_sv_catpvf_mg_nocontext NEED_sv_catpvf_mg_nocontext_GLOBAL sv_pvn_force_flags() NEED_sv_pvn_force_flags NEED_sv_pvn_force_flags_GLOBAL sv_setpvf_mg() NEED_sv_setpvf_mg NEED_sv_setpvf_mg_GLOBAL sv_setpvf_mg_nocontext() NEED_sv_setpvf_mg_nocontext NEED_sv_setpvf_mg_nocontext_GLOBAL vload_module() NEED_vload_module NEED_vload_module_GLOBAL vnewSVpvf() NEED_vnewSVpvf NEED_vnewSVpvf_GLOBAL warner() NEED_warner NEED_warner_GLOBAL To avoid namespace conflicts, you can change the namespace of the explicitly exported functions / variables using the C macro. Just C<#define> the macro before including C: #define DPPP_NAMESPACE MyOwnNamespace_ #include "ppport.h" The default namespace is C. =back The good thing is that most of the above can be checked by running F on your source code. See the next section for details. =head1 EXAMPLES To verify whether F is needed for your module, whether you should make any changes to your code, and whether any special defines should be used, F can be run as a Perl script to check your source code. Simply say: perl ppport.h The result will usually be a list of patches suggesting changes that should at least be acceptable, if not necessarily the most efficient solution, or a fix for all possible problems. If you know that your XS module uses features only available in newer Perl releases, if you're aware that it uses C++ comments, and if you want all suggestions as a single patch file, you could use something like this: perl ppport.h --compat-version=5.6.0 --cplusplus --patch=test.diff If you only want your code to be scanned without any suggestions for changes, use: perl ppport.h --nochanges You can specify a different C program or options, using the C<--diff> option: perl ppport.h --diff='diff -C 10' This would output context diffs with 10 lines of context. If you want to create patched copies of your files instead, use: perl ppport.h --copy=.new To display portability information for the C function, use: perl ppport.h --api-info=newSVpvn Since the argument to C<--api-info> can be a regular expression, you can use perl ppport.h --api-info=/_nomg$/ to display portability information for all C<_nomg> functions or perl ppport.h --api-info=/./ to display information for all known API elements. =head1 BUGS If this version of F is causing failure during the compilation of this module, please check if newer versions of either this module or C are available on CPAN before sending a bug report. If F was generated using the latest version of C and is causing failure of this module, please file a bug report using the CPAN Request Tracker at L. Please include the following information: =over 4 =item 1. The complete output from running "perl -V" =item 2. This file. =item 3. The name and version of the module you were trying to build. =item 4. A full log of the build that failed. =item 5. Any other information that you think could be relevant. =back For the latest version of this code, please get the C module from CPAN. =head1 COPYRIGHT Version 3.x, Copyright (c) 2004-2007, Marcus Holland-Moritz. Version 2.x, Copyright (C) 2001, Paul Marquess. Version 1.x, Copyright (C) 1999, Kenneth Albanowski. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. =head1 SEE ALSO See L. =cut use strict; # Disable broken TRIE-optimization BEGIN { eval '${^RE_TRIE_MAXBUF} = -1' if $] >= 5.009004 && $] <= 5.009005 } my $VERSION = 3.13; my %opt = ( quiet => 0, diag => 1, hints => 1, changes => 1, cplusplus => 0, filter => 1, strip => 0, version => 0, ); my($ppport) = $0 =~ /([\w.]+)$/; my $LF = '(?:\r\n|[\r\n])'; # line feed my $HS = "[ \t]"; # horizontal whitespace # Never use C comments in this file! my $ccs = '/'.'*'; my $cce = '*'.'/'; my $rccs = quotemeta $ccs; my $rcce = quotemeta $cce; eval { require Getopt::Long; Getopt::Long::GetOptions(\%opt, qw( help quiet diag! filter! hints! changes! cplusplus strip version patch=s copy=s diff=s compat-version=s list-provided list-unsupported api-info=s )) or usage(); }; if ($@ and grep /^-/, @ARGV) { usage() if "@ARGV" =~ /^--?h(?:elp)?$/; die "Getopt::Long not found. Please don't use any options.\n"; } if ($opt{version}) { print "This is $0 $VERSION.\n"; exit 0; } usage() if $opt{help}; strip() if $opt{strip}; if (exists $opt{'compat-version'}) { my($r,$v,$s) = eval { parse_version($opt{'compat-version'}) }; if ($@) { die "Invalid version number format: '$opt{'compat-version'}'\n"; } die "Only Perl 5 is supported\n" if $r != 5; die "Invalid version number: $opt{'compat-version'}\n" if $v >= 1000 || $s >= 1000; $opt{'compat-version'} = sprintf "%d.%03d%03d", $r, $v, $s; } else { $opt{'compat-version'} = 5; } my %API = map { /^(\w+)\|([^|]*)\|([^|]*)\|(\w*)$/ ? ( $1 => { ($2 ? ( base => $2 ) : ()), ($3 ? ( todo => $3 ) : ()), (index($4, 'v') >= 0 ? ( varargs => 1 ) : ()), (index($4, 'p') >= 0 ? ( provided => 1 ) : ()), (index($4, 'n') >= 0 ? ( nothxarg => 1 ) : ()), } ) : die "invalid spec: $_" } qw( AvFILLp|5.004050||p AvFILL||| CLASS|||n CX_CURPAD_SAVE||| CX_CURPAD_SV||| CopFILEAV|5.006000||p CopFILEGV_set|5.006000||p CopFILEGV|5.006000||p CopFILESV|5.006000||p CopFILE_set|5.006000||p CopFILE|5.006000||p CopSTASHPV_set|5.006000||p CopSTASHPV|5.006000||p CopSTASH_eq|5.006000||p CopSTASH_set|5.006000||p CopSTASH|5.006000||p CopyD|5.009002||p Copy||| CvPADLIST||| CvSTASH||| CvWEAKOUTSIDE||| DEFSV|5.004050||p END_EXTERN_C|5.005000||p ENTER||| ERRSV|5.004050||p EXTEND||| EXTERN_C|5.005000||p F0convert|||n FREETMPS||| GIMME_V||5.004000|n GIMME|||n GROK_NUMERIC_RADIX|5.007002||p G_ARRAY||| G_DISCARD||| G_EVAL||| G_NOARGS||| G_SCALAR||| G_VOID||5.004000| GetVars||| GvSV||| Gv_AMupdate||| HEf_SVKEY||5.004000| HeHASH||5.004000| HeKEY||5.004000| HeKLEN||5.004000| HePV||5.004000| HeSVKEY_force||5.004000| HeSVKEY_set||5.004000| HeSVKEY||5.004000| HeVAL||5.004000| HvNAME||| INT2PTR|5.006000||p IN_LOCALE_COMPILETIME|5.007002||p IN_LOCALE_RUNTIME|5.007002||p IN_LOCALE|5.007002||p IN_PERL_COMPILETIME|5.008001||p IS_NUMBER_GREATER_THAN_UV_MAX|5.007002||p IS_NUMBER_INFINITY|5.007002||p IS_NUMBER_IN_UV|5.007002||p IS_NUMBER_NAN|5.007003||p IS_NUMBER_NEG|5.007002||p IS_NUMBER_NOT_INT|5.007002||p IVSIZE|5.006000||p IVTYPE|5.006000||p IVdf|5.006000||p LEAVE||| LVRET||| MARK||| MULTICALL||5.009005| MY_CXT_CLONE|5.009002||p MY_CXT_INIT|5.007003||p MY_CXT|5.007003||p MoveD|5.009002||p Move||| NOOP|5.005000||p NUM2PTR|5.006000||p NVTYPE|5.006000||p NVef|5.006001||p NVff|5.006001||p NVgf|5.006001||p Newxc|5.009003||p Newxz|5.009003||p Newx|5.009003||p Nullav||| Nullch||| Nullcv||| Nullhv||| Nullsv||| ORIGMARK||| PAD_BASE_SV||| PAD_CLONE_VARS||| PAD_COMPNAME_FLAGS||| PAD_COMPNAME_GEN_set||| PAD_COMPNAME_GEN||| PAD_COMPNAME_OURSTASH||| PAD_COMPNAME_PV||| PAD_COMPNAME_TYPE||| PAD_RESTORE_LOCAL||| PAD_SAVE_LOCAL||| PAD_SAVE_SETNULLPAD||| PAD_SETSV||| PAD_SET_CUR_NOSAVE||| PAD_SET_CUR||| PAD_SVl||| PAD_SV||| PERL_ABS|5.008001||p PERL_BCDVERSION|5.009005||p PERL_GCC_BRACE_GROUPS_FORBIDDEN|5.008001||p PERL_HASH|5.004000||p PERL_INT_MAX|5.004000||p PERL_INT_MIN|5.004000||p PERL_LONG_MAX|5.004000||p PERL_LONG_MIN|5.004000||p PERL_MAGIC_arylen|5.007002||p PERL_MAGIC_backref|5.007002||p PERL_MAGIC_bm|5.007002||p PERL_MAGIC_collxfrm|5.007002||p PERL_MAGIC_dbfile|5.007002||p PERL_MAGIC_dbline|5.007002||p PERL_MAGIC_defelem|5.007002||p PERL_MAGIC_envelem|5.007002||p PERL_MAGIC_env|5.007002||p PERL_MAGIC_ext|5.007002||p PERL_MAGIC_fm|5.007002||p PERL_MAGIC_glob|5.009005||p PERL_MAGIC_isaelem|5.007002||p PERL_MAGIC_isa|5.007002||p PERL_MAGIC_mutex|5.009005||p PERL_MAGIC_nkeys|5.007002||p PERL_MAGIC_overload_elem|5.007002||p PERL_MAGIC_overload_table|5.007002||p PERL_MAGIC_overload|5.007002||p PERL_MAGIC_pos|5.007002||p PERL_MAGIC_qr|5.007002||p PERL_MAGIC_regdata|5.007002||p PERL_MAGIC_regdatum|5.007002||p PERL_MAGIC_regex_global|5.007002||p PERL_MAGIC_shared_scalar|5.007003||p PERL_MAGIC_shared|5.007003||p PERL_MAGIC_sigelem|5.007002||p PERL_MAGIC_sig|5.007002||p PERL_MAGIC_substr|5.007002||p PERL_MAGIC_sv|5.007002||p PERL_MAGIC_taint|5.007002||p PERL_MAGIC_tiedelem|5.007002||p PERL_MAGIC_tiedscalar|5.007002||p PERL_MAGIC_tied|5.007002||p PERL_MAGIC_utf8|5.008001||p PERL_MAGIC_uvar_elem|5.007003||p PERL_MAGIC_uvar|5.007002||p PERL_MAGIC_vec|5.007002||p PERL_MAGIC_vstring|5.008001||p PERL_QUAD_MAX|5.004000||p PERL_QUAD_MIN|5.004000||p PERL_REVISION|5.006000||p PERL_SCAN_ALLOW_UNDERSCORES|5.007003||p PERL_SCAN_DISALLOW_PREFIX|5.007003||p PERL_SCAN_GREATER_THAN_UV_MAX|5.007003||p PERL_SCAN_SILENT_ILLDIGIT|5.008001||p PERL_SHORT_MAX|5.004000||p PERL_SHORT_MIN|5.004000||p PERL_SIGNALS_UNSAFE_FLAG|5.008001||p PERL_SUBVERSION|5.006000||p PERL_UCHAR_MAX|5.004000||p PERL_UCHAR_MIN|5.004000||p PERL_UINT_MAX|5.004000||p PERL_UINT_MIN|5.004000||p PERL_ULONG_MAX|5.004000||p PERL_ULONG_MIN|5.004000||p PERL_UNUSED_ARG|5.009003||p PERL_UNUSED_CONTEXT|5.009004||p PERL_UNUSED_DECL|5.007002||p PERL_UNUSED_VAR|5.007002||p PERL_UQUAD_MAX|5.004000||p PERL_UQUAD_MIN|5.004000||p PERL_USE_GCC_BRACE_GROUPS|5.009004||p PERL_USHORT_MAX|5.004000||p PERL_USHORT_MIN|5.004000||p PERL_VERSION|5.006000||p PL_DBsignal|5.005000||p PL_DBsingle|||pn PL_DBsub|||pn PL_DBtrace|||pn PL_Sv|5.005000||p PL_compiling|5.004050||p PL_copline|5.009005||p PL_curcop|5.004050||p PL_curstash|5.004050||p PL_debstash|5.004050||p PL_defgv|5.004050||p PL_diehook|5.004050||p PL_dirty|5.004050||p PL_dowarn|||pn PL_errgv|5.004050||p PL_expect|5.009005||p PL_hexdigit|5.005000||p PL_hints|5.005000||p PL_last_in_gv|||n PL_laststatval|5.005000||p PL_modglobal||5.005000|n PL_na|5.004050||pn PL_no_modify|5.006000||p PL_ofs_sv|||n PL_perl_destruct_level|5.004050||p PL_perldb|5.004050||p PL_ppaddr|5.006000||p PL_rsfp_filters|5.004050||p PL_rsfp|5.004050||p PL_rs|||n PL_signals|5.008001||p PL_stack_base|5.004050||p PL_stack_sp|5.004050||p PL_statcache|5.005000||p PL_stdingv|5.004050||p PL_sv_arenaroot|5.004050||p PL_sv_no|5.004050||pn PL_sv_undef|5.004050||pn PL_sv_yes|5.004050||pn PL_tainted|5.004050||p PL_tainting|5.004050||p POP_MULTICALL||5.009005| POPi|||n POPl|||n POPn|||n POPpbytex||5.007001|n POPpx||5.005030|n POPp|||n POPs|||n PTR2IV|5.006000||p PTR2NV|5.006000||p PTR2UV|5.006000||p PTR2ul|5.007001||p PTRV|5.006000||p PUSHMARK||| PUSH_MULTICALL||5.009005| PUSHi||| PUSHmortal|5.009002||p PUSHn||| PUSHp||| PUSHs||| PUSHu|5.004000||p PUTBACK||| PerlIO_clearerr||5.007003| PerlIO_close||5.007003| PerlIO_context_layers||5.009004| PerlIO_eof||5.007003| PerlIO_error||5.007003| PerlIO_fileno||5.007003| PerlIO_fill||5.007003| PerlIO_flush||5.007003| PerlIO_get_base||5.007003| PerlIO_get_bufsiz||5.007003| PerlIO_get_cnt||5.007003| PerlIO_get_ptr||5.007003| PerlIO_read||5.007003| PerlIO_seek||5.007003| PerlIO_set_cnt||5.007003| PerlIO_set_ptrcnt||5.007003| PerlIO_setlinebuf||5.007003| PerlIO_stderr||5.007003| PerlIO_stdin||5.007003| PerlIO_stdout||5.007003| PerlIO_tell||5.007003| PerlIO_unread||5.007003| PerlIO_write||5.007003| Perl_signbit||5.009005|n PoisonFree|5.009004||p PoisonNew|5.009004||p PoisonWith|5.009004||p Poison|5.008000||p RETVAL|||n Renewc||| Renew||| SAVECLEARSV||| SAVECOMPPAD||| SAVEPADSV||| SAVETMPS||| SAVE_DEFSV|5.004050||p SPAGAIN||| SP||| START_EXTERN_C|5.005000||p START_MY_CXT|5.007003||p STMT_END|||p STMT_START|||p STR_WITH_LEN|5.009003||p ST||| SV_CONST_RETURN|5.009003||p SV_COW_DROP_PV|5.008001||p SV_COW_SHARED_HASH_KEYS|5.009005||p SV_GMAGIC|5.007002||p SV_HAS_TRAILING_NUL|5.009004||p SV_IMMEDIATE_UNREF|5.007001||p SV_MUTABLE_RETURN|5.009003||p SV_NOSTEAL|5.009002||p SV_SMAGIC|5.009003||p SV_UTF8_NO_ENCODING|5.008001||p SVf|5.006000||p SVt_IV||| SVt_NV||| SVt_PVAV||| SVt_PVCV||| SVt_PVHV||| SVt_PVMG||| SVt_PV||| Safefree||| Slab_Alloc||| Slab_Free||| Slab_to_rw||| StructCopy||| SvCUR_set||| SvCUR||| SvEND||| SvGAMAGIC||5.006001| SvGETMAGIC|5.004050||p SvGROW||| SvIOK_UV||5.006000| SvIOK_notUV||5.006000| SvIOK_off||| SvIOK_only_UV||5.006000| SvIOK_only||| SvIOK_on||| SvIOKp||| SvIOK||| SvIVX||| SvIV_nomg|5.009001||p SvIV_set||| SvIVx||| SvIV||| SvIsCOW_shared_hash||5.008003| SvIsCOW||5.008003| SvLEN_set||| SvLEN||| SvLOCK||5.007003| SvMAGIC_set|5.009003||p SvNIOK_off||| SvNIOKp||| SvNIOK||| SvNOK_off||| SvNOK_only||| SvNOK_on||| SvNOKp||| SvNOK||| SvNVX||| SvNV_set||| SvNVx||| SvNV||| SvOK||| SvOOK||| SvPOK_off||| SvPOK_only_UTF8||5.006000| SvPOK_only||| SvPOK_on||| SvPOKp||| SvPOK||| SvPVX_const|5.009003||p SvPVX_mutable|5.009003||p SvPVX||| SvPV_const|5.009003||p SvPV_flags_const_nolen|5.009003||p SvPV_flags_const|5.009003||p SvPV_flags_mutable|5.009003||p SvPV_flags|5.007002||p SvPV_force_flags_mutable|5.009003||p SvPV_force_flags_nolen|5.009003||p SvPV_force_flags|5.007002||p SvPV_force_mutable|5.009003||p SvPV_force_nolen|5.009003||p SvPV_force_nomg_nolen|5.009003||p SvPV_force_nomg|5.007002||p SvPV_force|||p SvPV_mutable|5.009003||p SvPV_nolen_const|5.009003||p SvPV_nolen|5.006000||p SvPV_nomg_const_nolen|5.009003||p SvPV_nomg_const|5.009003||p SvPV_nomg|5.007002||p SvPV_set||| SvPVbyte_force||5.009002| SvPVbyte_nolen||5.006000| SvPVbytex_force||5.006000| SvPVbytex||5.006000| SvPVbyte|5.006000||p SvPVutf8_force||5.006000| SvPVutf8_nolen||5.006000| SvPVutf8x_force||5.006000| SvPVutf8x||5.006000| SvPVutf8||5.006000| SvPVx||| SvPV||| SvREFCNT_dec||| SvREFCNT_inc_NN|5.009004||p SvREFCNT_inc_simple_NN|5.009004||p SvREFCNT_inc_simple_void_NN|5.009004||p SvREFCNT_inc_simple_void|5.009004||p SvREFCNT_inc_simple|5.009004||p SvREFCNT_inc_void_NN|5.009004||p SvREFCNT_inc_void|5.009004||p SvREFCNT_inc|||p SvREFCNT||| SvROK_off||| SvROK_on||| SvROK||| SvRV_set|5.009003||p SvRV||| SvRXOK||5.009005| SvRX||5.009005| SvSETMAGIC||| SvSHARED_HASH|5.009003||p SvSHARE||5.007003| SvSTASH_set|5.009003||p SvSTASH||| SvSetMagicSV_nosteal||5.004000| SvSetMagicSV||5.004000| SvSetSV_nosteal||5.004000| SvSetSV||| SvTAINTED_off||5.004000| SvTAINTED_on||5.004000| SvTAINTED||5.004000| SvTAINT||| SvTRUE||| SvTYPE||| SvUNLOCK||5.007003| SvUOK|5.007001|5.006000|p SvUPGRADE||| SvUTF8_off||5.006000| SvUTF8_on||5.006000| SvUTF8||5.006000| SvUVXx|5.004000||p SvUVX|5.004000||p SvUV_nomg|5.009001||p SvUV_set|5.009003||p SvUVx|5.004000||p SvUV|5.004000||p SvVOK||5.008001| SvVSTRING_mg|5.009004||p THIS|||n UNDERBAR|5.009002||p UTF8_MAXBYTES|5.009002||p UVSIZE|5.006000||p UVTYPE|5.006000||p UVXf|5.007001||p UVof|5.006000||p UVuf|5.006000||p UVxf|5.006000||p WARN_ALL|5.006000||p WARN_AMBIGUOUS|5.006000||p WARN_ASSERTIONS|5.009005||p WARN_BAREWORD|5.006000||p WARN_CLOSED|5.006000||p WARN_CLOSURE|5.006000||p WARN_DEBUGGING|5.006000||p WARN_DEPRECATED|5.006000||p WARN_DIGIT|5.006000||p WARN_EXEC|5.006000||p WARN_EXITING|5.006000||p WARN_GLOB|5.006000||p WARN_INPLACE|5.006000||p WARN_INTERNAL|5.006000||p WARN_IO|5.006000||p WARN_LAYER|5.008000||p WARN_MALLOC|5.006000||p WARN_MISC|5.006000||p WARN_NEWLINE|5.006000||p WARN_NUMERIC|5.006000||p WARN_ONCE|5.006000||p WARN_OVERFLOW|5.006000||p WARN_PACK|5.006000||p WARN_PARENTHESIS|5.006000||p WARN_PIPE|5.006000||p WARN_PORTABLE|5.006000||p WARN_PRECEDENCE|5.006000||p WARN_PRINTF|5.006000||p WARN_PROTOTYPE|5.006000||p WARN_QW|5.006000||p WARN_RECURSION|5.006000||p WARN_REDEFINE|5.006000||p WARN_REGEXP|5.006000||p WARN_RESERVED|5.006000||p WARN_SEMICOLON|5.006000||p WARN_SEVERE|5.006000||p WARN_SIGNAL|5.006000||p WARN_SUBSTR|5.006000||p WARN_SYNTAX|5.006000||p WARN_TAINT|5.006000||p WARN_THREADS|5.008000||p WARN_UNINITIALIZED|5.006000||p WARN_UNOPENED|5.006000||p WARN_UNPACK|5.006000||p WARN_UNTIE|5.006000||p WARN_UTF8|5.006000||p WARN_VOID|5.006000||p XCPT_CATCH|5.009002||p XCPT_RETHROW|5.009002||p XCPT_TRY_END|5.009002||p XCPT_TRY_START|5.009002||p XPUSHi||| XPUSHmortal|5.009002||p XPUSHn||| XPUSHp||| XPUSHs||| XPUSHu|5.004000||p XSRETURN_EMPTY||| XSRETURN_IV||| XSRETURN_NO||| XSRETURN_NV||| XSRETURN_PV||| XSRETURN_UNDEF||| XSRETURN_UV|5.008001||p XSRETURN_YES||| XSRETURN|||p XST_mIV||| XST_mNO||| XST_mNV||| XST_mPV||| XST_mUNDEF||| XST_mUV|5.008001||p XST_mYES||| XS_VERSION_BOOTCHECK||| XS_VERSION||| XSprePUSH|5.006000||p XS||| ZeroD|5.009002||p Zero||| _aMY_CXT|5.007003||p _pMY_CXT|5.007003||p aMY_CXT_|5.007003||p aMY_CXT|5.007003||p aTHXR_|5.009005||p aTHXR|5.009005||p aTHX_|5.006000||p aTHX|5.006000||p add_data|||n addmad||| allocmy||| amagic_call||| amagic_cmp_locale||| amagic_cmp||| amagic_i_ncmp||| amagic_ncmp||| any_dup||| ao||| append_elem||| append_list||| append_madprops||| apply_attrs_my||| apply_attrs_string||5.006001| apply_attrs||| apply||| atfork_lock||5.007003|n atfork_unlock||5.007003|n av_arylen_p||5.009003| av_clear||| av_create_and_push||5.009005| av_create_and_unshift_one||5.009005| av_delete||5.006000| av_exists||5.006000| av_extend||| av_fake||| av_fetch||| av_fill||| av_len||| av_make||| av_pop||| av_push||| av_reify||| av_shift||| av_store||| av_undef||| av_unshift||| ax|||n bad_type||| bind_match||| block_end||| block_gimme||5.004000| block_start||| boolSV|5.004000||p boot_core_PerlIO||| boot_core_UNIVERSAL||| boot_core_mro||| boot_core_xsutils||| bytes_from_utf8||5.007001| bytes_to_uni|||n bytes_to_utf8||5.006001| call_argv|5.006000||p call_atexit||5.006000| call_list||5.004000| call_method|5.006000||p call_pv|5.006000||p call_sv|5.006000||p calloc||5.007002|n cando||| cast_i32||5.006000| cast_iv||5.006000| cast_ulong||5.006000| cast_uv||5.006000| check_type_and_open||| check_uni||| checkcomma||| checkposixcc||| ckWARN|5.006000||p ck_anoncode||| ck_bitop||| ck_concat||| ck_defined||| ck_delete||| ck_die||| ck_eof||| ck_eval||| ck_exec||| ck_exists||| ck_exit||| ck_ftst||| ck_fun||| ck_glob||| ck_grep||| ck_index||| ck_join||| ck_lengthconst||| ck_lfun||| ck_listiob||| ck_match||| ck_method||| ck_null||| ck_open||| ck_readline||| ck_repeat||| ck_require||| ck_retarget||| ck_return||| ck_rfun||| ck_rvconst||| ck_sassign||| ck_select||| ck_shift||| ck_sort||| ck_spair||| ck_split||| ck_subr||| ck_substr||| ck_svconst||| ck_trunc||| ck_unpack||| ckwarn_d||5.009003| ckwarn||5.009003| cl_and|||n cl_anything|||n cl_init_zero|||n cl_init|||n cl_is_anything|||n cl_or|||n clear_placeholders||| closest_cop||| convert||| cop_free||| cr_textfilter||| create_eval_scope||| croak_nocontext|||vn croak|||v csighandler||5.009003|n curmad||| custom_op_desc||5.007003| custom_op_name||5.007003| cv_ckproto_len||| cv_ckproto||| cv_clone||| cv_const_sv||5.004000| cv_dump||| cv_undef||| cx_dump||5.005000| cx_dup||| cxinc||| dAXMARK|5.009003||p dAX|5.007002||p dITEMS|5.007002||p dMARK||| dMULTICALL||5.009003| dMY_CXT_SV|5.007003||p dMY_CXT|5.007003||p dNOOP|5.006000||p dORIGMARK||| dSP||| dTHR|5.004050||p dTHXR|5.009005||p dTHXa|5.006000||p dTHXoa|5.006000||p dTHX|5.006000||p dUNDERBAR|5.009002||p dVAR|5.009003||p dXCPT|5.009002||p dXSARGS||| dXSI32||| dXSTARG|5.006000||p deb_curcv||| deb_nocontext|||vn deb_stack_all||| deb_stack_n||| debop||5.005000| debprofdump||5.005000| debprof||| debstackptrs||5.007003| debstack||5.007003| debug_start_match||| deb||5.007003|v del_sv||| delete_eval_scope||| delimcpy||5.004000| deprecate_old||| deprecate||| despatch_signals||5.007001| destroy_matcher||| die_nocontext|||vn die_where||| die|||v dirp_dup||| div128||| djSP||| do_aexec5||| do_aexec||| do_aspawn||| do_binmode||5.004050| do_chomp||| do_chop||| do_close||| do_dump_pad||| do_eof||| do_exec3||| do_execfree||| do_exec||| do_gv_dump||5.006000| do_gvgv_dump||5.006000| do_hv_dump||5.006000| do_ipcctl||| do_ipcget||| do_join||| do_kv||| do_magic_dump||5.006000| do_msgrcv||| do_msgsnd||| do_oddball||| do_op_dump||5.006000| do_op_xmldump||| do_open9||5.006000| do_openn||5.007001| do_open||5.004000| do_pipe||| do_pmop_dump||5.006000| do_pmop_xmldump||| do_print||| do_readline||| do_seek||| do_semop||| do_shmio||| do_smartmatch||| do_spawn_nowait||| do_spawn||| do_sprintf||| do_sv_dump||5.006000| do_sysseek||| do_tell||| do_trans_complex_utf8||| do_trans_complex||| do_trans_count_utf8||| do_trans_count||| do_trans_simple_utf8||| do_trans_simple||| do_trans||| do_vecget||| do_vecset||| do_vop||| docatch_body||| docatch||| doeval||| dofile||| dofindlabel||| doform||| doing_taint||5.008001|n dooneliner||| doopen_pm||| doparseform||| dopoptoeval||| dopoptogiven||| dopoptolabel||| dopoptoloop||| dopoptosub_at||| dopoptosub||| dopoptowhen||| doref||5.009003| dounwind||| dowantarray||| dump_all||5.006000| dump_eval||5.006000| dump_exec_pos||| dump_fds||| dump_form||5.006000| dump_indent||5.006000|v dump_mstats||| dump_packsubs||5.006000| dump_sub||5.006000| dump_sv_child||| dump_trie_interim_list||| dump_trie_interim_table||| dump_trie||| dump_vindent||5.006000| dumpuntil||| dup_attrlist||| emulate_cop_io||| emulate_eaccess||| eval_pv|5.006000||p eval_sv|5.006000||p exec_failed||| expect_number||| fbm_compile||5.005000| fbm_instr||5.005000| fd_on_nosuid_fs||| feature_is_enabled||| filter_add||| filter_del||| filter_gets||| filter_read||| find_and_forget_pmops||| find_array_subscript||| find_beginning||| find_byclass||| find_hash_subscript||| find_in_my_stash||| find_runcv||5.008001| find_rundefsvoffset||5.009002| find_script||| find_uninit_var||| first_symbol|||n fold_constants||| forbid_setid||| force_ident||| force_list||| force_next||| force_version||| force_word||| forget_pmop||| form_nocontext|||vn form||5.004000|v fp_dup||| fprintf_nocontext|||vn free_global_struct||| free_tied_hv_pool||| free_tmps||| gen_constant_list||| get_arena||| get_av|5.006000||p get_context||5.006000|n get_cvn_flags||5.009005| get_cv|5.006000||p get_db_sub||| get_debug_opts||| get_hash_seed||| get_hv|5.006000||p get_mstats||| get_no_modify||| get_num||| get_op_descs||5.005000| get_op_names||5.005000| get_opargs||| get_ppaddr||5.006000| get_re_arg||| get_sv|5.006000||p get_vtbl||5.005030| getcwd_sv||5.007002| getenv_len||| glob_2number||| glob_2pv||| glob_assign_glob||| glob_assign_ref||| gp_dup||| gp_free||| gp_ref||| grok_bin|5.007003||p grok_hex|5.007003||p grok_number|5.007002||p grok_numeric_radix|5.007002||p grok_oct|5.007003||p group_end||| gv_AVadd||| gv_HVadd||| gv_IOadd||| gv_SVadd||| gv_autoload4||5.004000| gv_check||| gv_const_sv||5.009003| gv_dump||5.006000| gv_efullname3||5.004000| gv_efullname4||5.006001| gv_efullname||| gv_ename||| gv_fetchfile_flags||5.009005| gv_fetchfile||| gv_fetchmeth_autoload||5.007003| gv_fetchmethod_autoload||5.004000| gv_fetchmethod||| gv_fetchmeth||| gv_fetchpvn_flags||5.009002| gv_fetchpv||| gv_fetchsv||5.009002| gv_fullname3||5.004000| gv_fullname4||5.006001| gv_fullname||| gv_handler||5.007001| gv_init_sv||| gv_init||| gv_name_set||5.009004| gv_stashpvn|5.004000||p gv_stashpvs||5.009003| gv_stashpv||| gv_stashsv||| he_dup||| hek_dup||| hfreeentries||| hsplit||| hv_assert||5.009005| hv_auxinit|||n hv_backreferences_p||| hv_clear_placeholders||5.009001| hv_clear||| hv_copy_hints_hv||| hv_delayfree_ent||5.004000| hv_delete_common||| hv_delete_ent||5.004000| hv_delete||| hv_eiter_p||5.009003| hv_eiter_set||5.009003| hv_exists_ent||5.004000| hv_exists||| hv_fetch_common||| hv_fetch_ent||5.004000| hv_fetchs|5.009003||p hv_fetch||| hv_free_ent||5.004000| hv_iterinit||| hv_iterkeysv||5.004000| hv_iterkey||| hv_iternext_flags||5.008000| hv_iternextsv||| hv_iternext||| hv_iterval||| hv_kill_backrefs||| hv_ksplit||5.004000| hv_magic_check|||n hv_magic_uvar_xkey||| hv_magic||| hv_name_set||5.009003| hv_notallowed||| hv_placeholders_get||5.009003| hv_placeholders_p||5.009003| hv_placeholders_set||5.009003| hv_riter_p||5.009003| hv_riter_set||5.009003| hv_scalar||5.009001| hv_store_ent||5.004000| hv_store_flags||5.008000| hv_stores|5.009004||p hv_store||| hv_undef||| ibcmp_locale||5.004000| ibcmp_utf8||5.007003| ibcmp||| incl_perldb||| incline||| incpush_if_exists||| incpush||| ingroup||| init_argv_symbols||| init_debugger||| init_global_struct||| init_i18nl10n||5.006000| init_i18nl14n||5.006000| init_ids||| init_interp||| init_main_stash||| init_perllib||| init_postdump_symbols||| init_predump_symbols||| init_stacks||5.005000| init_tm||5.007002| instr||| intro_my||| intuit_method||| intuit_more||| invert||| io_close||| isALNUM||| isALPHA||| isDIGIT||| isLOWER||| isSPACE||| isUPPER||| is_an_int||| is_gv_magical_sv||| is_gv_magical||| is_handle_constructor|||n is_list_assignment||| is_lvalue_sub||5.007001| is_uni_alnum_lc||5.006000| is_uni_alnumc_lc||5.006000| is_uni_alnumc||5.006000| is_uni_alnum||5.006000| is_uni_alpha_lc||5.006000| is_uni_alpha||5.006000| is_uni_ascii_lc||5.006000| is_uni_ascii||5.006000| is_uni_cntrl_lc||5.006000| is_uni_cntrl||5.006000| is_uni_digit_lc||5.006000| is_uni_digit||5.006000| is_uni_graph_lc||5.006000| is_uni_graph||5.006000| is_uni_idfirst_lc||5.006000| is_uni_idfirst||5.006000| is_uni_lower_lc||5.006000| is_uni_lower||5.006000| is_uni_print_lc||5.006000| is_uni_print||5.006000| is_uni_punct_lc||5.006000| is_uni_punct||5.006000| is_uni_space_lc||5.006000| is_uni_space||5.006000| is_uni_upper_lc||5.006000| is_uni_upper||5.006000| is_uni_xdigit_lc||5.006000| is_uni_xdigit||5.006000| is_utf8_alnumc||5.006000| is_utf8_alnum||5.006000| is_utf8_alpha||5.006000| is_utf8_ascii||5.006000| is_utf8_char_slow|||n is_utf8_char||5.006000| is_utf8_cntrl||5.006000| is_utf8_common||| is_utf8_digit||5.006000| is_utf8_graph||5.006000| is_utf8_idcont||5.008000| is_utf8_idfirst||5.006000| is_utf8_lower||5.006000| is_utf8_mark||5.006000| is_utf8_print||5.006000| is_utf8_punct||5.006000| is_utf8_space||5.006000| is_utf8_string_loclen||5.009003| is_utf8_string_loc||5.008001| is_utf8_string||5.006001| is_utf8_upper||5.006000| is_utf8_xdigit||5.006000| isa_lookup||| items|||n ix|||n jmaybe||| join_exact||| keyword||| leave_scope||| lex_end||| lex_start||| linklist||| listkids||| list||| load_module_nocontext|||vn load_module|5.006000||pv localize||| looks_like_bool||| looks_like_number||| lop||| mPUSHi|5.009002||p mPUSHn|5.009002||p mPUSHp|5.009002||p mPUSHu|5.009002||p mXPUSHi|5.009002||p mXPUSHn|5.009002||p mXPUSHp|5.009002||p mXPUSHu|5.009002||p mad_free||| madlex||| madparse||| magic_clear_all_env||| magic_clearenv||| magic_clearhint||| magic_clearpack||| magic_clearsig||| magic_dump||5.006000| magic_existspack||| magic_freearylen_p||| magic_freeovrld||| magic_freeregexp||| magic_getarylen||| magic_getdefelem||| magic_getnkeys||| magic_getpack||| magic_getpos||| magic_getsig||| magic_getsubstr||| magic_gettaint||| magic_getuvar||| magic_getvec||| magic_get||| magic_killbackrefs||| magic_len||| magic_methcall||| magic_methpack||| magic_nextpack||| magic_regdata_cnt||| magic_regdatum_get||| magic_regdatum_set||| magic_scalarpack||| magic_set_all_env||| magic_setamagic||| magic_setarylen||| magic_setbm||| magic_setcollxfrm||| magic_setdbline||| magic_setdefelem||| magic_setenv||| magic_setfm||| magic_setglob||| magic_sethint||| magic_setisa||| magic_setmglob||| magic_setnkeys||| magic_setpack||| magic_setpos||| magic_setregexp||| magic_setsig||| magic_setsubstr||| magic_settaint||| magic_setutf8||| magic_setuvar||| magic_setvec||| magic_set||| magic_sizepack||| magic_wipepack||| magicname||| make_matcher||| make_trie_failtable||| make_trie||| malloced_size|||n malloc||5.007002|n markstack_grow||| matcher_matches_sv||| measure_struct||| memEQ|5.004000||p memNE|5.004000||p mem_collxfrm||| mess_alloc||| mess_nocontext|||vn mess||5.006000|v method_common||| mfree||5.007002|n mg_clear||| mg_copy||| mg_dup||| mg_find||| mg_free||| mg_get||| mg_length||5.005000| mg_localize||| mg_magical||| mg_set||| mg_size||5.005000| mini_mktime||5.007002| missingterm||| mode_from_discipline||| modkids||| mod||| more_bodies||| more_sv||| moreswitches||| mro_get_linear_isa_c3||5.009005| mro_get_linear_isa_dfs||5.009005| mro_get_linear_isa||5.009005| mro_isa_changed_in||| mro_meta_dup||| mro_meta_init||| mro_method_changed_in||5.009005| mul128||| mulexp10|||n my_atof2||5.007002| my_atof||5.006000| my_attrs||| my_bcopy|||n my_betoh16|||n my_betoh32|||n my_betoh64|||n my_betohi|||n my_betohl|||n my_betohs|||n my_bzero|||n my_chsize||| my_clearenv||| my_cxt_index||| my_cxt_init||| my_dirfd||5.009005| my_exit_jump||| my_exit||| my_failure_exit||5.004000| my_fflush_all||5.006000| my_fork||5.007003|n my_htobe16|||n my_htobe32|||n my_htobe64|||n my_htobei|||n my_htobel|||n my_htobes|||n my_htole16|||n my_htole32|||n my_htole64|||n my_htolei|||n my_htolel|||n my_htoles|||n my_htonl||| my_kid||| my_letoh16|||n my_letoh32|||n my_letoh64|||n my_letohi|||n my_letohl|||n my_letohs|||n my_lstat||| my_memcmp||5.004000|n my_memset|||n my_ntohl||| my_pclose||5.004000| my_popen_list||5.007001| my_popen||5.004000| my_setenv||| my_snprintf|5.009004||pvn my_socketpair||5.007003|n my_sprintf||5.009003|vn my_stat||| my_strftime||5.007002| my_strlcat|5.009004||pn my_strlcpy|5.009004||pn my_swabn|||n my_swap||| my_unexec||| my_vsnprintf||5.009004|n my||| need_utf8|||n newANONATTRSUB||5.006000| newANONHASH||| newANONLIST||| newANONSUB||| newASSIGNOP||| newATTRSUB||5.006000| newAVREF||| newAV||| newBINOP||| newCONDOP||| newCONSTSUB|5.004050||p newCVREF||| newDEFSVOP||| newFORM||| newFOROP||| newGIVENOP||5.009003| newGIVWHENOP||| newGP||| newGVOP||| newGVREF||| newGVgen||| newHVREF||| newHVhv||5.005000| newHV||| newIO||| newLISTOP||| newLOGOP||| newLOOPEX||| newLOOPOP||| newMADPROP||| newMADsv||| newMYSUB||| newNULLLIST||| newOP||| newPADOP||| newPMOP||| newPROG||| newPVOP||| newRANGE||| newRV_inc|5.004000||p newRV_noinc|5.004000||p newRV||| newSLICEOP||| newSTATEOP||| newSUB||| newSVOP||| newSVREF||| newSV_type||5.009005| newSVhek||5.009003| newSViv||| newSVnv||| newSVpvf_nocontext|||vn newSVpvf||5.004000|v newSVpvn_share|5.007001||p newSVpvn|5.004050||p newSVpvs_share||5.009003| newSVpvs|5.009003||p newSVpv||| newSVrv||| newSVsv||| newSVuv|5.006000||p newSV||| newTOKEN||| newUNOP||| newWHENOP||5.009003| newWHILEOP||5.009003| newXS_flags||5.009004| newXSproto||5.006000| newXS||5.006000| new_collate||5.006000| new_constant||| new_ctype||5.006000| new_he||| new_logop||| new_numeric||5.006000| new_stackinfo||5.005000| new_version||5.009000| new_warnings_bitfield||| next_symbol||| nextargv||| nextchar||| ninstr||| no_bareword_allowed||| no_fh_allowed||| no_op||| not_a_number||| nothreadhook||5.008000| nuke_stacks||| num_overflow|||n offer_nice_chunk||| oopsAV||| oopsCV||| oopsHV||| op_clear||| op_const_sv||| op_dump||5.006000| op_free||| op_getmad_weak||| op_getmad||| op_null||5.007002| op_refcnt_dec||| op_refcnt_inc||| op_refcnt_lock||5.009002| op_refcnt_unlock||5.009002| op_xmldump||| open_script||| pMY_CXT_|5.007003||p pMY_CXT|5.007003||p pTHX_|5.006000||p pTHX|5.006000||p packWARN|5.007003||p pack_cat||5.007003| pack_rec||| package||| packlist||5.008001| pad_add_anon||| pad_add_name||| pad_alloc||| pad_block_start||| pad_check_dup||| pad_compname_type||| pad_findlex||| pad_findmy||| pad_fixup_inner_anons||| pad_free||| pad_leavemy||| pad_new||| pad_peg|||n pad_push||| pad_reset||| pad_setsv||| pad_sv||5.009005| pad_swipe||| pad_tidy||| pad_undef||| parse_body||| parse_unicode_opts||| parser_dup||| parser_free||| path_is_absolute|||n peep||| pending_Slabs_to_ro||| perl_alloc_using|||n perl_alloc|||n perl_clone_using|||n perl_clone|||n perl_construct|||n perl_destruct||5.007003|n perl_free|||n perl_parse||5.006000|n perl_run|||n pidgone||| pm_description||| pmflag||| pmop_dump||5.006000| pmop_xmldump||| pmruntime||| pmtrans||| pop_scope||| pregcomp||5.009005| pregexec||| pregfree||| prepend_elem||| prepend_madprops||| printbuf||| printf_nocontext|||vn process_special_blocks||| ptr_table_clear||5.009005| ptr_table_fetch||5.009005| ptr_table_find|||n ptr_table_free||5.009005| ptr_table_new||5.009005| ptr_table_split||5.009005| ptr_table_store||5.009005| push_scope||| put_byte||| pv_display||5.006000| pv_escape||5.009004| pv_pretty||5.009004| pv_uni_display||5.007003| qerror||| qsortsvu||| re_compile||5.009005| re_croak2||| re_dup||| re_intuit_start||5.009005| re_intuit_string||5.006000| readpipe_override||| realloc||5.007002|n reentrant_free||| reentrant_init||| reentrant_retry|||vn reentrant_size||| ref_array_or_hash||| refcounted_he_chain_2hv||| refcounted_he_fetch||| refcounted_he_free||| refcounted_he_new||| refcounted_he_value||| refkids||| refto||| ref||5.009003| reg_check_named_buff_matched||| reg_named_buff_all||5.009005| reg_named_buff_exists||5.009005| reg_named_buff_fetch||5.009005| reg_named_buff_firstkey||5.009005| reg_named_buff_iter||| reg_named_buff_nextkey||5.009005| reg_named_buff_scalar||5.009005| reg_named_buff||| reg_namedseq||| reg_node||| reg_numbered_buff_fetch||| reg_numbered_buff_length||| reg_numbered_buff_store||| reg_qr_package||| reg_recode||| reg_scan_name||| reg_skipcomment||| reg_stringify||5.009005| reg_temp_copy||| reganode||| regatom||| regbranch||| regclass_swash||5.009004| regclass||| regcppop||| regcppush||| regcurly|||n regdump_extflags||| regdump||5.005000| regdupe_internal||| regexec_flags||5.005000| regfree_internal||5.009005| reghop3|||n reghop4|||n reghopmaybe3|||n reginclass||| reginitcolors||5.006000| reginsert||| regmatch||| regnext||5.005000| regpiece||| regpposixcc||| regprop||| regrepeat||| regtail_study||| regtail||| regtry||| reguni||| regwhite|||n reg||| repeatcpy||| report_evil_fh||| report_uninit||| require_pv||5.006000| require_tie_mod||| restore_magic||| rninstr||| rsignal_restore||| rsignal_save||| rsignal_state||5.004000| rsignal||5.004000| run_body||| run_user_filter||| runops_debug||5.005000| runops_standard||5.005000| rvpv_dup||| rxres_free||| rxres_restore||| rxres_save||| safesyscalloc||5.006000|n safesysfree||5.006000|n safesysmalloc||5.006000|n safesysrealloc||5.006000|n same_dirent||| save_I16||5.004000| save_I32||| save_I8||5.006000| save_aelem||5.004050| save_alloc||5.006000| save_aptr||| save_ary||| save_bool||5.008001| save_clearsv||| save_delete||| save_destructor_x||5.006000| save_destructor||5.006000| save_freeop||| save_freepv||| save_freesv||| save_generic_pvref||5.006001| save_generic_svref||5.005030| save_gp||5.004000| save_hash||| save_hek_flags|||n save_helem||5.004050| save_hints||5.005000| save_hptr||| save_int||| save_item||| save_iv||5.005000| save_lines||| save_list||| save_long||| save_magic||| save_mortalizesv||5.007001| save_nogv||| save_op||| save_padsv||5.007001| save_pptr||| save_re_context||5.006000| save_scalar_at||| save_scalar||| save_set_svflags||5.009000| save_shared_pvref||5.007003| save_sptr||| save_svref||| save_vptr||5.006000| savepvn||| savepvs||5.009003| savepv||| savesharedpvn||5.009005| savesharedpv||5.007003| savestack_grow_cnt||5.008001| savestack_grow||| savesvpv||5.009002| sawparens||| scalar_mod_type|||n scalarboolean||| scalarkids||| scalarseq||| scalarvoid||| scalar||| scan_bin||5.006000| scan_commit||| scan_const||| scan_formline||| scan_heredoc||| scan_hex||| scan_ident||| scan_inputsymbol||| scan_num||5.007001| scan_oct||| scan_pat||| scan_str||| scan_subst||| scan_trans||| scan_version||5.009001| scan_vstring||5.009005| scan_word||| scope||| screaminstr||5.005000| seed||5.008001| sequence_num||| sequence_tail||| sequence||| set_context||5.006000|n set_csh||| set_numeric_local||5.006000| set_numeric_radix||5.006000| set_numeric_standard||5.006000| setdefout||| setenv_getix||| share_hek_flags||| share_hek||5.004000| si_dup||| sighandler|||n simplify_sort||| skipspace0||| skipspace1||| skipspace2||| skipspace||| softref2xv||| sortcv_stacked||| sortcv_xsub||| sortcv||| sortsv_flags||5.009003| sortsv||5.007003| space_join_names_mortal||| ss_dup||| stack_grow||| start_force||| start_glob||| start_subparse||5.004000| stashpv_hvname_match||5.009005| stdize_locale||| strEQ||| strGE||| strGT||| strLE||| strLT||| strNE||| str_to_version||5.006000| strip_return||| strnEQ||| strnNE||| study_chunk||| sub_crush_depth||| sublex_done||| sublex_push||| sublex_start||| sv_2bool||| sv_2cv||| sv_2io||| sv_2iuv_common||| sv_2iuv_non_preserve||| sv_2iv_flags||5.009001| sv_2iv||| sv_2mortal||| sv_2nv||| sv_2pv_flags|5.007002||p sv_2pv_nolen|5.006000||p sv_2pvbyte_nolen|5.006000||p sv_2pvbyte|5.006000||p sv_2pvutf8_nolen||5.006000| sv_2pvutf8||5.006000| sv_2pv||| sv_2uv_flags||5.009001| sv_2uv|5.004000||p sv_add_arena||| sv_add_backref||| sv_backoff||| sv_bless||| sv_cat_decode||5.008001| sv_catpv_mg|5.004050||p sv_catpvf_mg_nocontext|||pvn sv_catpvf_mg|5.006000|5.004000|pv sv_catpvf_nocontext|||vn sv_catpvf||5.004000|v sv_catpvn_flags||5.007002| sv_catpvn_mg|5.004050||p sv_catpvn_nomg|5.007002||p sv_catpvn||| sv_catpvs|5.009003||p sv_catpv||| sv_catsv_flags||5.007002| sv_catsv_mg|5.004050||p sv_catsv_nomg|5.007002||p sv_catsv||| sv_catxmlpvn||| sv_catxmlsv||| sv_chop||| sv_clean_all||| sv_clean_objs||| sv_clear||| sv_cmp_locale||5.004000| sv_cmp||| sv_collxfrm||| sv_compile_2op||5.008001| sv_copypv||5.007003| sv_dec||| sv_del_backref||| sv_derived_from||5.004000| sv_does||5.009004| sv_dump||| sv_dup||| sv_eq||| sv_exp_grow||| sv_force_normal_flags||5.007001| sv_force_normal||5.006000| sv_free2||| sv_free_arenas||| sv_free||| sv_gets||5.004000| sv_grow||| sv_i_ncmp||| sv_inc||| sv_insert||| sv_isa||| sv_isobject||| sv_iv||5.005000| sv_kill_backrefs||| sv_len_utf8||5.006000| sv_len||| sv_magic_portable|5.009005|5.004000|p sv_magicext||5.007003| sv_magic||| sv_mortalcopy||| sv_ncmp||| sv_newmortal||| sv_newref||| sv_nolocking||5.007003| sv_nosharing||5.007003| sv_nounlocking||| sv_nv||5.005000| sv_peek||5.005000| sv_pos_b2u_midway||| sv_pos_b2u||5.006000| sv_pos_u2b_cached||| sv_pos_u2b_forwards|||n sv_pos_u2b_midway|||n sv_pos_u2b||5.006000| sv_pvbyten_force||5.006000| sv_pvbyten||5.006000| sv_pvbyte||5.006000| sv_pvn_force_flags|5.007002||p sv_pvn_force||| sv_pvn_nomg|5.007003||p sv_pvn||| sv_pvutf8n_force||5.006000| sv_pvutf8n||5.006000| sv_pvutf8||5.006000| sv_pv||5.006000| sv_recode_to_utf8||5.007003| sv_reftype||| sv_release_COW||| sv_replace||| sv_report_used||| sv_reset||| sv_rvweaken||5.006000| sv_setiv_mg|5.004050||p sv_setiv||| sv_setnv_mg|5.006000||p sv_setnv||| sv_setpv_mg|5.004050||p sv_setpvf_mg_nocontext|||pvn sv_setpvf_mg|5.006000|5.004000|pv sv_setpvf_nocontext|||vn sv_setpvf||5.004000|v sv_setpviv_mg||5.008001| sv_setpviv||5.008001| sv_setpvn_mg|5.004050||p sv_setpvn||| sv_setpvs|5.009004||p sv_setpv||| sv_setref_iv||| sv_setref_nv||| sv_setref_pvn||| sv_setref_pv||| sv_setref_uv||5.007001| sv_setsv_cow||| sv_setsv_flags||5.007002| sv_setsv_mg|5.004050||p sv_setsv_nomg|5.007002||p sv_setsv||| sv_setuv_mg|5.004050||p sv_setuv|5.004000||p sv_tainted||5.004000| sv_taint||5.004000| sv_true||5.005000| sv_unglob||| sv_uni_display||5.007003| sv_unmagic||| sv_unref_flags||5.007001| sv_unref||| sv_untaint||5.004000| sv_upgrade||| sv_usepvn_flags||5.009004| sv_usepvn_mg|5.004050||p sv_usepvn||| sv_utf8_decode||5.006000| sv_utf8_downgrade||5.006000| sv_utf8_encode||5.006000| sv_utf8_upgrade_flags||5.007002| sv_utf8_upgrade||5.007001| sv_uv|5.005000||p sv_vcatpvf_mg|5.006000|5.004000|p sv_vcatpvfn||5.004000| sv_vcatpvf|5.006000|5.004000|p sv_vsetpvf_mg|5.006000|5.004000|p sv_vsetpvfn||5.004000| sv_vsetpvf|5.006000|5.004000|p sv_xmlpeek||| svtype||| swallow_bom||| swap_match_buff||| swash_fetch||5.007002| swash_get||| swash_init||5.006000| sys_intern_clear||| sys_intern_dup||| sys_intern_init||| taint_env||| taint_proper||| tmps_grow||5.006000| toLOWER||| toUPPER||| to_byte_substr||| to_uni_fold||5.007003| to_uni_lower_lc||5.006000| to_uni_lower||5.007003| to_uni_title_lc||5.006000| to_uni_title||5.007003| to_uni_upper_lc||5.006000| to_uni_upper||5.007003| to_utf8_case||5.007003| to_utf8_fold||5.007003| to_utf8_lower||5.007003| to_utf8_substr||| to_utf8_title||5.007003| to_utf8_upper||5.007003| token_free||| token_getmad||| tokenize_use||| tokeq||| tokereport||| too_few_arguments||| too_many_arguments||| uiv_2buf|||n unlnk||| unpack_rec||| unpack_str||5.007003| unpackstring||5.008001| unshare_hek_or_pvn||| unshare_hek||| unsharepvn||5.004000| unwind_handler_stack||| update_debugger_info||| upg_version||5.009005| usage||| utf16_to_utf8_reversed||5.006001| utf16_to_utf8||5.006001| utf8_distance||5.006000| utf8_hop||5.006000| utf8_length||5.007001| utf8_mg_pos_cache_update||| utf8_to_bytes||5.006001| utf8_to_uvchr||5.007001| utf8_to_uvuni||5.007001| utf8n_to_uvchr||| utf8n_to_uvuni||5.007001| utilize||| uvchr_to_utf8_flags||5.007003| uvchr_to_utf8||| uvuni_to_utf8_flags||5.007003| uvuni_to_utf8||5.007001| validate_suid||| varname||| vcmp||5.009000| vcroak||5.006000| vdeb||5.007003| vdie_common||| vdie_croak_common||| vdie||| vform||5.006000| visit||| vivify_defelem||| vivify_ref||| vload_module|5.006000||p vmess||5.006000| vnewSVpvf|5.006000|5.004000|p vnormal||5.009002| vnumify||5.009000| vstringify||5.009000| vverify||5.009003| vwarner||5.006000| vwarn||5.006000| wait4pid||| warn_nocontext|||vn warner_nocontext|||vn warner|5.006000|5.004000|pv warn|||v watch||| whichsig||| write_no_mem||| write_to_stderr||| xmldump_all||| xmldump_attr||| xmldump_eval||| xmldump_form||| xmldump_indent|||v xmldump_packsubs||| xmldump_sub||| xmldump_vindent||| yyerror||| yylex||| yyparse||| yywarn||| ); if (exists $opt{'list-unsupported'}) { my $f; for $f (sort { lc $a cmp lc $b } keys %API) { next unless $API{$f}{todo}; print "$f ", '.'x(40-length($f)), " ", format_version($API{$f}{todo}), "\n"; } exit 0; } # Scan for possible replacement candidates my(%replace, %need, %hints, %warnings, %depends); my $replace = 0; my($hint, $define, $function); sub find_api { my $code = shift; $code =~ s{ / (?: \*[^*]*\*+(?:[^$ccs][^*]*\*+)* / | /[^\r\n]*) | "[^"\\]*(?:\\.[^"\\]*)*" | '[^'\\]*(?:\\.[^'\\]*)*' }{}egsx; grep { exists $API{$_} } $code =~ /(\w+)/mg; } while () { if ($hint) { my $h = $hint->[0] eq 'Hint' ? \%hints : \%warnings; if (m{^\s*\*\s(.*?)\s*$}) { for (@{$hint->[1]}) { $h->{$_} ||= ''; # suppress warning with older perls $h->{$_} .= "$1\n"; } } else { undef $hint } } $hint = [$1, [split /,?\s+/, $2]] if m{^\s*$rccs\s+(Hint|Warning):\s+(\w+(?:,?\s+\w+)*)\s*$}; if ($define) { if ($define->[1] =~ /\\$/) { $define->[1] .= $_; } else { if (exists $API{$define->[0]} && $define->[1] !~ /^DPPP_\(/) { my @n = find_api($define->[1]); push @{$depends{$define->[0]}}, @n if @n } undef $define; } } $define = [$1, $2] if m{^\s*#\s*define\s+(\w+)(?:\([^)]*\))?\s+(.*)}; if ($function) { if (/^}/) { if (exists $API{$function->[0]}) { my @n = find_api($function->[1]); push @{$depends{$function->[0]}}, @n if @n } undef $define; } else { $function->[1] .= $_; } } $function = [$1, ''] if m{^DPPP_\(my_(\w+)\)}; $replace = $1 if m{^\s*$rccs\s+Replace:\s+(\d+)\s+$rcce\s*$}; $replace{$2} = $1 if $replace and m{^\s*#\s*define\s+(\w+)(?:\([^)]*\))?\s+(\w+)}; $replace{$2} = $1 if m{^\s*#\s*define\s+(\w+)(?:\([^)]*\))?\s+(\w+).*$rccs\s+Replace\s+$rcce}; $replace{$1} = $2 if m{^\s*$rccs\s+Replace (\w+) with (\w+)\s+$rcce\s*$}; if (m{^\s*$rccs\s+(\w+)\s+depends\s+on\s+(\w+(\s*,\s*\w+)*)\s+$rcce\s*$}) { push @{$depends{$1}}, map { s/\s+//g; $_ } split /,/, $2; } $need{$1} = 1 if m{^#if\s+defined\(NEED_(\w+)(?:_GLOBAL)?\)}; } for (values %depends) { my %s; $_ = [sort grep !$s{$_}++, @$_]; } if (exists $opt{'api-info'}) { my $f; my $count = 0; my $match = $opt{'api-info'} =~ m!^/(.*)/$! ? $1 : "^\Q$opt{'api-info'}\E\$"; for $f (sort { lc $a cmp lc $b } keys %API) { next unless $f =~ /$match/; print "\n=== $f ===\n\n"; my $info = 0; if ($API{$f}{base} || $API{$f}{todo}) { my $base = format_version($API{$f}{base} || $API{$f}{todo}); print "Supported at least starting from perl-$base.\n"; $info++; } if ($API{$f}{provided}) { my $todo = $API{$f}{todo} ? format_version($API{$f}{todo}) : "5.003"; print "Support by $ppport provided back to perl-$todo.\n"; print "Support needs to be explicitly requested by NEED_$f.\n" if exists $need{$f}; print "Depends on: ", join(', ', @{$depends{$f}}), ".\n" if exists $depends{$f}; print "\n$hints{$f}" if exists $hints{$f}; print "\nWARNING:\n$warnings{$f}" if exists $warnings{$f}; $info++; } print "No portability information available.\n" unless $info; $count++; } $count or print "Found no API matching '$opt{'api-info'}'."; print "\n"; exit 0; } if (exists $opt{'list-provided'}) { my $f; for $f (sort { lc $a cmp lc $b } keys %API) { next unless $API{$f}{provided}; my @flags; push @flags, 'explicit' if exists $need{$f}; push @flags, 'depend' if exists $depends{$f}; push @flags, 'hint' if exists $hints{$f}; push @flags, 'warning' if exists $warnings{$f}; my $flags = @flags ? ' ['.join(', ', @flags).']' : ''; print "$f$flags\n"; } exit 0; } my @files; my @srcext = qw( .xs .c .h .cc .cpp -c.inc -xs.inc ); my $srcext = join '|', map { quotemeta $_ } @srcext; if (@ARGV) { my %seen; for (@ARGV) { if (-e) { if (-f) { push @files, $_ unless $seen{$_}++; } else { warn "'$_' is not a file.\n" } } else { my @new = grep { -f } glob $_ or warn "'$_' does not exist.\n"; push @files, grep { !$seen{$_}++ } @new; } } } else { eval { require File::Find; File::Find::find(sub { $File::Find::name =~ /($srcext)$/i and push @files, $File::Find::name; }, '.'); }; if ($@) { @files = map { glob "*$_" } @srcext; } } if (!@ARGV || $opt{filter}) { my(@in, @out); my %xsc = map { /(.*)\.xs$/ ? ("$1.c" => 1, "$1.cc" => 1) : () } @files; for (@files) { my $out = exists $xsc{$_} || /\b\Q$ppport\E$/i || !/($srcext)$/i; push @{ $out ? \@out : \@in }, $_; } if (@ARGV && @out) { warning("Skipping the following files (use --nofilter to avoid this):\n| ", join "\n| ", @out); } @files = @in; } die "No input files given!\n" unless @files; my(%files, %global, %revreplace); %revreplace = reverse %replace; my $filename; my $patch_opened = 0; for $filename (@files) { unless (open IN, "<$filename") { warn "Unable to read from $filename: $!\n"; next; } info("Scanning $filename ..."); my $c = do { local $/; }; close IN; my %file = (orig => $c, changes => 0); # Temporarily remove C/XS comments and strings from the code my @ccom; $c =~ s{ ( ^$HS*\#$HS*include\b[^\r\n]+\b(?:\Q$ppport\E|XSUB\.h)\b[^\r\n]* | ^$HS*\#$HS*(?:define|elif|if(?:def)?)\b[^\r\n]* ) | ( ^$HS*\#[^\r\n]* | "[^"\\]*(?:\\.[^"\\]*)*" | '[^'\\]*(?:\\.[^'\\]*)*' | / (?: \*[^*]*\*+(?:[^$ccs][^*]*\*+)* / | /[^\r\n]* ) ) }{ defined $2 and push @ccom, $2; defined $1 ? $1 : "$ccs$#ccom$cce" }mgsex; $file{ccom} = \@ccom; $file{code} = $c; $file{has_inc_ppport} = $c =~ /^$HS*#$HS*include[^\r\n]+\b\Q$ppport\E\b/m; my $func; for $func (keys %API) { my $match = $func; $match .= "|$revreplace{$func}" if exists $revreplace{$func}; if ($c =~ /\b(?:Perl_)?($match)\b/) { $file{uses_replace}{$1}++ if exists $revreplace{$func} && $1 eq $revreplace{$func}; $file{uses_Perl}{$func}++ if $c =~ /\bPerl_$func\b/; if (exists $API{$func}{provided}) { $file{uses_provided}{$func}++; if (!exists $API{$func}{base} || $API{$func}{base} > $opt{'compat-version'}) { $file{uses}{$func}++; my @deps = rec_depend($func); if (@deps) { $file{uses_deps}{$func} = \@deps; for (@deps) { $file{uses}{$_} = 0 unless exists $file{uses}{$_}; } } for ($func, @deps) { $file{needs}{$_} = 'static' if exists $need{$_}; } } } if (exists $API{$func}{todo} && $API{$func}{todo} > $opt{'compat-version'}) { if ($c =~ /\b$func\b/) { $file{uses_todo}{$func}++; } } } } while ($c =~ /^$HS*#$HS*define$HS+(NEED_(\w+?)(_GLOBAL)?)\b/mg) { if (exists $need{$2}) { $file{defined $3 ? 'needed_global' : 'needed_static'}{$2}++; } else { warning("Possibly wrong #define $1 in $filename") } } for (qw(uses needs uses_todo needed_global needed_static)) { for $func (keys %{$file{$_}}) { push @{$global{$_}{$func}}, $filename; } } $files{$filename} = \%file; } # Globally resolve NEED_'s my $need; for $need (keys %{$global{needs}}) { if (@{$global{needs}{$need}} > 1) { my @targets = @{$global{needs}{$need}}; my @t = grep $files{$_}{needed_global}{$need}, @targets; @targets = @t if @t; @t = grep /\.xs$/i, @targets; @targets = @t if @t; my $target = shift @targets; $files{$target}{needs}{$need} = 'global'; for (@{$global{needs}{$need}}) { $files{$_}{needs}{$need} = 'extern' if $_ ne $target; } } } for $filename (@files) { exists $files{$filename} or next; info("=== Analyzing $filename ==="); my %file = %{$files{$filename}}; my $func; my $c = $file{code}; my $warnings = 0; for $func (sort keys %{$file{uses_Perl}}) { if ($API{$func}{varargs}) { unless ($API{$func}{nothxarg}) { my $changes = ($c =~ s{\b(Perl_$func\s*\(\s*)(?!aTHX_?)(\)|[^\s)]*\))} { $1 . ($2 eq ')' ? 'aTHX' : 'aTHX_ ') . $2 }ge); if ($changes) { warning("Doesn't pass interpreter argument aTHX to Perl_$func"); $file{changes} += $changes; } } } else { warning("Uses Perl_$func instead of $func"); $file{changes} += ($c =~ s{\bPerl_$func(\s*)\((\s*aTHX_?)?\s*} {$func$1(}g); } } for $func (sort keys %{$file{uses_replace}}) { warning("Uses $func instead of $replace{$func}"); $file{changes} += ($c =~ s/\b$func\b/$replace{$func}/g); } for $func (sort keys %{$file{uses_provided}}) { if ($file{uses}{$func}) { if (exists $file{uses_deps}{$func}) { diag("Uses $func, which depends on ", join(', ', @{$file{uses_deps}{$func}})); } else { diag("Uses $func"); } } $warnings += hint($func); } unless ($opt{quiet}) { for $func (sort keys %{$file{uses_todo}}) { print "*** WARNING: Uses $func, which may not be portable below perl ", format_version($API{$func}{todo}), ", even with '$ppport'\n"; $warnings++; } } for $func (sort keys %{$file{needed_static}}) { my $message = ''; if (not exists $file{uses}{$func}) { $message = "No need to define NEED_$func if $func is never used"; } elsif (exists $file{needs}{$func} && $file{needs}{$func} ne 'static') { $message = "No need to define NEED_$func when already needed globally"; } if ($message) { diag($message); $file{changes} += ($c =~ s/^$HS*#$HS*define$HS+NEED_$func\b.*$LF//mg); } } for $func (sort keys %{$file{needed_global}}) { my $message = ''; if (not exists $global{uses}{$func}) { $message = "No need to define NEED_${func}_GLOBAL if $func is never used"; } elsif (exists $file{needs}{$func}) { if ($file{needs}{$func} eq 'extern') { $message = "No need to define NEED_${func}_GLOBAL when already needed globally"; } elsif ($file{needs}{$func} eq 'static') { $message = "No need to define NEED_${func}_GLOBAL when only used in this file"; } } if ($message) { diag($message); $file{changes} += ($c =~ s/^$HS*#$HS*define$HS+NEED_${func}_GLOBAL\b.*$LF//mg); } } $file{needs_inc_ppport} = keys %{$file{uses}}; if ($file{needs_inc_ppport}) { my $pp = ''; for $func (sort keys %{$file{needs}}) { my $type = $file{needs}{$func}; next if $type eq 'extern'; my $suffix = $type eq 'global' ? '_GLOBAL' : ''; unless (exists $file{"needed_$type"}{$func}) { if ($type eq 'global') { diag("Files [@{$global{needs}{$func}}] need $func, adding global request"); } else { diag("File needs $func, adding static request"); } $pp .= "#define NEED_$func$suffix\n"; } } if ($pp && ($c =~ s/^(?=$HS*#$HS*define$HS+NEED_\w+)/$pp/m)) { $pp = ''; $file{changes}++; } unless ($file{has_inc_ppport}) { diag("Needs to include '$ppport'"); $pp .= qq(#include "$ppport"\n) } if ($pp) { $file{changes} += ($c =~ s/^($HS*#$HS*define$HS+NEED_\w+.*?)^/$1$pp/ms) || ($c =~ s/^(?=$HS*#$HS*include.*\Q$ppport\E)/$pp/m) || ($c =~ s/^($HS*#$HS*include.*XSUB.*\s*?)^/$1$pp/m) || ($c =~ s/^/$pp/); } } else { if ($file{has_inc_ppport}) { diag("No need to include '$ppport'"); $file{changes} += ($c =~ s/^$HS*?#$HS*include.*\Q$ppport\E.*?$LF//m); } } # put back in our C comments my $ix; my $cppc = 0; my @ccom = @{$file{ccom}}; for $ix (0 .. $#ccom) { if (!$opt{cplusplus} && $ccom[$ix] =~ s!^//!!) { $cppc++; $file{changes} += $c =~ s/$rccs$ix$rcce/$ccs$ccom[$ix] $cce/; } else { $c =~ s/$rccs$ix$rcce/$ccom[$ix]/; } } if ($cppc) { my $s = $cppc != 1 ? 's' : ''; warning("Uses $cppc C++ style comment$s, which is not portable"); } my $s = $warnings != 1 ? 's' : ''; my $warn = $warnings ? " ($warnings warning$s)" : ''; info("Analysis completed$warn"); if ($file{changes}) { if (exists $opt{copy}) { my $newfile = "$filename$opt{copy}"; if (-e $newfile) { error("'$newfile' already exists, refusing to write copy of '$filename'"); } else { local *F; if (open F, ">$newfile") { info("Writing copy of '$filename' with changes to '$newfile'"); print F $c; close F; } else { error("Cannot open '$newfile' for writing: $!"); } } } elsif (exists $opt{patch} || $opt{changes}) { if (exists $opt{patch}) { unless ($patch_opened) { if (open PATCH, ">$opt{patch}") { $patch_opened = 1; } else { error("Cannot open '$opt{patch}' for writing: $!"); delete $opt{patch}; $opt{changes} = 1; goto fallback; } } mydiff(\*PATCH, $filename, $c); } else { fallback: info("Suggested changes:"); mydiff(\*STDOUT, $filename, $c); } } else { my $s = $file{changes} == 1 ? '' : 's'; info("$file{changes} potentially required change$s detected"); } } else { info("Looks good"); } } close PATCH if $patch_opened; exit 0; sub try_use { eval "use @_;"; return $@ eq '' } sub mydiff { local *F = shift; my($file, $str) = @_; my $diff; if (exists $opt{diff}) { $diff = run_diff($opt{diff}, $file, $str); } if (!defined $diff and try_use('Text::Diff')) { $diff = Text::Diff::diff($file, \$str, { STYLE => 'Unified' }); $diff = <
    $tmp") { print F $str; close F; if (open F, "$prog $file $tmp |") { while () { s/\Q$tmp\E/$file.patched/; $diff .= $_; } close F; unlink $tmp; return $diff; } unlink $tmp; } else { error("Cannot open '$tmp' for writing: $!"); } return undef; } sub rec_depend { my($func, $seen) = @_; return () unless exists $depends{$func}; $seen = {%{$seen||{}}}; return () if $seen->{$func}++; my %s; grep !$s{$_}++, map { ($_, rec_depend($_, $seen)) } @{$depends{$func}}; } sub parse_version { my $ver = shift; if ($ver =~ /^(\d+)\.(\d+)\.(\d+)$/) { return ($1, $2, $3); } elsif ($ver !~ /^\d+\.[\d_]+$/) { die "cannot parse version '$ver'\n"; } $ver =~ s/_//g; $ver =~ s/$/000000/; my($r,$v,$s) = $ver =~ /(\d+)\.(\d{3})(\d{3})/; $v = int $v; $s = int $s; if ($r < 5 || ($r == 5 && $v < 6)) { if ($s % 10) { die "cannot parse version '$ver'\n"; } } return ($r, $v, $s); } sub format_version { my $ver = shift; $ver =~ s/$/000000/; my($r,$v,$s) = $ver =~ /(\d+)\.(\d{3})(\d{3})/; $v = int $v; $s = int $s; if ($r < 5 || ($r == 5 && $v < 6)) { if ($s % 10) { die "invalid version '$ver'\n"; } $s /= 10; $ver = sprintf "%d.%03d", $r, $v; $s > 0 and $ver .= sprintf "_%02d", $s; return $ver; } return sprintf "%d.%d.%d", $r, $v, $s; } sub info { $opt{quiet} and return; print @_, "\n"; } sub diag { $opt{quiet} and return; $opt{diag} and print @_, "\n"; } sub warning { $opt{quiet} and return; print "*** ", @_, "\n"; } sub error { print "*** ERROR: ", @_, "\n"; } my %given_hints; my %given_warnings; sub hint { $opt{quiet} and return; my $func = shift; my $rv = 0; if (exists $warnings{$func} && !$given_warnings{$func}++) { my $warn = $warnings{$func}; $warn =~ s!^!*** !mg; print "*** WARNING: $func\n", $warn; $rv++; } if ($opt{hints} && exists $hints{$func} && !$given_hints{$func}++) { my $hint = $hints{$func}; $hint =~ s/^/ /mg; print " --- hint for $func ---\n", $hint; } $rv; } sub usage { my($usage) = do { local(@ARGV,$/)=($0); <> } =~ /^=head\d$HS+SYNOPSIS\s*^(.*?)\s*^=/ms; my %M = ( 'I' => '*' ); $usage =~ s/^\s*perl\s+\S+/$^X $0/; $usage =~ s/([A-Z])<([^>]+)>/$M{$1}$2$M{$1}/g; print < }; my($copy) = $self =~ /^=head\d\s+COPYRIGHT\s*^(.*?)^=\w+/ms; $copy =~ s/^(?=\S+)/ /gms; $self =~ s/^$HS+Do NOT edit.*?(?=^-)/$copy/ms; $self =~ s/^SKIP.*(?=^__DATA__)/SKIP if (\@ARGV && \$ARGV[0] eq '--unstrip') { eval { require Devel::PPPort }; \$@ and die "Cannot require Devel::PPPort, please install.\\n"; if (\$Devel::PPPort::VERSION < $VERSION) { die "$0 was originally generated with Devel::PPPort $VERSION.\\n" . "Your Devel::PPPort is only version \$Devel::PPPort::VERSION.\\n" . "Please install a newer version, or --unstrip will not work.\\n"; } Devel::PPPort::WriteFile(\$0); exit 0; } print <$0" or die "cannot strip $0: $!\n"; print OUT "$pl$c\n"; exit 0; } __DATA__ */ #ifndef _P_P_PORTABILITY_H_ #define _P_P_PORTABILITY_H_ #ifndef DPPP_NAMESPACE # define DPPP_NAMESPACE DPPP_ #endif #define DPPP_CAT2(x,y) CAT2(x,y) #define DPPP_(name) DPPP_CAT2(DPPP_NAMESPACE, name) #ifndef PERL_REVISION # if !defined(__PATCHLEVEL_H_INCLUDED__) && !(defined(PATCHLEVEL) && defined(SUBVERSION)) # define PERL_PATCHLEVEL_H_IMPLICIT # include # endif # if !(defined(PERL_VERSION) || (defined(SUBVERSION) && defined(PATCHLEVEL))) # include # endif # ifndef PERL_REVISION # define PERL_REVISION (5) /* Replace: 1 */ # define PERL_VERSION PATCHLEVEL # define PERL_SUBVERSION SUBVERSION /* Replace PERL_PATCHLEVEL with PERL_VERSION */ /* Replace: 0 */ # endif #endif #define _dpppDEC2BCD(dec) ((((dec)/100)<<8)|((((dec)%100)/10)<<4)|((dec)%10)) #define PERL_BCDVERSION ((_dpppDEC2BCD(PERL_REVISION)<<24)|(_dpppDEC2BCD(PERL_VERSION)<<12)|_dpppDEC2BCD(PERL_SUBVERSION)) /* It is very unlikely that anyone will try to use this with Perl 6 (or greater), but who knows. */ #if PERL_REVISION != 5 # error ppport.h only works with Perl version 5 #endif /* PERL_REVISION != 5 */ #ifdef I_LIMITS # include #endif #ifndef PERL_UCHAR_MIN # define PERL_UCHAR_MIN ((unsigned char)0) #endif #ifndef PERL_UCHAR_MAX # ifdef UCHAR_MAX # define PERL_UCHAR_MAX ((unsigned char)UCHAR_MAX) # else # ifdef MAXUCHAR # define PERL_UCHAR_MAX ((unsigned char)MAXUCHAR) # else # define PERL_UCHAR_MAX ((unsigned char)~(unsigned)0) # endif # endif #endif #ifndef PERL_USHORT_MIN # define PERL_USHORT_MIN ((unsigned short)0) #endif #ifndef PERL_USHORT_MAX # ifdef USHORT_MAX # define PERL_USHORT_MAX ((unsigned short)USHORT_MAX) # else # ifdef MAXUSHORT # define PERL_USHORT_MAX ((unsigned short)MAXUSHORT) # else # ifdef USHRT_MAX # define PERL_USHORT_MAX ((unsigned short)USHRT_MAX) # else # define PERL_USHORT_MAX ((unsigned short)~(unsigned)0) # endif # endif # endif #endif #ifndef PERL_SHORT_MAX # ifdef SHORT_MAX # define PERL_SHORT_MAX ((short)SHORT_MAX) # else # ifdef MAXSHORT /* Often used in */ # define PERL_SHORT_MAX ((short)MAXSHORT) # else # ifdef SHRT_MAX # define PERL_SHORT_MAX ((short)SHRT_MAX) # else # define PERL_SHORT_MAX ((short) (PERL_USHORT_MAX >> 1)) # endif # endif # endif #endif #ifndef PERL_SHORT_MIN # ifdef SHORT_MIN # define PERL_SHORT_MIN ((short)SHORT_MIN) # else # ifdef MINSHORT # define PERL_SHORT_MIN ((short)MINSHORT) # else # ifdef SHRT_MIN # define PERL_SHORT_MIN ((short)SHRT_MIN) # else # define PERL_SHORT_MIN (-PERL_SHORT_MAX - ((3 & -1) == 3)) # endif # endif # endif #endif #ifndef PERL_UINT_MAX # ifdef UINT_MAX # define PERL_UINT_MAX ((unsigned int)UINT_MAX) # else # ifdef MAXUINT # define PERL_UINT_MAX ((unsigned int)MAXUINT) # else # define PERL_UINT_MAX (~(unsigned int)0) # endif # endif #endif #ifndef PERL_UINT_MIN # define PERL_UINT_MIN ((unsigned int)0) #endif #ifndef PERL_INT_MAX # ifdef INT_MAX # define PERL_INT_MAX ((int)INT_MAX) # else # ifdef MAXINT /* Often used in */ # define PERL_INT_MAX ((int)MAXINT) # else # define PERL_INT_MAX ((int)(PERL_UINT_MAX >> 1)) # endif # endif #endif #ifndef PERL_INT_MIN # ifdef INT_MIN # define PERL_INT_MIN ((int)INT_MIN) # else # ifdef MININT # define PERL_INT_MIN ((int)MININT) # else # define PERL_INT_MIN (-PERL_INT_MAX - ((3 & -1) == 3)) # endif # endif #endif #ifndef PERL_ULONG_MAX # ifdef ULONG_MAX # define PERL_ULONG_MAX ((unsigned long)ULONG_MAX) # else # ifdef MAXULONG # define PERL_ULONG_MAX ((unsigned long)MAXULONG) # else # define PERL_ULONG_MAX (~(unsigned long)0) # endif # endif #endif #ifndef PERL_ULONG_MIN # define PERL_ULONG_MIN ((unsigned long)0L) #endif #ifndef PERL_LONG_MAX # ifdef LONG_MAX # define PERL_LONG_MAX ((long)LONG_MAX) # else # ifdef MAXLONG # define PERL_LONG_MAX ((long)MAXLONG) # else # define PERL_LONG_MAX ((long) (PERL_ULONG_MAX >> 1)) # endif # endif #endif #ifndef PERL_LONG_MIN # ifdef LONG_MIN # define PERL_LONG_MIN ((long)LONG_MIN) # else # ifdef MINLONG # define PERL_LONG_MIN ((long)MINLONG) # else # define PERL_LONG_MIN (-PERL_LONG_MAX - ((3 & -1) == 3)) # endif # endif #endif #if defined(HAS_QUAD) && (defined(convex) || defined(uts)) # ifndef PERL_UQUAD_MAX # ifdef ULONGLONG_MAX # define PERL_UQUAD_MAX ((unsigned long long)ULONGLONG_MAX) # else # ifdef MAXULONGLONG # define PERL_UQUAD_MAX ((unsigned long long)MAXULONGLONG) # else # define PERL_UQUAD_MAX (~(unsigned long long)0) # endif # endif # endif # ifndef PERL_UQUAD_MIN # define PERL_UQUAD_MIN ((unsigned long long)0L) # endif # ifndef PERL_QUAD_MAX # ifdef LONGLONG_MAX # define PERL_QUAD_MAX ((long long)LONGLONG_MAX) # else # ifdef MAXLONGLONG # define PERL_QUAD_MAX ((long long)MAXLONGLONG) # else # define PERL_QUAD_MAX ((long long) (PERL_UQUAD_MAX >> 1)) # endif # endif # endif # ifndef PERL_QUAD_MIN # ifdef LONGLONG_MIN # define PERL_QUAD_MIN ((long long)LONGLONG_MIN) # else # ifdef MINLONGLONG # define PERL_QUAD_MIN ((long long)MINLONGLONG) # else # define PERL_QUAD_MIN (-PERL_QUAD_MAX - ((3 & -1) == 3)) # endif # endif # endif #endif /* This is based on code from 5.003 perl.h */ #ifdef HAS_QUAD # ifdef cray #ifndef IVTYPE # define IVTYPE int #endif #ifndef IV_MIN # define IV_MIN PERL_INT_MIN #endif #ifndef IV_MAX # define IV_MAX PERL_INT_MAX #endif #ifndef UV_MIN # define UV_MIN PERL_UINT_MIN #endif #ifndef UV_MAX # define UV_MAX PERL_UINT_MAX #endif # ifdef INTSIZE #ifndef IVSIZE # define IVSIZE INTSIZE #endif # endif # else # if defined(convex) || defined(uts) #ifndef IVTYPE # define IVTYPE long long #endif #ifndef IV_MIN # define IV_MIN PERL_QUAD_MIN #endif #ifndef IV_MAX # define IV_MAX PERL_QUAD_MAX #endif #ifndef UV_MIN # define UV_MIN PERL_UQUAD_MIN #endif #ifndef UV_MAX # define UV_MAX PERL_UQUAD_MAX #endif # ifdef LONGLONGSIZE #ifndef IVSIZE # define IVSIZE LONGLONGSIZE #endif # endif # else #ifndef IVTYPE # define IVTYPE long #endif #ifndef IV_MIN # define IV_MIN PERL_LONG_MIN #endif #ifndef IV_MAX # define IV_MAX PERL_LONG_MAX #endif #ifndef UV_MIN # define UV_MIN PERL_ULONG_MIN #endif #ifndef UV_MAX # define UV_MAX PERL_ULONG_MAX #endif # ifdef LONGSIZE #ifndef IVSIZE # define IVSIZE LONGSIZE #endif # endif # endif # endif #ifndef IVSIZE # define IVSIZE 8 #endif #ifndef PERL_QUAD_MIN # define PERL_QUAD_MIN IV_MIN #endif #ifndef PERL_QUAD_MAX # define PERL_QUAD_MAX IV_MAX #endif #ifndef PERL_UQUAD_MIN # define PERL_UQUAD_MIN UV_MIN #endif #ifndef PERL_UQUAD_MAX # define PERL_UQUAD_MAX UV_MAX #endif #else #ifndef IVTYPE # define IVTYPE long #endif #ifndef IV_MIN # define IV_MIN PERL_LONG_MIN #endif #ifndef IV_MAX # define IV_MAX PERL_LONG_MAX #endif #ifndef UV_MIN # define UV_MIN PERL_ULONG_MIN #endif #ifndef UV_MAX # define UV_MAX PERL_ULONG_MAX #endif #endif #ifndef IVSIZE # ifdef LONGSIZE # define IVSIZE LONGSIZE # else # define IVSIZE 4 /* A bold guess, but the best we can make. */ # endif #endif #ifndef UVTYPE # define UVTYPE unsigned IVTYPE #endif #ifndef UVSIZE # define UVSIZE IVSIZE #endif #ifndef sv_setuv # define sv_setuv(sv, uv) \ STMT_START { \ UV TeMpUv = uv; \ if (TeMpUv <= IV_MAX) \ sv_setiv(sv, TeMpUv); \ else \ sv_setnv(sv, (double)TeMpUv); \ } STMT_END #endif #ifndef newSVuv # define newSVuv(uv) ((uv) <= IV_MAX ? newSViv((IV)uv) : newSVnv((NV)uv)) #endif #ifndef sv_2uv # define sv_2uv(sv) ((PL_Sv = (sv)), (UV) (SvNOK(PL_Sv) ? SvNV(PL_Sv) : sv_2nv(PL_Sv))) #endif #ifndef SvUVX # define SvUVX(sv) ((UV)SvIVX(sv)) #endif #ifndef SvUVXx # define SvUVXx(sv) SvUVX(sv) #endif #ifndef SvUV # define SvUV(sv) (SvIOK(sv) ? SvUVX(sv) : sv_2uv(sv)) #endif #ifndef SvUVx # define SvUVx(sv) ((PL_Sv = (sv)), SvUV(PL_Sv)) #endif /* Hint: sv_uv * Always use the SvUVx() macro instead of sv_uv(). */ #ifndef sv_uv # define sv_uv(sv) SvUVx(sv) #endif #if !defined(SvUOK) && defined(SvIOK_UV) # define SvUOK(sv) SvIOK_UV(sv) #endif #ifndef XST_mUV # define XST_mUV(i,v) (ST(i) = sv_2mortal(newSVuv(v)) ) #endif #ifndef XSRETURN_UV # define XSRETURN_UV(v) STMT_START { XST_mUV(0,v); XSRETURN(1); } STMT_END #endif #ifndef PUSHu # define PUSHu(u) STMT_START { sv_setuv(TARG, (UV)(u)); PUSHTARG; } STMT_END #endif #ifndef XPUSHu # define XPUSHu(u) STMT_START { sv_setuv(TARG, (UV)(u)); XPUSHTARG; } STMT_END #endif #ifdef HAS_MEMCMP #ifndef memNE # define memNE(s1,s2,l) (memcmp(s1,s2,l)) #endif #ifndef memEQ # define memEQ(s1,s2,l) (!memcmp(s1,s2,l)) #endif #else #ifndef memNE # define memNE(s1,s2,l) (bcmp(s1,s2,l)) #endif #ifndef memEQ # define memEQ(s1,s2,l) (!bcmp(s1,s2,l)) #endif #endif #ifndef MoveD # define MoveD(s,d,n,t) memmove((char*)(d),(char*)(s), (n) * sizeof(t)) #endif #ifndef CopyD # define CopyD(s,d,n,t) memcpy((char*)(d),(char*)(s), (n) * sizeof(t)) #endif #ifdef HAS_MEMSET #ifndef ZeroD # define ZeroD(d,n,t) memzero((char*)(d), (n) * sizeof(t)) #endif #else #ifndef ZeroD # define ZeroD(d,n,t) ((void)memzero((char*)(d), (n) * sizeof(t)), d) #endif #endif #ifndef PoisonWith # define PoisonWith(d,n,t,b) (void)memset((char*)(d), (U8)(b), (n) * sizeof(t)) #endif #ifndef PoisonNew # define PoisonNew(d,n,t) PoisonWith(d,n,t,0xAB) #endif #ifndef PoisonFree # define PoisonFree(d,n,t) PoisonWith(d,n,t,0xEF) #endif #ifndef Poison # define Poison(d,n,t) PoisonFree(d,n,t) #endif #ifndef Newx # define Newx(v,n,t) New(0,v,n,t) #endif #ifndef Newxc # define Newxc(v,n,t,c) Newc(0,v,n,t,c) #endif #ifndef Newxz # define Newxz(v,n,t) Newz(0,v,n,t) #endif #ifndef PERL_UNUSED_DECL # ifdef HASATTRIBUTE # if (defined(__GNUC__) && defined(__cplusplus)) || defined(__INTEL_COMPILER) # define PERL_UNUSED_DECL # else # define PERL_UNUSED_DECL __attribute__((unused)) # endif # else # define PERL_UNUSED_DECL # endif #endif #ifndef PERL_UNUSED_ARG # if defined(lint) && defined(S_SPLINT_S) /* www.splint.org */ # include # define PERL_UNUSED_ARG(x) NOTE(ARGUNUSED(x)) # else # define PERL_UNUSED_ARG(x) ((void)x) # endif #endif #ifndef PERL_UNUSED_VAR # define PERL_UNUSED_VAR(x) ((void)x) #endif #ifndef PERL_UNUSED_CONTEXT # ifdef USE_ITHREADS # define PERL_UNUSED_CONTEXT PERL_UNUSED_ARG(my_perl) # else # define PERL_UNUSED_CONTEXT # endif #endif #ifndef NOOP # define NOOP /*EMPTY*/(void)0 #endif #ifndef dNOOP # define dNOOP extern int /*@unused@*/ Perl___notused PERL_UNUSED_DECL #endif #ifndef NVTYPE # if defined(USE_LONG_DOUBLE) && defined(HAS_LONG_DOUBLE) # define NVTYPE long double # else # define NVTYPE double # endif typedef NVTYPE NV; #endif #ifndef INT2PTR # if (IVSIZE == PTRSIZE) && (UVSIZE == PTRSIZE) # define PTRV UV # define INT2PTR(any,d) (any)(d) # else # if PTRSIZE == LONGSIZE # define PTRV unsigned long # else # define PTRV unsigned # endif # define INT2PTR(any,d) (any)(PTRV)(d) # endif # define NUM2PTR(any,d) (any)(PTRV)(d) # define PTR2IV(p) INT2PTR(IV,p) # define PTR2UV(p) INT2PTR(UV,p) # define PTR2NV(p) NUM2PTR(NV,p) # if PTRSIZE == LONGSIZE # define PTR2ul(p) (unsigned long)(p) # else # define PTR2ul(p) INT2PTR(unsigned long,p) # endif #endif /* !INT2PTR */ #undef START_EXTERN_C #undef END_EXTERN_C #undef EXTERN_C #ifdef __cplusplus # define START_EXTERN_C extern "C" { # define END_EXTERN_C } # define EXTERN_C extern "C" #else # define START_EXTERN_C # define END_EXTERN_C # define EXTERN_C extern #endif #if defined(PERL_GCC_PEDANTIC) # ifndef PERL_GCC_BRACE_GROUPS_FORBIDDEN # define PERL_GCC_BRACE_GROUPS_FORBIDDEN # endif #endif #if defined(__GNUC__) && !defined(PERL_GCC_BRACE_GROUPS_FORBIDDEN) && !defined(__cplusplus) # ifndef PERL_USE_GCC_BRACE_GROUPS # define PERL_USE_GCC_BRACE_GROUPS # endif #endif #undef STMT_START #undef STMT_END #ifdef PERL_USE_GCC_BRACE_GROUPS # define STMT_START (void)( /* gcc supports ``({ STATEMENTS; })'' */ # define STMT_END ) #else # if defined(VOIDFLAGS) && (VOIDFLAGS) && (defined(sun) || defined(__sun__)) && !defined(__GNUC__) # define STMT_START if (1) # define STMT_END else (void)0 # else # define STMT_START do # define STMT_END while (0) # endif #endif #ifndef boolSV # define boolSV(b) ((b) ? &PL_sv_yes : &PL_sv_no) #endif /* DEFSV appears first in 5.004_56 */ #ifndef DEFSV # define DEFSV GvSV(PL_defgv) #endif #ifndef SAVE_DEFSV # define SAVE_DEFSV SAVESPTR(GvSV(PL_defgv)) #endif /* Older perls (<=5.003) lack AvFILLp */ #ifndef AvFILLp # define AvFILLp AvFILL #endif #ifndef ERRSV # define ERRSV get_sv("@",FALSE) #endif #ifndef newSVpvn # define newSVpvn(data,len) ((data) \ ? ((len) ? newSVpv((data), (len)) : newSVpv("", 0)) \ : newSV(0)) #endif /* Hint: gv_stashpvn * This function's backport doesn't support the length parameter, but * rather ignores it. Portability can only be ensured if the length * parameter is used for speed reasons, but the length can always be * correctly computed from the string argument. */ #ifndef gv_stashpvn # define gv_stashpvn(str,len,create) gv_stashpv(str,create) #endif /* Replace: 1 */ #ifndef get_cv # define get_cv perl_get_cv #endif #ifndef get_sv # define get_sv perl_get_sv #endif #ifndef get_av # define get_av perl_get_av #endif #ifndef get_hv # define get_hv perl_get_hv #endif /* Replace: 0 */ #ifndef dUNDERBAR # define dUNDERBAR dNOOP #endif #ifndef UNDERBAR # define UNDERBAR DEFSV #endif #ifndef dAX # define dAX I32 ax = MARK - PL_stack_base + 1 #endif #ifndef dITEMS # define dITEMS I32 items = SP - MARK #endif #ifndef dXSTARG # define dXSTARG SV * targ = sv_newmortal() #endif #ifndef dAXMARK # define dAXMARK I32 ax = POPMARK; \ register SV ** const mark = PL_stack_base + ax++ #endif #ifndef XSprePUSH # define XSprePUSH (sp = PL_stack_base + ax - 1) #endif #if (PERL_BCDVERSION < 0x5005000) # undef XSRETURN # define XSRETURN(off) \ STMT_START { \ PL_stack_sp = PL_stack_base + ax + ((off) - 1); \ return; \ } STMT_END #endif #ifndef PERL_ABS # define PERL_ABS(x) ((x) < 0 ? -(x) : (x)) #endif #ifndef dVAR # define dVAR dNOOP #endif #ifndef SVf # define SVf "_" #endif #ifndef UTF8_MAXBYTES # define UTF8_MAXBYTES UTF8_MAXLEN #endif #ifndef PERL_HASH # define PERL_HASH(hash,str,len) \ STMT_START { \ const char *s_PeRlHaSh = str; \ I32 i_PeRlHaSh = len; \ U32 hash_PeRlHaSh = 0; \ while (i_PeRlHaSh--) \ hash_PeRlHaSh = hash_PeRlHaSh * 33 + *s_PeRlHaSh++; \ (hash) = hash_PeRlHaSh; \ } STMT_END #endif #ifndef PERL_SIGNALS_UNSAFE_FLAG #define PERL_SIGNALS_UNSAFE_FLAG 0x0001 #if (PERL_BCDVERSION < 0x5008000) # define D_PPP_PERL_SIGNALS_INIT PERL_SIGNALS_UNSAFE_FLAG #else # define D_PPP_PERL_SIGNALS_INIT 0 #endif #if defined(NEED_PL_signals) static U32 DPPP_(my_PL_signals) = D_PPP_PERL_SIGNALS_INIT; #elif defined(NEED_PL_signals_GLOBAL) U32 DPPP_(my_PL_signals) = D_PPP_PERL_SIGNALS_INIT; #else extern U32 DPPP_(my_PL_signals); #endif #define PL_signals DPPP_(my_PL_signals) #endif /* Hint: PL_ppaddr * Calling an op via PL_ppaddr requires passing a context argument * for threaded builds. Since the context argument is different for * 5.005 perls, you can use aTHXR (supplied by ppport.h), which will * automatically be defined as the correct argument. */ #if (PERL_BCDVERSION <= 0x5005005) /* Replace: 1 */ # define PL_ppaddr ppaddr # define PL_no_modify no_modify /* Replace: 0 */ #endif #if (PERL_BCDVERSION <= 0x5004005) /* Replace: 1 */ # define PL_DBsignal DBsignal # define PL_DBsingle DBsingle # define PL_DBsub DBsub # define PL_DBtrace DBtrace # define PL_Sv Sv # define PL_compiling compiling # define PL_copline copline # define PL_curcop curcop # define PL_curstash curstash # define PL_debstash debstash # define PL_defgv defgv # define PL_diehook diehook # define PL_dirty dirty # define PL_dowarn dowarn # define PL_errgv errgv # define PL_expect expect # define PL_hexdigit hexdigit # define PL_hints hints # define PL_laststatval laststatval # define PL_na na # define PL_perl_destruct_level perl_destruct_level # define PL_perldb perldb # define PL_rsfp_filters rsfp_filters # define PL_rsfp rsfp # define PL_stack_base stack_base # define PL_stack_sp stack_sp # define PL_statcache statcache # define PL_stdingv stdingv # define PL_sv_arenaroot sv_arenaroot # define PL_sv_no sv_no # define PL_sv_undef sv_undef # define PL_sv_yes sv_yes # define PL_tainted tainted # define PL_tainting tainting /* Replace: 0 */ #endif /* Warning: PL_expect, PL_copline, PL_rsfp, PL_rsfp_filters * Do not use this variable. It is internal to the perl parser * and may change or even be removed in the future. Note that * as of perl 5.9.5 you cannot assign to this variable anymore. */ /* TODO: cannot assign to these vars; is it worth fixing? */ #if (PERL_BCDVERSION >= 0x5009005) # define PL_expect (PL_parser ? PL_parser->expect : 0) # define PL_copline (PL_parser ? PL_parser->copline : 0) # define PL_rsfp (PL_parser ? PL_parser->rsfp : (PerlIO *) 0) # define PL_rsfp_filters (PL_parser ? PL_parser->rsfp_filters : (AV *) 0) #endif #ifndef dTHR # define dTHR dNOOP #endif #ifndef dTHX # define dTHX dNOOP #endif #ifndef dTHXa # define dTHXa(x) dNOOP #endif #ifndef pTHX # define pTHX void #endif #ifndef pTHX_ # define pTHX_ #endif #ifndef aTHX # define aTHX #endif #ifndef aTHX_ # define aTHX_ #endif #if (PERL_BCDVERSION < 0x5006000) # ifdef USE_THREADS # define aTHXR thr # define aTHXR_ thr, # else # define aTHXR # define aTHXR_ # endif # define dTHXR dTHR #else # define aTHXR aTHX # define aTHXR_ aTHX_ # define dTHXR dTHX #endif #ifndef dTHXoa # define dTHXoa(x) dTHXa(x) #endif #ifndef PUSHmortal # define PUSHmortal PUSHs(sv_newmortal()) #endif #ifndef mPUSHp # define mPUSHp(p,l) sv_setpvn_mg(PUSHmortal, (p), (l)) #endif #ifndef mPUSHn # define mPUSHn(n) sv_setnv_mg(PUSHmortal, (NV)(n)) #endif #ifndef mPUSHi # define mPUSHi(i) sv_setiv_mg(PUSHmortal, (IV)(i)) #endif #ifndef mPUSHu # define mPUSHu(u) sv_setuv_mg(PUSHmortal, (UV)(u)) #endif #ifndef XPUSHmortal # define XPUSHmortal XPUSHs(sv_newmortal()) #endif #ifndef mXPUSHp # define mXPUSHp(p,l) STMT_START { EXTEND(sp,1); sv_setpvn_mg(PUSHmortal, (p), (l)); } STMT_END #endif #ifndef mXPUSHn # define mXPUSHn(n) STMT_START { EXTEND(sp,1); sv_setnv_mg(PUSHmortal, (NV)(n)); } STMT_END #endif #ifndef mXPUSHi # define mXPUSHi(i) STMT_START { EXTEND(sp,1); sv_setiv_mg(PUSHmortal, (IV)(i)); } STMT_END #endif #ifndef mXPUSHu # define mXPUSHu(u) STMT_START { EXTEND(sp,1); sv_setuv_mg(PUSHmortal, (UV)(u)); } STMT_END #endif /* Replace: 1 */ #ifndef call_sv # define call_sv perl_call_sv #endif #ifndef call_pv # define call_pv perl_call_pv #endif #ifndef call_argv # define call_argv perl_call_argv #endif #ifndef call_method # define call_method perl_call_method #endif #ifndef eval_sv # define eval_sv perl_eval_sv #endif #ifndef PERL_LOADMOD_DENY # define PERL_LOADMOD_DENY 0x1 #endif #ifndef PERL_LOADMOD_NOIMPORT # define PERL_LOADMOD_NOIMPORT 0x2 #endif #ifndef PERL_LOADMOD_IMPORT_OPS # define PERL_LOADMOD_IMPORT_OPS 0x4 #endif /* Replace: 0 */ /* Replace perl_eval_pv with eval_pv */ #ifndef eval_pv #if defined(NEED_eval_pv) static SV* DPPP_(my_eval_pv)(char *p, I32 croak_on_error); static #else extern SV* DPPP_(my_eval_pv)(char *p, I32 croak_on_error); #endif #ifdef eval_pv # undef eval_pv #endif #define eval_pv(a,b) DPPP_(my_eval_pv)(aTHX_ a,b) #define Perl_eval_pv DPPP_(my_eval_pv) #if defined(NEED_eval_pv) || defined(NEED_eval_pv_GLOBAL) SV* DPPP_(my_eval_pv)(char *p, I32 croak_on_error) { dSP; SV* sv = newSVpv(p, 0); PUSHMARK(sp); eval_sv(sv, G_SCALAR); SvREFCNT_dec(sv); SPAGAIN; sv = POPs; PUTBACK; if (croak_on_error && SvTRUE(GvSV(errgv))) croak(SvPVx(GvSV(errgv), na)); return sv; } #endif #endif #ifndef vload_module #if defined(NEED_vload_module) static void DPPP_(my_vload_module)(U32 flags, SV *name, SV *ver, va_list *args); static #else extern void DPPP_(my_vload_module)(U32 flags, SV *name, SV *ver, va_list *args); #endif #ifdef vload_module # undef vload_module #endif #define vload_module(a,b,c,d) DPPP_(my_vload_module)(aTHX_ a,b,c,d) #define Perl_vload_module DPPP_(my_vload_module) #if defined(NEED_vload_module) || defined(NEED_vload_module_GLOBAL) void DPPP_(my_vload_module)(U32 flags, SV *name, SV *ver, va_list *args) { dTHR; dVAR; OP *veop, *imop; OP * const modname = newSVOP(OP_CONST, 0, name); /* 5.005 has a somewhat hacky force_normal that doesn't croak on SvREADONLY() if PL_compling is true. Current perls take care in ck_require() to correctly turn off SvREADONLY before calling force_normal_flags(). This seems a better fix than fudging PL_compling */ SvREADONLY_off(((SVOP*)modname)->op_sv); modname->op_private |= OPpCONST_BARE; if (ver) { veop = newSVOP(OP_CONST, 0, ver); } else veop = NULL; if (flags & PERL_LOADMOD_NOIMPORT) { imop = sawparens(newNULLLIST()); } else if (flags & PERL_LOADMOD_IMPORT_OPS) { imop = va_arg(*args, OP*); } else { SV *sv; imop = NULL; sv = va_arg(*args, SV*); while (sv) { imop = append_elem(OP_LIST, imop, newSVOP(OP_CONST, 0, sv)); sv = va_arg(*args, SV*); } } { const line_t ocopline = PL_copline; COP * const ocurcop = PL_curcop; const int oexpect = PL_expect; #if (PERL_BCDVERSION >= 0x5004000) utilize(!(flags & PERL_LOADMOD_DENY), start_subparse(FALSE, 0), veop, modname, imop); #else utilize(!(flags & PERL_LOADMOD_DENY), start_subparse(), modname, imop); #endif PL_expect = oexpect; PL_copline = ocopline; PL_curcop = ocurcop; } } #endif #endif #ifndef load_module #if defined(NEED_load_module) static void DPPP_(my_load_module)(U32 flags, SV *name, SV *ver, ...); static #else extern void DPPP_(my_load_module)(U32 flags, SV *name, SV *ver, ...); #endif #ifdef load_module # undef load_module #endif #define load_module DPPP_(my_load_module) #define Perl_load_module DPPP_(my_load_module) #if defined(NEED_load_module) || defined(NEED_load_module_GLOBAL) void DPPP_(my_load_module)(U32 flags, SV *name, SV *ver, ...) { va_list args; va_start(args, ver); vload_module(flags, name, ver, &args); va_end(args); } #endif #endif #ifndef newRV_inc # define newRV_inc(sv) newRV(sv) /* Replace */ #endif #ifndef newRV_noinc #if defined(NEED_newRV_noinc) static SV * DPPP_(my_newRV_noinc)(SV *sv); static #else extern SV * DPPP_(my_newRV_noinc)(SV *sv); #endif #ifdef newRV_noinc # undef newRV_noinc #endif #define newRV_noinc(a) DPPP_(my_newRV_noinc)(aTHX_ a) #define Perl_newRV_noinc DPPP_(my_newRV_noinc) #if defined(NEED_newRV_noinc) || defined(NEED_newRV_noinc_GLOBAL) SV * DPPP_(my_newRV_noinc)(SV *sv) { SV *rv = (SV *)newRV(sv); SvREFCNT_dec(sv); return rv; } #endif #endif /* Hint: newCONSTSUB * Returns a CV* as of perl-5.7.1. This return value is not supported * by Devel::PPPort. */ /* newCONSTSUB from IO.xs is in the core starting with 5.004_63 */ #if (PERL_BCDVERSION < 0x5004063) && (PERL_BCDVERSION != 0x5004005) #if defined(NEED_newCONSTSUB) static void DPPP_(my_newCONSTSUB)(HV *stash, const char *name, SV *sv); static #else extern void DPPP_(my_newCONSTSUB)(HV *stash, const char *name, SV *sv); #endif #ifdef newCONSTSUB # undef newCONSTSUB #endif #define newCONSTSUB(a,b,c) DPPP_(my_newCONSTSUB)(aTHX_ a,b,c) #define Perl_newCONSTSUB DPPP_(my_newCONSTSUB) #if defined(NEED_newCONSTSUB) || defined(NEED_newCONSTSUB_GLOBAL) void DPPP_(my_newCONSTSUB)(HV *stash, const char *name, SV *sv) { U32 oldhints = PL_hints; HV *old_cop_stash = PL_curcop->cop_stash; HV *old_curstash = PL_curstash; line_t oldline = PL_curcop->cop_line; PL_curcop->cop_line = PL_copline; PL_hints &= ~HINT_BLOCK_SCOPE; if (stash) PL_curstash = PL_curcop->cop_stash = stash; newSUB( #if (PERL_BCDVERSION < 0x5003022) start_subparse(), #elif (PERL_BCDVERSION == 0x5003022) start_subparse(0), #else /* 5.003_23 onwards */ start_subparse(FALSE, 0), #endif newSVOP(OP_CONST, 0, newSVpv((char *) name, 0)), newSVOP(OP_CONST, 0, &PL_sv_no), /* SvPV(&PL_sv_no) == "" -- GMB */ newSTATEOP(0, Nullch, newSVOP(OP_CONST, 0, sv)) ); PL_hints = oldhints; PL_curcop->cop_stash = old_cop_stash; PL_curstash = old_curstash; PL_curcop->cop_line = oldline; } #endif #endif /* * Boilerplate macros for initializing and accessing interpreter-local * data from C. All statics in extensions should be reworked to use * this, if you want to make the extension thread-safe. See ext/re/re.xs * for an example of the use of these macros. * * Code that uses these macros is responsible for the following: * 1. #define MY_CXT_KEY to a unique string, e.g. "DynaLoader_guts" * 2. Declare a typedef named my_cxt_t that is a structure that contains * all the data that needs to be interpreter-local. * 3. Use the START_MY_CXT macro after the declaration of my_cxt_t. * 4. Use the MY_CXT_INIT macro such that it is called exactly once * (typically put in the BOOT: section). * 5. Use the members of the my_cxt_t structure everywhere as * MY_CXT.member. * 6. Use the dMY_CXT macro (a declaration) in all the functions that * access MY_CXT. */ #if defined(MULTIPLICITY) || defined(PERL_OBJECT) || \ defined(PERL_CAPI) || defined(PERL_IMPLICIT_CONTEXT) #ifndef START_MY_CXT /* This must appear in all extensions that define a my_cxt_t structure, * right after the definition (i.e. at file scope). The non-threads * case below uses it to declare the data as static. */ #define START_MY_CXT #if (PERL_BCDVERSION < 0x5004068) /* Fetches the SV that keeps the per-interpreter data. */ #define dMY_CXT_SV \ SV *my_cxt_sv = get_sv(MY_CXT_KEY, FALSE) #else /* >= perl5.004_68 */ #define dMY_CXT_SV \ SV *my_cxt_sv = *hv_fetch(PL_modglobal, MY_CXT_KEY, \ sizeof(MY_CXT_KEY)-1, TRUE) #endif /* < perl5.004_68 */ /* This declaration should be used within all functions that use the * interpreter-local data. */ #define dMY_CXT \ dMY_CXT_SV; \ my_cxt_t *my_cxtp = INT2PTR(my_cxt_t*,SvUV(my_cxt_sv)) /* Creates and zeroes the per-interpreter data. * (We allocate my_cxtp in a Perl SV so that it will be released when * the interpreter goes away.) */ #define MY_CXT_INIT \ dMY_CXT_SV; \ /* newSV() allocates one more than needed */ \ my_cxt_t *my_cxtp = (my_cxt_t*)SvPVX(newSV(sizeof(my_cxt_t)-1));\ Zero(my_cxtp, 1, my_cxt_t); \ sv_setuv(my_cxt_sv, PTR2UV(my_cxtp)) /* This macro must be used to access members of the my_cxt_t structure. * e.g. MYCXT.some_data */ #define MY_CXT (*my_cxtp) /* Judicious use of these macros can reduce the number of times dMY_CXT * is used. Use is similar to pTHX, aTHX etc. */ #define pMY_CXT my_cxt_t *my_cxtp #define pMY_CXT_ pMY_CXT, #define _pMY_CXT ,pMY_CXT #define aMY_CXT my_cxtp #define aMY_CXT_ aMY_CXT, #define _aMY_CXT ,aMY_CXT #endif /* START_MY_CXT */ #ifndef MY_CXT_CLONE /* Clones the per-interpreter data. */ #define MY_CXT_CLONE \ dMY_CXT_SV; \ my_cxt_t *my_cxtp = (my_cxt_t*)SvPVX(newSV(sizeof(my_cxt_t)-1));\ Copy(INT2PTR(my_cxt_t*, SvUV(my_cxt_sv)), my_cxtp, 1, my_cxt_t);\ sv_setuv(my_cxt_sv, PTR2UV(my_cxtp)) #endif #else /* single interpreter */ #ifndef START_MY_CXT #define START_MY_CXT static my_cxt_t my_cxt; #define dMY_CXT_SV dNOOP #define dMY_CXT dNOOP #define MY_CXT_INIT NOOP #define MY_CXT my_cxt #define pMY_CXT void #define pMY_CXT_ #define _pMY_CXT #define aMY_CXT #define aMY_CXT_ #define _aMY_CXT #endif /* START_MY_CXT */ #ifndef MY_CXT_CLONE #define MY_CXT_CLONE NOOP #endif #endif #ifndef IVdf # if IVSIZE == LONGSIZE # define IVdf "ld" # define UVuf "lu" # define UVof "lo" # define UVxf "lx" # define UVXf "lX" # else # if IVSIZE == INTSIZE # define IVdf "d" # define UVuf "u" # define UVof "o" # define UVxf "x" # define UVXf "X" # endif # endif #endif #ifndef NVef # if defined(USE_LONG_DOUBLE) && defined(HAS_LONG_DOUBLE) && \ defined(PERL_PRIfldbl) /* Not very likely, but let's try anyway. */ # define NVef PERL_PRIeldbl # define NVff PERL_PRIfldbl # define NVgf PERL_PRIgldbl # else # define NVef "e" # define NVff "f" # define NVgf "g" # endif #endif #ifndef SvREFCNT_inc # ifdef PERL_USE_GCC_BRACE_GROUPS # define SvREFCNT_inc(sv) \ ({ \ SV * const _sv = (SV*)(sv); \ if (_sv) \ (SvREFCNT(_sv))++; \ _sv; \ }) # else # define SvREFCNT_inc(sv) \ ((PL_Sv=(SV*)(sv)) ? (++(SvREFCNT(PL_Sv)),PL_Sv) : NULL) # endif #endif #ifndef SvREFCNT_inc_simple # ifdef PERL_USE_GCC_BRACE_GROUPS # define SvREFCNT_inc_simple(sv) \ ({ \ if (sv) \ (SvREFCNT(sv))++; \ (SV *)(sv); \ }) # else # define SvREFCNT_inc_simple(sv) \ ((sv) ? (SvREFCNT(sv)++,(SV*)(sv)) : NULL) # endif #endif #ifndef SvREFCNT_inc_NN # ifdef PERL_USE_GCC_BRACE_GROUPS # define SvREFCNT_inc_NN(sv) \ ({ \ SV * const _sv = (SV*)(sv); \ SvREFCNT(_sv)++; \ _sv; \ }) # else # define SvREFCNT_inc_NN(sv) \ (PL_Sv=(SV*)(sv),++(SvREFCNT(PL_Sv)),PL_Sv) # endif #endif #ifndef SvREFCNT_inc_void # ifdef PERL_USE_GCC_BRACE_GROUPS # define SvREFCNT_inc_void(sv) \ ({ \ SV * const _sv = (SV*)(sv); \ if (_sv) \ (void)(SvREFCNT(_sv)++); \ }) # else # define SvREFCNT_inc_void(sv) \ (void)((PL_Sv=(SV*)(sv)) ? ++(SvREFCNT(PL_Sv)) : 0) # endif #endif #ifndef SvREFCNT_inc_simple_void # define SvREFCNT_inc_simple_void(sv) STMT_START { if (sv) SvREFCNT(sv)++; } STMT_END #endif #ifndef SvREFCNT_inc_simple_NN # define SvREFCNT_inc_simple_NN(sv) (++SvREFCNT(sv), (SV*)(sv)) #endif #ifndef SvREFCNT_inc_void_NN # define SvREFCNT_inc_void_NN(sv) (void)(++SvREFCNT((SV*)(sv))) #endif #ifndef SvREFCNT_inc_simple_void_NN # define SvREFCNT_inc_simple_void_NN(sv) (void)(++SvREFCNT((SV*)(sv))) #endif /* Backwards compatibility stuff... :-( */ #if !defined(NEED_sv_2pv_flags) && defined(NEED_sv_2pv_nolen) # define NEED_sv_2pv_flags #endif #if !defined(NEED_sv_2pv_flags_GLOBAL) && defined(NEED_sv_2pv_nolen_GLOBAL) # define NEED_sv_2pv_flags_GLOBAL #endif /* Hint: sv_2pv_nolen * Use the SvPV_nolen() or SvPV_nolen_const() macros instead of sv_2pv_nolen(). */ #ifndef sv_2pv_nolen # define sv_2pv_nolen(sv) SvPV_nolen(sv) #endif #ifdef SvPVbyte /* Hint: SvPVbyte * Does not work in perl-5.6.1, ppport.h implements a version * borrowed from perl-5.7.3. */ #if (PERL_BCDVERSION < 0x5007000) #if defined(NEED_sv_2pvbyte) static char * DPPP_(my_sv_2pvbyte)(pTHX_ SV * sv, STRLEN * lp); static #else extern char * DPPP_(my_sv_2pvbyte)(pTHX_ SV * sv, STRLEN * lp); #endif #ifdef sv_2pvbyte # undef sv_2pvbyte #endif #define sv_2pvbyte(a,b) DPPP_(my_sv_2pvbyte)(aTHX_ a,b) #define Perl_sv_2pvbyte DPPP_(my_sv_2pvbyte) #if defined(NEED_sv_2pvbyte) || defined(NEED_sv_2pvbyte_GLOBAL) char * DPPP_(my_sv_2pvbyte)(pTHX_ SV *sv, STRLEN *lp) { sv_utf8_downgrade(sv,0); return SvPV(sv,*lp); } #endif /* Hint: sv_2pvbyte * Use the SvPVbyte() macro instead of sv_2pvbyte(). */ #undef SvPVbyte #define SvPVbyte(sv, lp) \ ((SvFLAGS(sv) & (SVf_POK|SVf_UTF8)) == (SVf_POK) \ ? ((lp = SvCUR(sv)), SvPVX(sv)) : sv_2pvbyte(sv, &lp)) #endif #else # define SvPVbyte SvPV # define sv_2pvbyte sv_2pv #endif #ifndef sv_2pvbyte_nolen # define sv_2pvbyte_nolen(sv) sv_2pv_nolen(sv) #endif /* Hint: sv_pvn * Always use the SvPV() macro instead of sv_pvn(). */ /* Hint: sv_pvn_force * Always use the SvPV_force() macro instead of sv_pvn_force(). */ /* If these are undefined, they're not handled by the core anyway */ #ifndef SV_IMMEDIATE_UNREF # define SV_IMMEDIATE_UNREF 0 #endif #ifndef SV_GMAGIC # define SV_GMAGIC 0 #endif #ifndef SV_COW_DROP_PV # define SV_COW_DROP_PV 0 #endif #ifndef SV_UTF8_NO_ENCODING # define SV_UTF8_NO_ENCODING 0 #endif #ifndef SV_NOSTEAL # define SV_NOSTEAL 0 #endif #ifndef SV_CONST_RETURN # define SV_CONST_RETURN 0 #endif #ifndef SV_MUTABLE_RETURN # define SV_MUTABLE_RETURN 0 #endif #ifndef SV_SMAGIC # define SV_SMAGIC 0 #endif #ifndef SV_HAS_TRAILING_NUL # define SV_HAS_TRAILING_NUL 0 #endif #ifndef SV_COW_SHARED_HASH_KEYS # define SV_COW_SHARED_HASH_KEYS 0 #endif #if (PERL_BCDVERSION < 0x5007002) #if defined(NEED_sv_2pv_flags) static char * DPPP_(my_sv_2pv_flags)(pTHX_ SV * sv, STRLEN * lp, I32 flags); static #else extern char * DPPP_(my_sv_2pv_flags)(pTHX_ SV * sv, STRLEN * lp, I32 flags); #endif #ifdef sv_2pv_flags # undef sv_2pv_flags #endif #define sv_2pv_flags(a,b,c) DPPP_(my_sv_2pv_flags)(aTHX_ a,b,c) #define Perl_sv_2pv_flags DPPP_(my_sv_2pv_flags) #if defined(NEED_sv_2pv_flags) || defined(NEED_sv_2pv_flags_GLOBAL) char * DPPP_(my_sv_2pv_flags)(pTHX_ SV *sv, STRLEN *lp, I32 flags) { STRLEN n_a = (STRLEN) flags; return sv_2pv(sv, lp ? lp : &n_a); } #endif #if defined(NEED_sv_pvn_force_flags) static char * DPPP_(my_sv_pvn_force_flags)(pTHX_ SV * sv, STRLEN * lp, I32 flags); static #else extern char * DPPP_(my_sv_pvn_force_flags)(pTHX_ SV * sv, STRLEN * lp, I32 flags); #endif #ifdef sv_pvn_force_flags # undef sv_pvn_force_flags #endif #define sv_pvn_force_flags(a,b,c) DPPP_(my_sv_pvn_force_flags)(aTHX_ a,b,c) #define Perl_sv_pvn_force_flags DPPP_(my_sv_pvn_force_flags) #if defined(NEED_sv_pvn_force_flags) || defined(NEED_sv_pvn_force_flags_GLOBAL) char * DPPP_(my_sv_pvn_force_flags)(pTHX_ SV *sv, STRLEN *lp, I32 flags) { STRLEN n_a = (STRLEN) flags; return sv_pvn_force(sv, lp ? lp : &n_a); } #endif #endif #ifndef SvPV_const # define SvPV_const(sv, lp) SvPV_flags_const(sv, lp, SV_GMAGIC) #endif #ifndef SvPV_mutable # define SvPV_mutable(sv, lp) SvPV_flags_mutable(sv, lp, SV_GMAGIC) #endif #ifndef SvPV_flags # define SvPV_flags(sv, lp, flags) \ ((SvFLAGS(sv) & (SVf_POK)) == SVf_POK \ ? ((lp = SvCUR(sv)), SvPVX(sv)) : sv_2pv_flags(sv, &lp, flags)) #endif #ifndef SvPV_flags_const # define SvPV_flags_const(sv, lp, flags) \ ((SvFLAGS(sv) & (SVf_POK)) == SVf_POK \ ? ((lp = SvCUR(sv)), SvPVX_const(sv)) : \ (const char*) sv_2pv_flags(sv, &lp, flags|SV_CONST_RETURN)) #endif #ifndef SvPV_flags_const_nolen # define SvPV_flags_const_nolen(sv, flags) \ ((SvFLAGS(sv) & (SVf_POK)) == SVf_POK \ ? SvPVX_const(sv) : \ (const char*) sv_2pv_flags(sv, 0, flags|SV_CONST_RETURN)) #endif #ifndef SvPV_flags_mutable # define SvPV_flags_mutable(sv, lp, flags) \ ((SvFLAGS(sv) & (SVf_POK)) == SVf_POK \ ? ((lp = SvCUR(sv)), SvPVX_mutable(sv)) : \ sv_2pv_flags(sv, &lp, flags|SV_MUTABLE_RETURN)) #endif #ifndef SvPV_force # define SvPV_force(sv, lp) SvPV_force_flags(sv, lp, SV_GMAGIC) #endif #ifndef SvPV_force_nolen # define SvPV_force_nolen(sv) SvPV_force_flags_nolen(sv, SV_GMAGIC) #endif #ifndef SvPV_force_mutable # define SvPV_force_mutable(sv, lp) SvPV_force_flags_mutable(sv, lp, SV_GMAGIC) #endif #ifndef SvPV_force_nomg # define SvPV_force_nomg(sv, lp) SvPV_force_flags(sv, lp, 0) #endif #ifndef SvPV_force_nomg_nolen # define SvPV_force_nomg_nolen(sv) SvPV_force_flags_nolen(sv, 0) #endif #ifndef SvPV_force_flags # define SvPV_force_flags(sv, lp, flags) \ ((SvFLAGS(sv) & (SVf_POK|SVf_THINKFIRST)) == SVf_POK \ ? ((lp = SvCUR(sv)), SvPVX(sv)) : sv_pvn_force_flags(sv, &lp, flags)) #endif #ifndef SvPV_force_flags_nolen # define SvPV_force_flags_nolen(sv, flags) \ ((SvFLAGS(sv) & (SVf_POK|SVf_THINKFIRST)) == SVf_POK \ ? SvPVX(sv) : sv_pvn_force_flags(sv, 0, flags)) #endif #ifndef SvPV_force_flags_mutable # define SvPV_force_flags_mutable(sv, lp, flags) \ ((SvFLAGS(sv) & (SVf_POK|SVf_THINKFIRST)) == SVf_POK \ ? ((lp = SvCUR(sv)), SvPVX_mutable(sv)) \ : sv_pvn_force_flags(sv, &lp, flags|SV_MUTABLE_RETURN)) #endif #ifndef SvPV_nolen # define SvPV_nolen(sv) \ ((SvFLAGS(sv) & (SVf_POK)) == SVf_POK \ ? SvPVX(sv) : sv_2pv_flags(sv, 0, SV_GMAGIC)) #endif #ifndef SvPV_nolen_const # define SvPV_nolen_const(sv) \ ((SvFLAGS(sv) & (SVf_POK)) == SVf_POK \ ? SvPVX_const(sv) : sv_2pv_flags(sv, 0, SV_GMAGIC|SV_CONST_RETURN)) #endif #ifndef SvPV_nomg # define SvPV_nomg(sv, lp) SvPV_flags(sv, lp, 0) #endif #ifndef SvPV_nomg_const # define SvPV_nomg_const(sv, lp) SvPV_flags_const(sv, lp, 0) #endif #ifndef SvPV_nomg_const_nolen # define SvPV_nomg_const_nolen(sv) SvPV_flags_const_nolen(sv, 0) #endif #ifndef SvMAGIC_set # define SvMAGIC_set(sv, val) \ STMT_START { assert(SvTYPE(sv) >= SVt_PVMG); \ (((XPVMG*) SvANY(sv))->xmg_magic = (val)); } STMT_END #endif #if (PERL_BCDVERSION < 0x5009003) #ifndef SvPVX_const # define SvPVX_const(sv) ((const char*) (0 + SvPVX(sv))) #endif #ifndef SvPVX_mutable # define SvPVX_mutable(sv) (0 + SvPVX(sv)) #endif #ifndef SvRV_set # define SvRV_set(sv, val) \ STMT_START { assert(SvTYPE(sv) >= SVt_RV); \ (((XRV*) SvANY(sv))->xrv_rv = (val)); } STMT_END #endif #else #ifndef SvPVX_const # define SvPVX_const(sv) ((const char*)((sv)->sv_u.svu_pv)) #endif #ifndef SvPVX_mutable # define SvPVX_mutable(sv) ((sv)->sv_u.svu_pv) #endif #ifndef SvRV_set # define SvRV_set(sv, val) \ STMT_START { assert(SvTYPE(sv) >= SVt_RV); \ ((sv)->sv_u.svu_rv = (val)); } STMT_END #endif #endif #ifndef SvSTASH_set # define SvSTASH_set(sv, val) \ STMT_START { assert(SvTYPE(sv) >= SVt_PVMG); \ (((XPVMG*) SvANY(sv))->xmg_stash = (val)); } STMT_END #endif #if (PERL_BCDVERSION < 0x5004000) #ifndef SvUV_set # define SvUV_set(sv, val) \ STMT_START { assert(SvTYPE(sv) == SVt_IV || SvTYPE(sv) >= SVt_PVIV); \ (((XPVIV*) SvANY(sv))->xiv_iv = (IV) (val)); } STMT_END #endif #else #ifndef SvUV_set # define SvUV_set(sv, val) \ STMT_START { assert(SvTYPE(sv) == SVt_IV || SvTYPE(sv) >= SVt_PVIV); \ (((XPVUV*) SvANY(sv))->xuv_uv = (val)); } STMT_END #endif #endif #if (PERL_BCDVERSION >= 0x5004000) && !defined(vnewSVpvf) #if defined(NEED_vnewSVpvf) static SV * DPPP_(my_vnewSVpvf)(pTHX_ const char * pat, va_list * args); static #else extern SV * DPPP_(my_vnewSVpvf)(pTHX_ const char * pat, va_list * args); #endif #ifdef vnewSVpvf # undef vnewSVpvf #endif #define vnewSVpvf(a,b) DPPP_(my_vnewSVpvf)(aTHX_ a,b) #define Perl_vnewSVpvf DPPP_(my_vnewSVpvf) #if defined(NEED_vnewSVpvf) || defined(NEED_vnewSVpvf_GLOBAL) SV * DPPP_(my_vnewSVpvf)(pTHX_ const char *pat, va_list *args) { register SV *sv = newSV(0); sv_vsetpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*)); return sv; } #endif #endif #if (PERL_BCDVERSION >= 0x5004000) && !defined(sv_vcatpvf) # define sv_vcatpvf(sv, pat, args) sv_vcatpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*)) #endif #if (PERL_BCDVERSION >= 0x5004000) && !defined(sv_vsetpvf) # define sv_vsetpvf(sv, pat, args) sv_vsetpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*)) #endif #if (PERL_BCDVERSION >= 0x5004000) && !defined(sv_catpvf_mg) #if defined(NEED_sv_catpvf_mg) static void DPPP_(my_sv_catpvf_mg)(pTHX_ SV * sv, const char * pat, ...); static #else extern void DPPP_(my_sv_catpvf_mg)(pTHX_ SV * sv, const char * pat, ...); #endif #define Perl_sv_catpvf_mg DPPP_(my_sv_catpvf_mg) #if defined(NEED_sv_catpvf_mg) || defined(NEED_sv_catpvf_mg_GLOBAL) void DPPP_(my_sv_catpvf_mg)(pTHX_ SV *sv, const char *pat, ...) { va_list args; va_start(args, pat); sv_vcatpvfn(sv, pat, strlen(pat), &args, Null(SV**), 0, Null(bool*)); SvSETMAGIC(sv); va_end(args); } #endif #endif #ifdef PERL_IMPLICIT_CONTEXT #if (PERL_BCDVERSION >= 0x5004000) && !defined(sv_catpvf_mg_nocontext) #if defined(NEED_sv_catpvf_mg_nocontext) static void DPPP_(my_sv_catpvf_mg_nocontext)(SV * sv, const char * pat, ...); static #else extern void DPPP_(my_sv_catpvf_mg_nocontext)(SV * sv, const char * pat, ...); #endif #define sv_catpvf_mg_nocontext DPPP_(my_sv_catpvf_mg_nocontext) #define Perl_sv_catpvf_mg_nocontext DPPP_(my_sv_catpvf_mg_nocontext) #if defined(NEED_sv_catpvf_mg_nocontext) || defined(NEED_sv_catpvf_mg_nocontext_GLOBAL) void DPPP_(my_sv_catpvf_mg_nocontext)(SV *sv, const char *pat, ...) { dTHX; va_list args; va_start(args, pat); sv_vcatpvfn(sv, pat, strlen(pat), &args, Null(SV**), 0, Null(bool*)); SvSETMAGIC(sv); va_end(args); } #endif #endif #endif /* sv_catpvf_mg depends on sv_catpvf_mg_nocontext */ #ifndef sv_catpvf_mg # ifdef PERL_IMPLICIT_CONTEXT # define sv_catpvf_mg Perl_sv_catpvf_mg_nocontext # else # define sv_catpvf_mg Perl_sv_catpvf_mg # endif #endif #if (PERL_BCDVERSION >= 0x5004000) && !defined(sv_vcatpvf_mg) # define sv_vcatpvf_mg(sv, pat, args) \ STMT_START { \ sv_vcatpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*)); \ SvSETMAGIC(sv); \ } STMT_END #endif #if (PERL_BCDVERSION >= 0x5004000) && !defined(sv_setpvf_mg) #if defined(NEED_sv_setpvf_mg) static void DPPP_(my_sv_setpvf_mg)(pTHX_ SV * sv, const char * pat, ...); static #else extern void DPPP_(my_sv_setpvf_mg)(pTHX_ SV * sv, const char * pat, ...); #endif #define Perl_sv_setpvf_mg DPPP_(my_sv_setpvf_mg) #if defined(NEED_sv_setpvf_mg) || defined(NEED_sv_setpvf_mg_GLOBAL) void DPPP_(my_sv_setpvf_mg)(pTHX_ SV *sv, const char *pat, ...) { va_list args; va_start(args, pat); sv_vsetpvfn(sv, pat, strlen(pat), &args, Null(SV**), 0, Null(bool*)); SvSETMAGIC(sv); va_end(args); } #endif #endif #ifdef PERL_IMPLICIT_CONTEXT #if (PERL_BCDVERSION >= 0x5004000) && !defined(sv_setpvf_mg_nocontext) #if defined(NEED_sv_setpvf_mg_nocontext) static void DPPP_(my_sv_setpvf_mg_nocontext)(SV * sv, const char * pat, ...); static #else extern void DPPP_(my_sv_setpvf_mg_nocontext)(SV * sv, const char * pat, ...); #endif #define sv_setpvf_mg_nocontext DPPP_(my_sv_setpvf_mg_nocontext) #define Perl_sv_setpvf_mg_nocontext DPPP_(my_sv_setpvf_mg_nocontext) #if defined(NEED_sv_setpvf_mg_nocontext) || defined(NEED_sv_setpvf_mg_nocontext_GLOBAL) void DPPP_(my_sv_setpvf_mg_nocontext)(SV *sv, const char *pat, ...) { dTHX; va_list args; va_start(args, pat); sv_vsetpvfn(sv, pat, strlen(pat), &args, Null(SV**), 0, Null(bool*)); SvSETMAGIC(sv); va_end(args); } #endif #endif #endif /* sv_setpvf_mg depends on sv_setpvf_mg_nocontext */ #ifndef sv_setpvf_mg # ifdef PERL_IMPLICIT_CONTEXT # define sv_setpvf_mg Perl_sv_setpvf_mg_nocontext # else # define sv_setpvf_mg Perl_sv_setpvf_mg # endif #endif #if (PERL_BCDVERSION >= 0x5004000) && !defined(sv_vsetpvf_mg) # define sv_vsetpvf_mg(sv, pat, args) \ STMT_START { \ sv_vsetpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*)); \ SvSETMAGIC(sv); \ } STMT_END #endif #ifndef newSVpvn_share #if defined(NEED_newSVpvn_share) static SV * DPPP_(my_newSVpvn_share)(pTHX_ const char *src, I32 len, U32 hash); static #else extern SV * DPPP_(my_newSVpvn_share)(pTHX_ const char *src, I32 len, U32 hash); #endif #ifdef newSVpvn_share # undef newSVpvn_share #endif #define newSVpvn_share(a,b,c) DPPP_(my_newSVpvn_share)(aTHX_ a,b,c) #define Perl_newSVpvn_share DPPP_(my_newSVpvn_share) #if defined(NEED_newSVpvn_share) || defined(NEED_newSVpvn_share_GLOBAL) SV * DPPP_(my_newSVpvn_share)(pTHX_ const char *src, I32 len, U32 hash) { SV *sv; if (len < 0) len = -len; if (!hash) PERL_HASH(hash, (char*) src, len); sv = newSVpvn((char *) src, len); sv_upgrade(sv, SVt_PVIV); SvIVX(sv) = hash; SvREADONLY_on(sv); SvPOK_on(sv); return sv; } #endif #endif #ifndef SvSHARED_HASH # define SvSHARED_HASH(sv) (0 + SvUVX(sv)) #endif #ifndef WARN_ALL # define WARN_ALL 0 #endif #ifndef WARN_CLOSURE # define WARN_CLOSURE 1 #endif #ifndef WARN_DEPRECATED # define WARN_DEPRECATED 2 #endif #ifndef WARN_EXITING # define WARN_EXITING 3 #endif #ifndef WARN_GLOB # define WARN_GLOB 4 #endif #ifndef WARN_IO # define WARN_IO 5 #endif #ifndef WARN_CLOSED # define WARN_CLOSED 6 #endif #ifndef WARN_EXEC # define WARN_EXEC 7 #endif #ifndef WARN_LAYER # define WARN_LAYER 8 #endif #ifndef WARN_NEWLINE # define WARN_NEWLINE 9 #endif #ifndef WARN_PIPE # define WARN_PIPE 10 #endif #ifndef WARN_UNOPENED # define WARN_UNOPENED 11 #endif #ifndef WARN_MISC # define WARN_MISC 12 #endif #ifndef WARN_NUMERIC # define WARN_NUMERIC 13 #endif #ifndef WARN_ONCE # define WARN_ONCE 14 #endif #ifndef WARN_OVERFLOW # define WARN_OVERFLOW 15 #endif #ifndef WARN_PACK # define WARN_PACK 16 #endif #ifndef WARN_PORTABLE # define WARN_PORTABLE 17 #endif #ifndef WARN_RECURSION # define WARN_RECURSION 18 #endif #ifndef WARN_REDEFINE # define WARN_REDEFINE 19 #endif #ifndef WARN_REGEXP # define WARN_REGEXP 20 #endif #ifndef WARN_SEVERE # define WARN_SEVERE 21 #endif #ifndef WARN_DEBUGGING # define WARN_DEBUGGING 22 #endif #ifndef WARN_INPLACE # define WARN_INPLACE 23 #endif #ifndef WARN_INTERNAL # define WARN_INTERNAL 24 #endif #ifndef WARN_MALLOC # define WARN_MALLOC 25 #endif #ifndef WARN_SIGNAL # define WARN_SIGNAL 26 #endif #ifndef WARN_SUBSTR # define WARN_SUBSTR 27 #endif #ifndef WARN_SYNTAX # define WARN_SYNTAX 28 #endif #ifndef WARN_AMBIGUOUS # define WARN_AMBIGUOUS 29 #endif #ifndef WARN_BAREWORD # define WARN_BAREWORD 30 #endif #ifndef WARN_DIGIT # define WARN_DIGIT 31 #endif #ifndef WARN_PARENTHESIS # define WARN_PARENTHESIS 32 #endif #ifndef WARN_PRECEDENCE # define WARN_PRECEDENCE 33 #endif #ifndef WARN_PRINTF # define WARN_PRINTF 34 #endif #ifndef WARN_PROTOTYPE # define WARN_PROTOTYPE 35 #endif #ifndef WARN_QW # define WARN_QW 36 #endif #ifndef WARN_RESERVED # define WARN_RESERVED 37 #endif #ifndef WARN_SEMICOLON # define WARN_SEMICOLON 38 #endif #ifndef WARN_TAINT # define WARN_TAINT 39 #endif #ifndef WARN_THREADS # define WARN_THREADS 40 #endif #ifndef WARN_UNINITIALIZED # define WARN_UNINITIALIZED 41 #endif #ifndef WARN_UNPACK # define WARN_UNPACK 42 #endif #ifndef WARN_UNTIE # define WARN_UNTIE 43 #endif #ifndef WARN_UTF8 # define WARN_UTF8 44 #endif #ifndef WARN_VOID # define WARN_VOID 45 #endif #ifndef WARN_ASSERTIONS # define WARN_ASSERTIONS 46 #endif #ifndef packWARN # define packWARN(a) (a) #endif #ifndef ckWARN # ifdef G_WARN_ON # define ckWARN(a) (PL_dowarn & G_WARN_ON) # else # define ckWARN(a) PL_dowarn # endif #endif #if (PERL_BCDVERSION >= 0x5004000) && !defined(warner) #if defined(NEED_warner) static void DPPP_(my_warner)(U32 err, const char *pat, ...); static #else extern void DPPP_(my_warner)(U32 err, const char *pat, ...); #endif #define Perl_warner DPPP_(my_warner) #if defined(NEED_warner) || defined(NEED_warner_GLOBAL) void DPPP_(my_warner)(U32 err, const char *pat, ...) { SV *sv; va_list args; PERL_UNUSED_ARG(err); va_start(args, pat); sv = vnewSVpvf(pat, &args); va_end(args); sv_2mortal(sv); warn("%s", SvPV_nolen(sv)); } #define warner Perl_warner #define Perl_warner_nocontext Perl_warner #endif #endif /* concatenating with "" ensures that only literal strings are accepted as argument * note that STR_WITH_LEN() can't be used as argument to macros or functions that * under some configurations might be macros */ #ifndef STR_WITH_LEN # define STR_WITH_LEN(s) (s ""), (sizeof(s)-1) #endif #ifndef newSVpvs # define newSVpvs(str) newSVpvn(str "", sizeof(str) - 1) #endif #ifndef sv_catpvs # define sv_catpvs(sv, str) sv_catpvn(sv, str "", sizeof(str) - 1) #endif #ifndef sv_setpvs # define sv_setpvs(sv, str) sv_setpvn(sv, str "", sizeof(str) - 1) #endif #ifndef hv_fetchs # define hv_fetchs(hv, key, lval) hv_fetch(hv, key "", sizeof(key) - 1, lval) #endif #ifndef hv_stores # define hv_stores(hv, key, val) hv_store(hv, key "", sizeof(key) - 1, val, 0) #endif #ifndef SvGETMAGIC # define SvGETMAGIC(x) STMT_START { if (SvGMAGICAL(x)) mg_get(x); } STMT_END #endif #ifndef PERL_MAGIC_sv # define PERL_MAGIC_sv '\0' #endif #ifndef PERL_MAGIC_overload # define PERL_MAGIC_overload 'A' #endif #ifndef PERL_MAGIC_overload_elem # define PERL_MAGIC_overload_elem 'a' #endif #ifndef PERL_MAGIC_overload_table # define PERL_MAGIC_overload_table 'c' #endif #ifndef PERL_MAGIC_bm # define PERL_MAGIC_bm 'B' #endif #ifndef PERL_MAGIC_regdata # define PERL_MAGIC_regdata 'D' #endif #ifndef PERL_MAGIC_regdatum # define PERL_MAGIC_regdatum 'd' #endif #ifndef PERL_MAGIC_env # define PERL_MAGIC_env 'E' #endif #ifndef PERL_MAGIC_envelem # define PERL_MAGIC_envelem 'e' #endif #ifndef PERL_MAGIC_fm # define PERL_MAGIC_fm 'f' #endif #ifndef PERL_MAGIC_regex_global # define PERL_MAGIC_regex_global 'g' #endif #ifndef PERL_MAGIC_isa # define PERL_MAGIC_isa 'I' #endif #ifndef PERL_MAGIC_isaelem # define PERL_MAGIC_isaelem 'i' #endif #ifndef PERL_MAGIC_nkeys # define PERL_MAGIC_nkeys 'k' #endif #ifndef PERL_MAGIC_dbfile # define PERL_MAGIC_dbfile 'L' #endif #ifndef PERL_MAGIC_dbline # define PERL_MAGIC_dbline 'l' #endif #ifndef PERL_MAGIC_mutex # define PERL_MAGIC_mutex 'm' #endif #ifndef PERL_MAGIC_shared # define PERL_MAGIC_shared 'N' #endif #ifndef PERL_MAGIC_shared_scalar # define PERL_MAGIC_shared_scalar 'n' #endif #ifndef PERL_MAGIC_collxfrm # define PERL_MAGIC_collxfrm 'o' #endif #ifndef PERL_MAGIC_tied # define PERL_MAGIC_tied 'P' #endif #ifndef PERL_MAGIC_tiedelem # define PERL_MAGIC_tiedelem 'p' #endif #ifndef PERL_MAGIC_tiedscalar # define PERL_MAGIC_tiedscalar 'q' #endif #ifndef PERL_MAGIC_qr # define PERL_MAGIC_qr 'r' #endif #ifndef PERL_MAGIC_sig # define PERL_MAGIC_sig 'S' #endif #ifndef PERL_MAGIC_sigelem # define PERL_MAGIC_sigelem 's' #endif #ifndef PERL_MAGIC_taint # define PERL_MAGIC_taint 't' #endif #ifndef PERL_MAGIC_uvar # define PERL_MAGIC_uvar 'U' #endif #ifndef PERL_MAGIC_uvar_elem # define PERL_MAGIC_uvar_elem 'u' #endif #ifndef PERL_MAGIC_vstring # define PERL_MAGIC_vstring 'V' #endif #ifndef PERL_MAGIC_vec # define PERL_MAGIC_vec 'v' #endif #ifndef PERL_MAGIC_utf8 # define PERL_MAGIC_utf8 'w' #endif #ifndef PERL_MAGIC_substr # define PERL_MAGIC_substr 'x' #endif #ifndef PERL_MAGIC_defelem # define PERL_MAGIC_defelem 'y' #endif #ifndef PERL_MAGIC_glob # define PERL_MAGIC_glob '*' #endif #ifndef PERL_MAGIC_arylen # define PERL_MAGIC_arylen '#' #endif #ifndef PERL_MAGIC_pos # define PERL_MAGIC_pos '.' #endif #ifndef PERL_MAGIC_backref # define PERL_MAGIC_backref '<' #endif #ifndef PERL_MAGIC_ext # define PERL_MAGIC_ext '~' #endif /* That's the best we can do... */ #ifndef sv_catpvn_nomg # define sv_catpvn_nomg sv_catpvn #endif #ifndef sv_catsv_nomg # define sv_catsv_nomg sv_catsv #endif #ifndef sv_setsv_nomg # define sv_setsv_nomg sv_setsv #endif #ifndef sv_pvn_nomg # define sv_pvn_nomg sv_pvn #endif #ifndef SvIV_nomg # define SvIV_nomg SvIV #endif #ifndef SvUV_nomg # define SvUV_nomg SvUV #endif #ifndef sv_catpv_mg # define sv_catpv_mg(sv, ptr) \ STMT_START { \ SV *TeMpSv = sv; \ sv_catpv(TeMpSv,ptr); \ SvSETMAGIC(TeMpSv); \ } STMT_END #endif #ifndef sv_catpvn_mg # define sv_catpvn_mg(sv, ptr, len) \ STMT_START { \ SV *TeMpSv = sv; \ sv_catpvn(TeMpSv,ptr,len); \ SvSETMAGIC(TeMpSv); \ } STMT_END #endif #ifndef sv_catsv_mg # define sv_catsv_mg(dsv, ssv) \ STMT_START { \ SV *TeMpSv = dsv; \ sv_catsv(TeMpSv,ssv); \ SvSETMAGIC(TeMpSv); \ } STMT_END #endif #ifndef sv_setiv_mg # define sv_setiv_mg(sv, i) \ STMT_START { \ SV *TeMpSv = sv; \ sv_setiv(TeMpSv,i); \ SvSETMAGIC(TeMpSv); \ } STMT_END #endif #ifndef sv_setnv_mg # define sv_setnv_mg(sv, num) \ STMT_START { \ SV *TeMpSv = sv; \ sv_setnv(TeMpSv,num); \ SvSETMAGIC(TeMpSv); \ } STMT_END #endif #ifndef sv_setpv_mg # define sv_setpv_mg(sv, ptr) \ STMT_START { \ SV *TeMpSv = sv; \ sv_setpv(TeMpSv,ptr); \ SvSETMAGIC(TeMpSv); \ } STMT_END #endif #ifndef sv_setpvn_mg # define sv_setpvn_mg(sv, ptr, len) \ STMT_START { \ SV *TeMpSv = sv; \ sv_setpvn(TeMpSv,ptr,len); \ SvSETMAGIC(TeMpSv); \ } STMT_END #endif #ifndef sv_setsv_mg # define sv_setsv_mg(dsv, ssv) \ STMT_START { \ SV *TeMpSv = dsv; \ sv_setsv(TeMpSv,ssv); \ SvSETMAGIC(TeMpSv); \ } STMT_END #endif #ifndef sv_setuv_mg # define sv_setuv_mg(sv, i) \ STMT_START { \ SV *TeMpSv = sv; \ sv_setuv(TeMpSv,i); \ SvSETMAGIC(TeMpSv); \ } STMT_END #endif #ifndef sv_usepvn_mg # define sv_usepvn_mg(sv, ptr, len) \ STMT_START { \ SV *TeMpSv = sv; \ sv_usepvn(TeMpSv,ptr,len); \ SvSETMAGIC(TeMpSv); \ } STMT_END #endif #ifndef SvVSTRING_mg # define SvVSTRING_mg(sv) (SvMAGICAL(sv) ? mg_find(sv, PERL_MAGIC_vstring) : NULL) #endif /* Hint: sv_magic_portable * This is a compatibility function that is only available with * Devel::PPPort. It is NOT in the perl core. * Its purpose is to mimic the 5.8.0 behaviour of sv_magic() when * it is being passed a name pointer with namlen == 0. In that * case, perl 5.8.0 and later store the pointer, not a copy of it. * The compatibility can be provided back to perl 5.004. With * earlier versions, the code will not compile. */ #if (PERL_BCDVERSION < 0x5004000) /* code that uses sv_magic_portable will not compile */ #elif (PERL_BCDVERSION < 0x5008000) # define sv_magic_portable(sv, obj, how, name, namlen) \ STMT_START { \ SV *SvMp_sv = (sv); \ char *SvMp_name = (char *) (name); \ I32 SvMp_namlen = (namlen); \ if (SvMp_name && SvMp_namlen == 0) \ { \ MAGIC *mg; \ sv_magic(SvMp_sv, obj, how, 0, 0); \ mg = SvMAGIC(SvMp_sv); \ mg->mg_len = -42; /* XXX: this is the tricky part */ \ mg->mg_ptr = SvMp_name; \ } \ else \ { \ sv_magic(SvMp_sv, obj, how, SvMp_name, SvMp_namlen); \ } \ } STMT_END #else # define sv_magic_portable(a, b, c, d, e) sv_magic(a, b, c, d, e) #endif #ifdef USE_ITHREADS #ifndef CopFILE # define CopFILE(c) ((c)->cop_file) #endif #ifndef CopFILEGV # define CopFILEGV(c) (CopFILE(c) ? gv_fetchfile(CopFILE(c)) : Nullgv) #endif #ifndef CopFILE_set # define CopFILE_set(c,pv) ((c)->cop_file = savepv(pv)) #endif #ifndef CopFILESV # define CopFILESV(c) (CopFILE(c) ? GvSV(gv_fetchfile(CopFILE(c))) : Nullsv) #endif #ifndef CopFILEAV # define CopFILEAV(c) (CopFILE(c) ? GvAV(gv_fetchfile(CopFILE(c))) : Nullav) #endif #ifndef CopSTASHPV # define CopSTASHPV(c) ((c)->cop_stashpv) #endif #ifndef CopSTASHPV_set # define CopSTASHPV_set(c,pv) ((c)->cop_stashpv = ((pv) ? savepv(pv) : Nullch)) #endif #ifndef CopSTASH # define CopSTASH(c) (CopSTASHPV(c) ? gv_stashpv(CopSTASHPV(c),GV_ADD) : Nullhv) #endif #ifndef CopSTASH_set # define CopSTASH_set(c,hv) CopSTASHPV_set(c, (hv) ? HvNAME(hv) : Nullch) #endif #ifndef CopSTASH_eq # define CopSTASH_eq(c,hv) ((hv) && (CopSTASHPV(c) == HvNAME(hv) \ || (CopSTASHPV(c) && HvNAME(hv) \ && strEQ(CopSTASHPV(c), HvNAME(hv))))) #endif #else #ifndef CopFILEGV # define CopFILEGV(c) ((c)->cop_filegv) #endif #ifndef CopFILEGV_set # define CopFILEGV_set(c,gv) ((c)->cop_filegv = (GV*)SvREFCNT_inc(gv)) #endif #ifndef CopFILE_set # define CopFILE_set(c,pv) CopFILEGV_set((c), gv_fetchfile(pv)) #endif #ifndef CopFILESV # define CopFILESV(c) (CopFILEGV(c) ? GvSV(CopFILEGV(c)) : Nullsv) #endif #ifndef CopFILEAV # define CopFILEAV(c) (CopFILEGV(c) ? GvAV(CopFILEGV(c)) : Nullav) #endif #ifndef CopFILE # define CopFILE(c) (CopFILESV(c) ? SvPVX(CopFILESV(c)) : Nullch) #endif #ifndef CopSTASH # define CopSTASH(c) ((c)->cop_stash) #endif #ifndef CopSTASH_set # define CopSTASH_set(c,hv) ((c)->cop_stash = (hv)) #endif #ifndef CopSTASHPV # define CopSTASHPV(c) (CopSTASH(c) ? HvNAME(CopSTASH(c)) : Nullch) #endif #ifndef CopSTASHPV_set # define CopSTASHPV_set(c,pv) CopSTASH_set((c), gv_stashpv(pv,GV_ADD)) #endif #ifndef CopSTASH_eq # define CopSTASH_eq(c,hv) (CopSTASH(c) == (hv)) #endif #endif /* USE_ITHREADS */ #ifndef IN_PERL_COMPILETIME # define IN_PERL_COMPILETIME (PL_curcop == &PL_compiling) #endif #ifndef IN_LOCALE_RUNTIME # define IN_LOCALE_RUNTIME (PL_curcop->op_private & HINT_LOCALE) #endif #ifndef IN_LOCALE_COMPILETIME # define IN_LOCALE_COMPILETIME (PL_hints & HINT_LOCALE) #endif #ifndef IN_LOCALE # define IN_LOCALE (IN_PERL_COMPILETIME ? IN_LOCALE_COMPILETIME : IN_LOCALE_RUNTIME) #endif #ifndef IS_NUMBER_IN_UV # define IS_NUMBER_IN_UV 0x01 #endif #ifndef IS_NUMBER_GREATER_THAN_UV_MAX # define IS_NUMBER_GREATER_THAN_UV_MAX 0x02 #endif #ifndef IS_NUMBER_NOT_INT # define IS_NUMBER_NOT_INT 0x04 #endif #ifndef IS_NUMBER_NEG # define IS_NUMBER_NEG 0x08 #endif #ifndef IS_NUMBER_INFINITY # define IS_NUMBER_INFINITY 0x10 #endif #ifndef IS_NUMBER_NAN # define IS_NUMBER_NAN 0x20 #endif #ifndef GROK_NUMERIC_RADIX # define GROK_NUMERIC_RADIX(sp, send) grok_numeric_radix(sp, send) #endif #ifndef PERL_SCAN_GREATER_THAN_UV_MAX # define PERL_SCAN_GREATER_THAN_UV_MAX 0x02 #endif #ifndef PERL_SCAN_SILENT_ILLDIGIT # define PERL_SCAN_SILENT_ILLDIGIT 0x04 #endif #ifndef PERL_SCAN_ALLOW_UNDERSCORES # define PERL_SCAN_ALLOW_UNDERSCORES 0x01 #endif #ifndef PERL_SCAN_DISALLOW_PREFIX # define PERL_SCAN_DISALLOW_PREFIX 0x02 #endif #ifndef grok_numeric_radix #if defined(NEED_grok_numeric_radix) static bool DPPP_(my_grok_numeric_radix)(pTHX_ const char ** sp, const char * send); static #else extern bool DPPP_(my_grok_numeric_radix)(pTHX_ const char ** sp, const char * send); #endif #ifdef grok_numeric_radix # undef grok_numeric_radix #endif #define grok_numeric_radix(a,b) DPPP_(my_grok_numeric_radix)(aTHX_ a,b) #define Perl_grok_numeric_radix DPPP_(my_grok_numeric_radix) #if defined(NEED_grok_numeric_radix) || defined(NEED_grok_numeric_radix_GLOBAL) bool DPPP_(my_grok_numeric_radix)(pTHX_ const char **sp, const char *send) { #ifdef USE_LOCALE_NUMERIC #ifdef PL_numeric_radix_sv if (PL_numeric_radix_sv && IN_LOCALE) { STRLEN len; char* radix = SvPV(PL_numeric_radix_sv, len); if (*sp + len <= send && memEQ(*sp, radix, len)) { *sp += len; return TRUE; } } #else /* older perls don't have PL_numeric_radix_sv so the radix * must manually be requested from locale.h */ #include dTHR; /* needed for older threaded perls */ struct lconv *lc = localeconv(); char *radix = lc->decimal_point; if (radix && IN_LOCALE) { STRLEN len = strlen(radix); if (*sp + len <= send && memEQ(*sp, radix, len)) { *sp += len; return TRUE; } } #endif #endif /* USE_LOCALE_NUMERIC */ /* always try "." if numeric radix didn't match because * we may have data from different locales mixed */ if (*sp < send && **sp == '.') { ++*sp; return TRUE; } return FALSE; } #endif #endif #ifndef grok_number #if defined(NEED_grok_number) static int DPPP_(my_grok_number)(pTHX_ const char * pv, STRLEN len, UV * valuep); static #else extern int DPPP_(my_grok_number)(pTHX_ const char * pv, STRLEN len, UV * valuep); #endif #ifdef grok_number # undef grok_number #endif #define grok_number(a,b,c) DPPP_(my_grok_number)(aTHX_ a,b,c) #define Perl_grok_number DPPP_(my_grok_number) #if defined(NEED_grok_number) || defined(NEED_grok_number_GLOBAL) int DPPP_(my_grok_number)(pTHX_ const char *pv, STRLEN len, UV *valuep) { const char *s = pv; const char *send = pv + len; const UV max_div_10 = UV_MAX / 10; const char max_mod_10 = UV_MAX % 10; int numtype = 0; int sawinf = 0; int sawnan = 0; while (s < send && isSPACE(*s)) s++; if (s == send) { return 0; } else if (*s == '-') { s++; numtype = IS_NUMBER_NEG; } else if (*s == '+') s++; if (s == send) return 0; /* next must be digit or the radix separator or beginning of infinity */ if (isDIGIT(*s)) { /* UVs are at least 32 bits, so the first 9 decimal digits cannot overflow. */ UV value = *s - '0'; /* This construction seems to be more optimiser friendly. (without it gcc does the isDIGIT test and the *s - '0' separately) With it gcc on arm is managing 6 instructions (6 cycles) per digit. In theory the optimiser could deduce how far to unroll the loop before checking for overflow. */ if (++s < send) { int digit = *s - '0'; if (digit >= 0 && digit <= 9) { value = value * 10 + digit; if (++s < send) { digit = *s - '0'; if (digit >= 0 && digit <= 9) { value = value * 10 + digit; if (++s < send) { digit = *s - '0'; if (digit >= 0 && digit <= 9) { value = value * 10 + digit; if (++s < send) { digit = *s - '0'; if (digit >= 0 && digit <= 9) { value = value * 10 + digit; if (++s < send) { digit = *s - '0'; if (digit >= 0 && digit <= 9) { value = value * 10 + digit; if (++s < send) { digit = *s - '0'; if (digit >= 0 && digit <= 9) { value = value * 10 + digit; if (++s < send) { digit = *s - '0'; if (digit >= 0 && digit <= 9) { value = value * 10 + digit; if (++s < send) { digit = *s - '0'; if (digit >= 0 && digit <= 9) { value = value * 10 + digit; if (++s < send) { /* Now got 9 digits, so need to check each time for overflow. */ digit = *s - '0'; while (digit >= 0 && digit <= 9 && (value < max_div_10 || (value == max_div_10 && digit <= max_mod_10))) { value = value * 10 + digit; if (++s < send) digit = *s - '0'; else break; } if (digit >= 0 && digit <= 9 && (s < send)) { /* value overflowed. skip the remaining digits, don't worry about setting *valuep. */ do { s++; } while (s < send && isDIGIT(*s)); numtype |= IS_NUMBER_GREATER_THAN_UV_MAX; goto skip_value; } } } } } } } } } } } } } } } } } } numtype |= IS_NUMBER_IN_UV; if (valuep) *valuep = value; skip_value: if (GROK_NUMERIC_RADIX(&s, send)) { numtype |= IS_NUMBER_NOT_INT; while (s < send && isDIGIT(*s)) /* optional digits after the radix */ s++; } } else if (GROK_NUMERIC_RADIX(&s, send)) { numtype |= IS_NUMBER_NOT_INT | IS_NUMBER_IN_UV; /* valuep assigned below */ /* no digits before the radix means we need digits after it */ if (s < send && isDIGIT(*s)) { do { s++; } while (s < send && isDIGIT(*s)); if (valuep) { /* integer approximation is valid - it's 0. */ *valuep = 0; } } else return 0; } else if (*s == 'I' || *s == 'i') { s++; if (s == send || (*s != 'N' && *s != 'n')) return 0; s++; if (s == send || (*s != 'F' && *s != 'f')) return 0; s++; if (s < send && (*s == 'I' || *s == 'i')) { s++; if (s == send || (*s != 'N' && *s != 'n')) return 0; s++; if (s == send || (*s != 'I' && *s != 'i')) return 0; s++; if (s == send || (*s != 'T' && *s != 't')) return 0; s++; if (s == send || (*s != 'Y' && *s != 'y')) return 0; s++; } sawinf = 1; } else if (*s == 'N' || *s == 'n') { /* XXX TODO: There are signaling NaNs and quiet NaNs. */ s++; if (s == send || (*s != 'A' && *s != 'a')) return 0; s++; if (s == send || (*s != 'N' && *s != 'n')) return 0; s++; sawnan = 1; } else return 0; if (sawinf) { numtype &= IS_NUMBER_NEG; /* Keep track of sign */ numtype |= IS_NUMBER_INFINITY | IS_NUMBER_NOT_INT; } else if (sawnan) { numtype &= IS_NUMBER_NEG; /* Keep track of sign */ numtype |= IS_NUMBER_NAN | IS_NUMBER_NOT_INT; } else if (s < send) { /* we can have an optional exponent part */ if (*s == 'e' || *s == 'E') { /* The only flag we keep is sign. Blow away any "it's UV" */ numtype &= IS_NUMBER_NEG; numtype |= IS_NUMBER_NOT_INT; s++; if (s < send && (*s == '-' || *s == '+')) s++; if (s < send && isDIGIT(*s)) { do { s++; } while (s < send && isDIGIT(*s)); } else return 0; } } while (s < send && isSPACE(*s)) s++; if (s >= send) return numtype; if (len == 10 && memEQ(pv, "0 but true", 10)) { if (valuep) *valuep = 0; return IS_NUMBER_IN_UV; } return 0; } #endif #endif /* * The grok_* routines have been modified to use warn() instead of * Perl_warner(). Also, 'hexdigit' was the former name of PL_hexdigit, * which is why the stack variable has been renamed to 'xdigit'. */ #ifndef grok_bin #if defined(NEED_grok_bin) static UV DPPP_(my_grok_bin)(pTHX_ const char * start, STRLEN * len_p, I32 * flags, NV * result); static #else extern UV DPPP_(my_grok_bin)(pTHX_ const char * start, STRLEN * len_p, I32 * flags, NV * result); #endif #ifdef grok_bin # undef grok_bin #endif #define grok_bin(a,b,c,d) DPPP_(my_grok_bin)(aTHX_ a,b,c,d) #define Perl_grok_bin DPPP_(my_grok_bin) #if defined(NEED_grok_bin) || defined(NEED_grok_bin_GLOBAL) UV DPPP_(my_grok_bin)(pTHX_ const char *start, STRLEN *len_p, I32 *flags, NV *result) { const char *s = start; STRLEN len = *len_p; UV value = 0; NV value_nv = 0; const UV max_div_2 = UV_MAX / 2; bool allow_underscores = *flags & PERL_SCAN_ALLOW_UNDERSCORES; bool overflowed = FALSE; if (!(*flags & PERL_SCAN_DISALLOW_PREFIX)) { /* strip off leading b or 0b. for compatibility silently suffer "b" and "0b" as valid binary numbers. */ if (len >= 1) { if (s[0] == 'b') { s++; len--; } else if (len >= 2 && s[0] == '0' && s[1] == 'b') { s+=2; len-=2; } } } for (; len-- && *s; s++) { char bit = *s; if (bit == '0' || bit == '1') { /* Write it in this wonky order with a goto to attempt to get the compiler to make the common case integer-only loop pretty tight. With gcc seems to be much straighter code than old scan_bin. */ redo: if (!overflowed) { if (value <= max_div_2) { value = (value << 1) | (bit - '0'); continue; } /* Bah. We're just overflowed. */ warn("Integer overflow in binary number"); overflowed = TRUE; value_nv = (NV) value; } value_nv *= 2.0; /* If an NV has not enough bits in its mantissa to * represent a UV this summing of small low-order numbers * is a waste of time (because the NV cannot preserve * the low-order bits anyway): we could just remember when * did we overflow and in the end just multiply value_nv by the * right amount. */ value_nv += (NV)(bit - '0'); continue; } if (bit == '_' && len && allow_underscores && (bit = s[1]) && (bit == '0' || bit == '1')) { --len; ++s; goto redo; } if (!(*flags & PERL_SCAN_SILENT_ILLDIGIT)) warn("Illegal binary digit '%c' ignored", *s); break; } if ( ( overflowed && value_nv > 4294967295.0) #if UVSIZE > 4 || (!overflowed && value > 0xffffffff ) #endif ) { warn("Binary number > 0b11111111111111111111111111111111 non-portable"); } *len_p = s - start; if (!overflowed) { *flags = 0; return value; } *flags = PERL_SCAN_GREATER_THAN_UV_MAX; if (result) *result = value_nv; return UV_MAX; } #endif #endif #ifndef grok_hex #if defined(NEED_grok_hex) static UV DPPP_(my_grok_hex)(pTHX_ const char * start, STRLEN * len_p, I32 * flags, NV * result); static #else extern UV DPPP_(my_grok_hex)(pTHX_ const char * start, STRLEN * len_p, I32 * flags, NV * result); #endif #ifdef grok_hex # undef grok_hex #endif #define grok_hex(a,b,c,d) DPPP_(my_grok_hex)(aTHX_ a,b,c,d) #define Perl_grok_hex DPPP_(my_grok_hex) #if defined(NEED_grok_hex) || defined(NEED_grok_hex_GLOBAL) UV DPPP_(my_grok_hex)(pTHX_ const char *start, STRLEN *len_p, I32 *flags, NV *result) { const char *s = start; STRLEN len = *len_p; UV value = 0; NV value_nv = 0; const UV max_div_16 = UV_MAX / 16; bool allow_underscores = *flags & PERL_SCAN_ALLOW_UNDERSCORES; bool overflowed = FALSE; const char *xdigit; if (!(*flags & PERL_SCAN_DISALLOW_PREFIX)) { /* strip off leading x or 0x. for compatibility silently suffer "x" and "0x" as valid hex numbers. */ if (len >= 1) { if (s[0] == 'x') { s++; len--; } else if (len >= 2 && s[0] == '0' && s[1] == 'x') { s+=2; len-=2; } } } for (; len-- && *s; s++) { xdigit = strchr((char *) PL_hexdigit, *s); if (xdigit) { /* Write it in this wonky order with a goto to attempt to get the compiler to make the common case integer-only loop pretty tight. With gcc seems to be much straighter code than old scan_hex. */ redo: if (!overflowed) { if (value <= max_div_16) { value = (value << 4) | ((xdigit - PL_hexdigit) & 15); continue; } warn("Integer overflow in hexadecimal number"); overflowed = TRUE; value_nv = (NV) value; } value_nv *= 16.0; /* If an NV has not enough bits in its mantissa to * represent a UV this summing of small low-order numbers * is a waste of time (because the NV cannot preserve * the low-order bits anyway): we could just remember when * did we overflow and in the end just multiply value_nv by the * right amount of 16-tuples. */ value_nv += (NV)((xdigit - PL_hexdigit) & 15); continue; } if (*s == '_' && len && allow_underscores && s[1] && (xdigit = strchr((char *) PL_hexdigit, s[1]))) { --len; ++s; goto redo; } if (!(*flags & PERL_SCAN_SILENT_ILLDIGIT)) warn("Illegal hexadecimal digit '%c' ignored", *s); break; } if ( ( overflowed && value_nv > 4294967295.0) #if UVSIZE > 4 || (!overflowed && value > 0xffffffff ) #endif ) { warn("Hexadecimal number > 0xffffffff non-portable"); } *len_p = s - start; if (!overflowed) { *flags = 0; return value; } *flags = PERL_SCAN_GREATER_THAN_UV_MAX; if (result) *result = value_nv; return UV_MAX; } #endif #endif #ifndef grok_oct #if defined(NEED_grok_oct) static UV DPPP_(my_grok_oct)(pTHX_ const char * start, STRLEN * len_p, I32 * flags, NV * result); static #else extern UV DPPP_(my_grok_oct)(pTHX_ const char * start, STRLEN * len_p, I32 * flags, NV * result); #endif #ifdef grok_oct # undef grok_oct #endif #define grok_oct(a,b,c,d) DPPP_(my_grok_oct)(aTHX_ a,b,c,d) #define Perl_grok_oct DPPP_(my_grok_oct) #if defined(NEED_grok_oct) || defined(NEED_grok_oct_GLOBAL) UV DPPP_(my_grok_oct)(pTHX_ const char *start, STRLEN *len_p, I32 *flags, NV *result) { const char *s = start; STRLEN len = *len_p; UV value = 0; NV value_nv = 0; const UV max_div_8 = UV_MAX / 8; bool allow_underscores = *flags & PERL_SCAN_ALLOW_UNDERSCORES; bool overflowed = FALSE; for (; len-- && *s; s++) { /* gcc 2.95 optimiser not smart enough to figure that this subtraction out front allows slicker code. */ int digit = *s - '0'; if (digit >= 0 && digit <= 7) { /* Write it in this wonky order with a goto to attempt to get the compiler to make the common case integer-only loop pretty tight. */ redo: if (!overflowed) { if (value <= max_div_8) { value = (value << 3) | digit; continue; } /* Bah. We're just overflowed. */ warn("Integer overflow in octal number"); overflowed = TRUE; value_nv = (NV) value; } value_nv *= 8.0; /* If an NV has not enough bits in its mantissa to * represent a UV this summing of small low-order numbers * is a waste of time (because the NV cannot preserve * the low-order bits anyway): we could just remember when * did we overflow and in the end just multiply value_nv by the * right amount of 8-tuples. */ value_nv += (NV)digit; continue; } if (digit == ('_' - '0') && len && allow_underscores && (digit = s[1] - '0') && (digit >= 0 && digit <= 7)) { --len; ++s; goto redo; } /* Allow \octal to work the DWIM way (that is, stop scanning * as soon as non-octal characters are seen, complain only iff * someone seems to want to use the digits eight and nine). */ if (digit == 8 || digit == 9) { if (!(*flags & PERL_SCAN_SILENT_ILLDIGIT)) warn("Illegal octal digit '%c' ignored", *s); } break; } if ( ( overflowed && value_nv > 4294967295.0) #if UVSIZE > 4 || (!overflowed && value > 0xffffffff ) #endif ) { warn("Octal number > 037777777777 non-portable"); } *len_p = s - start; if (!overflowed) { *flags = 0; return value; } *flags = PERL_SCAN_GREATER_THAN_UV_MAX; if (result) *result = value_nv; return UV_MAX; } #endif #endif #if !defined(my_snprintf) #if defined(NEED_my_snprintf) static int DPPP_(my_my_snprintf)(char * buffer, const Size_t len, const char * format, ...); static #else extern int DPPP_(my_my_snprintf)(char * buffer, const Size_t len, const char * format, ...); #endif #define my_snprintf DPPP_(my_my_snprintf) #define Perl_my_snprintf DPPP_(my_my_snprintf) #if defined(NEED_my_snprintf) || defined(NEED_my_snprintf_GLOBAL) int DPPP_(my_my_snprintf)(char *buffer, const Size_t len, const char *format, ...) { dTHX; int retval; va_list ap; va_start(ap, format); #ifdef HAS_VSNPRINTF retval = vsnprintf(buffer, len, format, ap); #else retval = vsprintf(buffer, format, ap); #endif va_end(ap); if (retval >= (int)len) Perl_croak(aTHX_ "panic: my_snprintf buffer overflow"); return retval; } #endif #endif #ifdef NO_XSLOCKS # ifdef dJMPENV # define dXCPT dJMPENV; int rEtV = 0 # define XCPT_TRY_START JMPENV_PUSH(rEtV); if (rEtV == 0) # define XCPT_TRY_END JMPENV_POP; # define XCPT_CATCH if (rEtV != 0) # define XCPT_RETHROW JMPENV_JUMP(rEtV) # else # define dXCPT Sigjmp_buf oldTOP; int rEtV = 0 # define XCPT_TRY_START Copy(top_env, oldTOP, 1, Sigjmp_buf); rEtV = Sigsetjmp(top_env, 1); if (rEtV == 0) # define XCPT_TRY_END Copy(oldTOP, top_env, 1, Sigjmp_buf); # define XCPT_CATCH if (rEtV != 0) # define XCPT_RETHROW Siglongjmp(top_env, rEtV) # endif #endif #if !defined(my_strlcat) #if defined(NEED_my_strlcat) static Size_t DPPP_(my_my_strlcat)(char * dst, const char * src, Size_t size); static #else extern Size_t DPPP_(my_my_strlcat)(char * dst, const char * src, Size_t size); #endif #define my_strlcat DPPP_(my_my_strlcat) #define Perl_my_strlcat DPPP_(my_my_strlcat) #if defined(NEED_my_strlcat) || defined(NEED_my_strlcat_GLOBAL) Size_t DPPP_(my_my_strlcat)(char *dst, const char *src, Size_t size) { Size_t used, length, copy; used = strlen(dst); length = strlen(src); if (size > 0 && used < size - 1) { copy = (length >= size - used) ? size - used - 1 : length; memcpy(dst + used, src, copy); dst[used + copy] = '\0'; } return used + length; } #endif #endif #if !defined(my_strlcpy) #if defined(NEED_my_strlcpy) static Size_t DPPP_(my_my_strlcpy)(char * dst, const char * src, Size_t size); static #else extern Size_t DPPP_(my_my_strlcpy)(char * dst, const char * src, Size_t size); #endif #define my_strlcpy DPPP_(my_my_strlcpy) #define Perl_my_strlcpy DPPP_(my_my_strlcpy) #if defined(NEED_my_strlcpy) || defined(NEED_my_strlcpy_GLOBAL) Size_t DPPP_(my_my_strlcpy)(char *dst, const char *src, Size_t size) { Size_t length, copy; length = strlen(src); if (size > 0) { copy = (length >= size) ? size - 1 : length; memcpy(dst, src, copy); dst[copy] = '\0'; } return length; } #endif #endif #endif /* _P_P_PORTABILITY_H_ */ /* End of File ppport.h */ XML-LibXSLT-1.95/perl-libxml-mm.c0000644000076400007640000002633512321505051016230 0ustar shlomifshlomif/** * perl-libxml-mm.c * $Id$ * * Basic concept: * perl varies in the implementation of UTF8 handling. this header (together * with the c source) implements a few functions, that can be used from within * the core module inorder to avoid cascades of c pragmas */ /* * This is free software, you may use it and distribute it under the same terms as * Perl itself. * * Copyright 2001-2009 AxKit.com Ltd. */ #ifdef __cplusplus extern "C" { #endif #include #include #include "perl-libxml-mm.h" #include "XSUB.h" #include #ifdef __cplusplus } #endif #ifdef XS_WARNINGS #define xs_warn(string) warn(string) /* #define xs_warn(string) fprintf(stderr, string) */ #else #define xs_warn(string) #endif /** * this is a wrapper function that does the type evaluation for the * node. this makes the code a little more readable in the .XS * * the code is not really portable, but i think we'll avoid some * memory leak problems that way. **/ const char* x_PmmNodeTypeName( xmlNodePtr elem ){ const char *name = "XML::LibXML::Node"; if ( elem != NULL ) { switch ( elem->type ) { case XML_ELEMENT_NODE: name = "XML::LibXML::Element"; break; case XML_TEXT_NODE: name = "XML::LibXML::Text"; break; case XML_COMMENT_NODE: name = "XML::LibXML::Comment"; break; case XML_CDATA_SECTION_NODE: name = "XML::LibXML::CDATASection"; break; case XML_ATTRIBUTE_NODE: name = "XML::LibXML::Attr"; break; case XML_DOCUMENT_NODE: case XML_HTML_DOCUMENT_NODE: name = "XML::LibXML::Document"; break; case XML_DOCUMENT_FRAG_NODE: name = "XML::LibXML::DocumentFragment"; break; case XML_NAMESPACE_DECL: name = "XML::LibXML::Namespace"; break; case XML_DTD_NODE: name = "XML::LibXML::Dtd"; break; case XML_PI_NODE: name = "XML::LibXML::PI"; break; default: name = "XML::LibXML::Node"; break; }; return name; } return ""; } /* * registry of all current proxy nodes * * other classes like XML::LibXSLT must get a pointer * to this registry via XML::LibXML::__proxy_registry * */ extern SV* x_PROXY_NODE_REGISTRY_MUTEX; #ifdef XML_LIBXML_THREADS /* * returns the address of the proxy registry */ xmlHashTablePtr* x_PmmProxyNodeRegistryPtr(ProxyNodePtr proxy) { croak("x_PmmProxyNodeRegistryPtr: TODO!\n"); return NULL; /* return &x_PmmREGISTRY; */ } /* * efficiently generate a string representation of the given pointer */ #define _PMM_HASH_NAME_SIZE(n) n+(n>>3)+(n%8>0 ? 1 : 0) xmlChar * x_PmmRegistryName(void * ptr) { unsigned long int v = (unsigned long int) ptr; int HASH_NAME_SIZE = _PMM_HASH_NAME_SIZE(sizeof(void*)); xmlChar * name; int i; name = (xmlChar *) safemalloc(HASH_NAME_SIZE+1); for(i = 0; i < HASH_NAME_SIZE; ++i) { name[i] = (xmlChar) (128 | v); v >>= 7; } name[HASH_NAME_SIZE] = '\0'; return name; } /* * allocate and return a new LocalProxyNode structure */ LocalProxyNodePtr x_PmmNewLocalProxyNode(ProxyNodePtr proxy) { LocalProxyNodePtr lp; Newc(0, lp, 1, LocalProxyNode, LocalProxyNode); lp->proxy = proxy; lp->count = 0; return lp; } /* * @proxy: proxy node to register * * adds a proxy node to the proxy node registry */ LocalProxyNodePtr x_PmmRegisterProxyNode(ProxyNodePtr proxy) { xmlChar * name = x_PmmRegistryName( proxy ); LocalProxyNodePtr lp = x_PmmNewLocalProxyNode( proxy ); /* warn("LibXML registers proxy node with %p\n",x_PmmREGISTRY); */ SvLOCK(x_PROXY_NODE_REGISTRY_MUTEX); if( xmlHashAddEntry(x_PmmREGISTRY, name, lp) ) croak("x_PmmRegisterProxyNode: error adding node to hash, hash size is %d\n",xmlHashSize(x_PmmREGISTRY)); SvUNLOCK(x_PROXY_NODE_REGISTRY_MUTEX); Safefree(name); return lp; } /* * lookup a LocalProxyNode in the registry */ LocalProxyNodePtr x_PmmRegistryLookup(ProxyNodePtr proxy) { xmlChar * name = x_PmmRegistryName( proxy ); LocalProxyNodePtr lp = xmlHashLookup(x_PmmREGISTRY, name); Safefree(name); return lp; } /* * increment the local refcount for proxy */ void x_PmmRegistryREFCNT_inc(ProxyNodePtr proxy) { /* warn("Registry inc\n"); */ LocalProxyNodePtr lp = x_PmmRegistryLookup( proxy ); if( lp ) lp->count++; else x_PmmRegisterProxyNode( proxy )->count++; } /* * returns the current number of proxy nodes in the registry */ int x_PmmProxyNodeRegistrySize() { return xmlHashSize(x_PmmREGISTRY); } #endif /* XML_LIBXML_THREADS */ /* creates a new proxy node from a given node. this function is aware * about the fact that a node may already has a proxy structure. */ ProxyNodePtr x_PmmNewNode(xmlNodePtr node) { ProxyNodePtr proxy = NULL; if ( node == NULL ) { xs_warn( "x_PmmNewNode: no node found\n" ); return NULL; } if ( node->_private == NULL ) { switch ( node->type ) { case XML_DOCUMENT_NODE: case XML_HTML_DOCUMENT_NODE: case XML_DOCB_DOCUMENT_NODE: proxy = (ProxyNodePtr)xmlMalloc(sizeof(struct _DocProxyNode)); if (proxy != NULL) { ((DocProxyNodePtr)proxy)->psvi_status = Pmm_NO_PSVI; x_SetPmmENCODING(proxy, XML_CHAR_ENCODING_NONE); } break; default: proxy = (ProxyNodePtr)xmlMalloc(sizeof(struct _ProxyNode)); break; } if (proxy != NULL) { proxy->node = node; proxy->owner = NULL; proxy->count = 0; node->_private = (void*) proxy; } } else { proxy = (ProxyNodePtr)node->_private; } return proxy; } ProxyNodePtr x_PmmNewFragment(xmlDocPtr doc) { ProxyNodePtr retval = NULL; xmlNodePtr frag = NULL; xs_warn("x_PmmNewFragment: new frag\n"); frag = xmlNewDocFragment( doc ); retval = x_PmmNewNode(frag); /* fprintf(stderr, "REFCNT NOT incremented on frag: 0x%08.8X\n", retval); */ if ( doc != NULL ) { xs_warn("x_PmmNewFragment: inc document\n"); /* under rare circumstances _private is not set correctly? */ if ( doc->_private != NULL ) { xs_warn("x_PmmNewFragment: doc->_private being incremented!\n"); x_PmmREFCNT_inc(((ProxyNodePtr)doc->_private)); /* fprintf(stderr, "REFCNT incremented on doc: 0x%08.8X\n", doc->_private); */ } retval->owner = (xmlNodePtr)doc; } return retval; } /* @node: the node that should be wrapped into a SV * @owner: perl instance of the owner node (may be NULL) * * This function will create a real perl instance of a given node. * the function is called directly by the XS layer, to generate a perl * instance of the node. All node reference counts are updated within * this function. Therefore this function returns a node that can * directly be used as output. * * if @ower is NULL or undefined, the node is ment to be the root node * of the tree. this node will later be used as an owner of other * nodes. */ SV* x_PmmNodeToSv( xmlNodePtr node, ProxyNodePtr owner ) { ProxyNodePtr dfProxy= NULL; SV * retval = &PL_sv_undef; const char * CLASS = "XML::LibXML::Node"; if ( node != NULL ) { #ifdef XML_LIBXML_THREADS if( x_PmmUSEREGISTRY ) SvLOCK(x_PROXY_NODE_REGISTRY_MUTEX); #endif /* find out about the class */ CLASS = x_PmmNodeTypeName( node ); xs_warn("x_PmmNodeToSv: return new perl node of class:\n"); xs_warn( CLASS ); if ( node->_private != NULL ) { dfProxy = x_PmmNewNode(node); /* warn(" at 0x%08.8X\n", dfProxy); */ } else { dfProxy = x_PmmNewNode(node); /* fprintf(stderr, " at 0x%08.8X\n", dfProxy); */ if ( dfProxy != NULL ) { if ( owner != NULL ) { dfProxy->owner = x_PmmNODE( owner ); x_PmmREFCNT_inc( owner ); /* fprintf(stderr, "REFCNT incremented on owner: 0x%08.8X\n", owner); */ } else { xs_warn("x_PmmNodeToSv: node contains itself (owner==NULL)\n"); } } else { xs_warn("x_PmmNodeToSv: proxy creation failed!\n"); } } retval = NEWSV(0,0); sv_setref_pv( retval, CLASS, (void*)dfProxy ); #ifdef XML_LIBXML_THREADS if( x_PmmUSEREGISTRY ) x_PmmRegistryREFCNT_inc(dfProxy); #endif x_PmmREFCNT_inc(dfProxy); /* fprintf(stderr, "REFCNT incremented on node: 0x%08.8X\n", dfProxy); */ switch ( node->type ) { case XML_DOCUMENT_NODE: case XML_HTML_DOCUMENT_NODE: case XML_DOCB_DOCUMENT_NODE: if ( ((xmlDocPtr)node)->encoding != NULL ) { x_SetPmmENCODING(dfProxy, (int)xmlParseCharEncoding( (const char*)((xmlDocPtr)node)->encoding )); } break; default: break; } #ifdef XML_LIBXML_THREADS if( x_PmmUSEREGISTRY ) SvUNLOCK(x_PROXY_NODE_REGISTRY_MUTEX); #endif } else { xs_warn( "x_PmmNodeToSv: no node found!\n" ); } return retval; } /* extracts the libxml2 node from a perl reference */ xmlNodePtr x_PmmSvNodeExt( SV* perlnode, int copy ) { xmlNodePtr retval = NULL; ProxyNodePtr proxy = NULL; if ( perlnode != NULL && perlnode != &PL_sv_undef ) { /* if ( sv_derived_from(perlnode, "XML::LibXML::Node") */ /* && SvPROXYNODE(perlnode) != NULL ) { */ /* retval = x_PmmNODE( SvPROXYNODE(perlnode) ) ; */ /* } */ xs_warn("x_PmmSvNodeExt: perlnode found\n" ); if ( sv_derived_from(perlnode, "XML::LibXML::Node") ) { proxy = SvPROXYNODE(perlnode); if ( proxy != NULL ) { xs_warn( "x_PmmSvNodeExt: is a xmlNodePtr structure\n" ); retval = x_PmmNODE( proxy ) ; } if ( retval != NULL && ((ProxyNodePtr)retval->_private) != proxy ) { xs_warn( "x_PmmSvNodeExt: no node in proxy node\n" ); x_PmmNODE( proxy ) = NULL; retval = NULL; } } #ifdef XML_LIBXML_GDOME_SUPPORT else if ( sv_derived_from( perlnode, "XML::GDOME::Node" ) ) { GdomeNode* gnode = (GdomeNode*)SvIV((SV*)SvRV( perlnode )); if ( gnode == NULL ) { warn( "no XML::GDOME data found (datastructure empty)" ); } else { retval = gdome_xml_n_get_xmlNode( gnode ); if ( retval == NULL ) { xs_warn( "x_PmmSvNodeExt: no XML::LibXML node found in GDOME object\n" ); } else if ( copy == 1 ) { retval = x_PmmCloneNode( retval, 1 ); } } } #endif } return retval; } /* extracts the libxml2 owner node from a perl reference */ xmlNodePtr x_PmmSvOwner( SV* perlnode ) { xmlNodePtr retval = NULL; if ( perlnode != NULL && perlnode != &PL_sv_undef && SvPROXYNODE(perlnode) != NULL ) { retval = x_PmmOWNER( SvPROXYNODE(perlnode) ); } return retval; }