This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
1fc6005a62d1a6d6364558a13ccd72280f262f90
[perl5.git] / dist / ExtUtils-ParseXS / lib / ExtUtils / ParseXS.pm
1 package ExtUtils::ParseXS;
2 use strict;
3
4 use 5.006;  # We use /??{}/ in regexes
5 use Cwd;
6 use Config;
7 use Exporter;
8 use File::Basename;
9 use File::Spec;
10 use Symbol;
11 use ExtUtils::ParseXS::Constants ();
12 use ExtUtils::ParseXS::CountLines;
13 use ExtUtils::ParseXS::Utilities qw(
14   standard_typemap_locations
15   trim_whitespace
16   tidy_type
17   C_string
18   valid_proto_string
19   process_typemaps
20   make_targetable
21   map_type
22 );
23
24 our @ISA = qw(Exporter);
25 our @EXPORT_OK = qw(
26   process_file
27   report_error_count
28 );
29 our $VERSION = '3';
30 $VERSION = eval $VERSION if $VERSION =~ /_/;
31
32 # The scalars in the line below remain as 'our' variables because pulling
33 # them into $self led to build problems.  In most cases, strings being
34 # 'eval'-ed contain the variables' names hard-coded.
35 our (
36   $FH, $Package, $func_name, $Full_func_name, $Packid, $pname, $ALIAS, 
37 );
38 # The scalars in the line below remain, for the time being, 'our' variables
39 # because I suspect they will pose the same problems as those in the statement
40 # above.
41 our ($newXS, $proto, $Module_cname, );
42 our (
43   @line, %defaults, 
44   %lengthof, @line_no, %XsubAliases,
45   %XsubAliasValues, %Interfaces, @Attributes, %outargs, @XSStack, 
46 );
47
48 our $self = {};
49
50 sub process_file {
51
52   # Allow for $package->process_file(%hash) in the future
53   my ($pkg, %options) = @_ % 2 ? @_ : (__PACKAGE__, @_);
54
55   $self->{ProtoUsed} = exists $options{prototypes};
56
57   # Set defaults.
58   my %args = (
59     argtypes        => 1,
60     csuffix         => '.c',
61     except          => 0,
62     hiertype        => 0,
63     inout           => 1,
64     linenumbers     => 1,
65     optimize        => 1,
66     output          => \*STDOUT,
67     prototypes      => 0,
68     typemap         => [],
69     versioncheck    => 1,
70     %options,
71   );
72   $args{except} = $args{except} ? ' TRY' : '';
73
74   # Global Constants
75
76   my ($Is_VMS, $SymSet);
77   if ($^O eq 'VMS') {
78     $Is_VMS = 1;
79     # Establish set of global symbols with max length 28, since xsubpp
80     # will later add the 'XS_' prefix.
81     require ExtUtils::XSSymSet;
82     $SymSet = new ExtUtils::XSSymSet 28;
83   }
84   @XSStack = ({type => 'none'});
85   my $XSS_work_idx = 0;
86   my $cpp_next_tmp = 'XSubPPtmpAAAA';
87   $self->{InitFileCode} = [ @ExtUtils::ParseXS::Constants::InitFileCode ];
88   $FH           = $ExtUtils::ParseXS::Constants::FH;
89   $self->{Overload}     = $ExtUtils::ParseXS::Constants::Overload;
90   $self->{errors}       = $ExtUtils::ParseXS::Constants::errors;
91   $self->{Fallback}     = $ExtUtils::ParseXS::Constants::Fallback;
92
93   # Most of the 1500 lines below uses these globals.  We'll have to
94   # clean this up sometime, probably.  For now, we just pull them out
95   # of %args.  -Ken
96
97   $self->{hiertype} = $args{hiertype};
98   $self->{WantPrototypes} = $args{prototypes};
99   $self->{WantVersionChk} = $args{versioncheck};
100   $self->{WantLineNumbers} = $args{linenumbers};
101   $self->{IncludedFiles} = {};
102
103   for my $f ($args{filename}) {
104     die "Missing required parameter 'filename'" unless $f;
105     $self->{filepathname} = $f;
106     ($self->{dir}, $self->{filename}) = (dirname($f), basename($f));
107     $self->{filepathname} =~ s/\\/\\\\/g;
108     $self->{IncludedFiles}->{$f}++;
109   }
110
111   # Open the output file if given as a string.  If they provide some
112   # other kind of reference, trust them that we can print to it.
113   if (not ref $args{output}) {
114     open my($fh), "> $args{output}" or die "Can't create $args{output}: $!";
115     $args{outfile} = $args{output};
116     $args{output} = $fh;
117   }
118
119   # Really, we shouldn't have to chdir() or select() in the first
120   # place.  For now, just save & restore.
121   my $orig_cwd = cwd();
122   my $orig_fh = select();
123
124   chdir($self->{dir});
125   my $pwd = cwd();
126   my $csuffix = $args{csuffix};
127
128   if ($self->{WantLineNumbers}) {
129     my $cfile;
130     if ( $args{outfile} ) {
131       $cfile = $args{outfile};
132     }
133     else {
134       $cfile = $args{filename};
135       $cfile =~ s/\.xs$/$csuffix/i or $cfile .= $csuffix;
136     }
137     tie(*PSEUDO_STDOUT, 'ExtUtils::ParseXS::CountLines', $cfile, $args{output});
138     select PSEUDO_STDOUT;
139   }
140   else {
141     select $args{output};
142   }
143
144   my ($type_kind_ref, $proto_letter_ref, $input_expr_ref, $output_expr_ref) =
145     process_typemaps( $args{typemap}, $pwd );
146
147   $self->{type_kind}    = $type_kind_ref;
148   $self->{proto_letter} = $proto_letter_ref;
149   $self->{input_expr}   = $input_expr_ref;
150   $self->{output_expr}  = $output_expr_ref;
151
152   foreach my $value (values %{ $self->{input_expr} }) {
153     $value =~ s/;*\s+\z//;
154     # Move C pre-processor instructions to column 1 to be strictly ANSI
155     # conformant. Some pre-processors are fussy about this.
156     $value =~ s/^\s+#/#/mg;
157   }
158   foreach my $value (values %{ $self->{output_expr} }) {
159     # And again.
160     $value =~ s/^\s+#/#/mg;
161   }
162
163   my %targetable = make_targetable($self->{output_expr});
164
165   my $END = "!End!\n\n";        # "impossible" keyword (multiple newline)
166
167   # Match an XS keyword
168   $self->{BLOCK_re} = '\s*(' .
169     join('|' => @ExtUtils::ParseXS::Constants::keywords) .
170     "|$END)\\s*:";
171
172   our ($C_group_rex, $C_arg);
173   # Group in C (no support for comments or literals)
174   $C_group_rex = qr/ [({\[]
175                (?: (?> [^()\[\]{}]+ ) | (??{ $C_group_rex }) )*
176                [)}\]] /x;
177   # Chunk in C without comma at toplevel (no comments):
178   $C_arg = qr/ (?: (?> [^()\[\]{},"']+ )
179          |   (??{ $C_group_rex })
180          |   " (?: (?> [^\\"]+ )
181            |   \\.
182            )* "        # String literal
183                 |   ' (?: (?> [^\\']+ ) | \\. )* ' # Char literal
184          )* /xs;
185
186   # Identify the version of xsubpp used
187   print <<EOM;
188 /*
189  * This file was generated automatically by ExtUtils::ParseXS version $VERSION from the
190  * contents of $self->{filename}. Do not edit this file, edit $self->{filename} instead.
191  *
192  *    ANY CHANGES MADE HERE WILL BE LOST!
193  *
194  */
195
196 EOM
197
198
199   print("#line 1 \"$self->{filepathname}\"\n")
200     if $self->{WantLineNumbers};
201
202   # Open the input file (using $self->{filename} which
203   # is a basename'd $args{filename} due to chdir above)
204   open($FH, $self->{filename}) or die "cannot open $self->{filename}: $!\n";
205
206   firstmodule:
207   while (<$FH>) {
208     if (/^=/) {
209       my $podstartline = $.;
210       do {
211         if (/^=cut\s*$/) {
212           # We can't just write out a /* */ comment, as our embedded
213           # POD might itself be in a comment. We can't put a /**/
214           # comment inside #if 0, as the C standard says that the source
215           # file is decomposed into preprocessing characters in the stage
216           # before preprocessing commands are executed.
217           # I don't want to leave the text as barewords, because the spec
218           # isn't clear whether macros are expanded before or after
219           # preprocessing commands are executed, and someone pathological
220           # may just have defined one of the 3 words as a macro that does
221           # something strange. Multiline strings are illegal in C, so
222           # the "" we write must be a string literal. And they aren't
223           # concatenated until 2 steps later, so we are safe.
224           #     - Nicholas Clark
225           print("#if 0\n  \"Skipped embedded POD.\"\n#endif\n");
226           printf("#line %d \"$self->{filepathname}\"\n", $. + 1)
227             if $self->{WantLineNumbers};
228           next firstmodule
229         }
230
231       } while (<$FH>);
232       # At this point $. is at end of file so die won't state the start
233       # of the problem, and as we haven't yet read any lines &death won't
234       # show the correct line in the message either.
235       die ("Error: Unterminated pod in $self->{filename}, line $podstartline\n")
236         unless $self->{lastline};
237     }
238     last if ($Package, $self->{Prefix}) =
239       /^MODULE\s*=\s*[\w:]+(?:\s+PACKAGE\s*=\s*([\w:]+))?(?:\s+PREFIX\s*=\s*(\S+))?\s*$/;
240
241     print $_;
242   }
243   unless (defined $_) {
244     warn "Didn't find a 'MODULE ... PACKAGE ... PREFIX' line\n";
245     exit 0; # Not a fatal error for the caller process
246   }
247
248   print 'ExtUtils::ParseXS::CountLines'->end_marker, "\n" if $self->{WantLineNumbers};
249
250   print <<"EOF";
251 #ifndef PERL_UNUSED_VAR
252 #  define PERL_UNUSED_VAR(var) if (0) var = var
253 #endif
254
255 EOF
256
257   print <<"EOF";
258 #ifndef PERL_ARGS_ASSERT_CROAK_XS_USAGE
259 #define PERL_ARGS_ASSERT_CROAK_XS_USAGE assert(cv); assert(params)
260
261 /* prototype to pass -Wmissing-prototypes */
262 STATIC void
263 S_croak_xs_usage(pTHX_ const CV *const cv, const char *const params);
264
265 STATIC void
266 S_croak_xs_usage(pTHX_ const CV *const cv, const char *const params)
267 {
268     const GV *const gv = CvGV(cv);
269
270     PERL_ARGS_ASSERT_CROAK_XS_USAGE;
271
272     if (gv) {
273         const char *const gvname = GvNAME(gv);
274         const HV *const stash = GvSTASH(gv);
275         const char *const hvname = stash ? HvNAME(stash) : NULL;
276
277         if (hvname)
278             Perl_croak(aTHX_ "Usage: %s::%s(%s)", hvname, gvname, params);
279         else
280             Perl_croak(aTHX_ "Usage: %s(%s)", gvname, params);
281     } else {
282         /* Pants. I don't think that it should be possible to get here. */
283         Perl_croak(aTHX_ "Usage: CODE(0x%"UVxf")(%s)", PTR2UV(cv), params);
284     }
285 }
286 #undef  PERL_ARGS_ASSERT_CROAK_XS_USAGE
287
288 #ifdef PERL_IMPLICIT_CONTEXT
289 #define croak_xs_usage(a,b)    S_croak_xs_usage(aTHX_ a,b)
290 #else
291 #define croak_xs_usage        S_croak_xs_usage
292 #endif
293
294 #endif
295
296 /* NOTE: the prototype of newXSproto() is different in versions of perls,
297  * so we define a portable version of newXSproto()
298  */
299 #ifdef newXS_flags
300 #define newXSproto_portable(name, c_impl, file, proto) newXS_flags(name, c_impl, file, proto, 0)
301 #else
302 #define newXSproto_portable(name, c_impl, file, proto) (PL_Sv=(SV*)newXS(name, c_impl, file), sv_setpv(PL_Sv, proto), (CV*)PL_Sv)
303 #endif /* !defined(newXS_flags) */
304
305 EOF
306
307   print 'ExtUtils::ParseXS::CountLines'->end_marker, "\n" if $self->{WantLineNumbers};
308
309   $self->{lastline}    = $_;
310   $self->{lastline_no} = $.;
311
312   my (@BootCode, @outlist, $prepush_done, $xsreturn, $func_header, $orig_args, );
313  PARAGRAPH:
314   while (fetch_para()) {
315     # Print initial preprocessor statements and blank lines
316     while (@line && $line[0] !~ /^[^\#]/) {
317       my $ln = shift(@line);
318       print $ln, "\n";
319       next unless $ln =~ /^\#\s*((if)(?:n?def)?|elsif|else|endif)\b/;
320       my $statement = $+;
321       if ($statement eq 'if') {
322         $XSS_work_idx = @XSStack;
323         push(@XSStack, {type => 'if'});
324       }
325       else {
326         death ("Error: `$statement' with no matching `if'")
327           if $XSStack[-1]{type} ne 'if';
328         if ($XSStack[-1]{varname}) {
329           push(@{ $self->{InitFileCode} }, "#endif\n");
330           push(@BootCode,     "#endif");
331         }
332
333         my(@fns) = keys %{$XSStack[-1]{functions}};
334         if ($statement ne 'endif') {
335           # Hide the functions defined in other #if branches, and reset.
336           @{$XSStack[-1]{other_functions}}{@fns} = (1) x @fns;
337           @{$XSStack[-1]}{qw(varname functions)} = ('', {});
338         }
339         else {
340           my($tmp) = pop(@XSStack);
341           0 while (--$XSS_work_idx
342                && $XSStack[$XSS_work_idx]{type} ne 'if');
343           # Keep all new defined functions
344           push(@fns, keys %{$tmp->{other_functions}});
345           @{$XSStack[$XSS_work_idx]{functions}}{@fns} = (1) x @fns;
346         }
347       }
348     }
349
350     next PARAGRAPH unless @line;
351
352     if ($XSS_work_idx && !$XSStack[$XSS_work_idx]{varname}) {
353       # We are inside an #if, but have not yet #defined its xsubpp variable.
354       print "#define $cpp_next_tmp 1\n\n";
355       push(@{ $self->{InitFileCode} }, "#if $cpp_next_tmp\n");
356       push(@BootCode,     "#if $cpp_next_tmp");
357       $XSStack[$XSS_work_idx]{varname} = $cpp_next_tmp++;
358     }
359
360     death ("Code is not inside a function"
361        ." (maybe last function was ended by a blank line "
362        ." followed by a statement on column one?)")
363       if $line[0] =~ /^\s/;
364
365     my ($class, $externC, $static, $ellipsis, $wantRETVAL, $RETVAL_no_return);
366     my (@fake_INPUT_pre);    # For length(s) generated variables
367     my (@fake_INPUT);
368
369     # initialize info arrays
370     undef(%{ $self->{args_match} });
371     undef(%{ $self->{var_types} });
372     undef(%defaults);
373     undef(%{ $self->{arg_list} });
374     undef(@{ $self->{proto_arg} });
375     undef($self->{processing_arg_with_types});
376     undef(%{ $self->{argtype_seen} });
377     undef(@outlist);
378     undef(%{ $self->{in_out} });
379     undef(%lengthof);
380     undef($self->{proto_in_this_xsub});
381     undef($self->{scope_in_this_xsub});
382     undef($self->{interface});
383     undef($prepush_done);
384     $self->{interface_macro} = 'XSINTERFACE_FUNC';
385     $self->{interface_macro_set} = 'XSINTERFACE_FUNC_SET';
386     $self->{ProtoThisXSUB} = $self->{WantPrototypes};
387     $self->{ScopeThisXSUB} = 0;
388     $xsreturn = 0;
389
390     $_ = shift(@line);
391     while (my $kwd = check_keyword("REQUIRE|PROTOTYPES|FALLBACK|VERSIONCHECK|INCLUDE(?:_COMMAND)?|SCOPE")) {
392       no strict 'refs';
393       &{"${kwd}_handler"}();
394       use strict 'refs';
395       next PARAGRAPH unless @line;
396       $_ = shift(@line);
397     }
398
399     if (check_keyword("BOOT")) {
400       &check_cpp;
401       push (@BootCode, "#line $line_no[@line_no - @line] \"$self->{filepathname}\"")
402         if $self->{WantLineNumbers} && $line[0] !~ /^\s*#\s*line\b/;
403       push (@BootCode, @line, "");
404       next PARAGRAPH;
405     }
406
407     # extract return type, function name and arguments
408     ($self->{ret_type}) = tidy_type($_);
409     $RETVAL_no_return = 1 if $self->{ret_type} =~ s/^NO_OUTPUT\s+//;
410
411     # Allow one-line ANSI-like declaration
412     unshift @line, $2
413       if $args{argtypes}
414         and $self->{ret_type} =~ s/^(.*?\w.*?)\s*\b(\w+\s*\(.*)/$1/s;
415
416     # a function definition needs at least 2 lines
417     blurt ("Error: Function definition too short '$self->{ret_type}'"), next PARAGRAPH
418       unless @line;
419
420     $externC = 1 if $self->{ret_type} =~ s/^extern "C"\s+//;
421     $static  = 1 if $self->{ret_type} =~ s/^static\s+//;
422
423     $func_header = shift(@line);
424     blurt ("Error: Cannot parse function definition from '$func_header'"), next PARAGRAPH
425       unless $func_header =~ /^(?:([\w:]*)::)?(\w+)\s*\(\s*(.*?)\s*\)\s*(const)?\s*(;\s*)?$/s;
426
427     ($class, $func_name, $orig_args) =  ($1, $2, $3);
428     $class = "$4 $class" if $4;
429     ($pname = $func_name) =~ s/^($self->{Prefix})?/$self->{Packprefix}/;
430     my $clean_func_name;
431     ($clean_func_name = $func_name) =~ s/^$self->{Prefix}//;
432     $Full_func_name = "${Packid}_$clean_func_name";
433     if ($Is_VMS) {
434       $Full_func_name = $SymSet->addsym($Full_func_name);
435     }
436
437     # Check for duplicate function definition
438     for my $tmp (@XSStack) {
439       next unless defined $tmp->{functions}{$Full_func_name};
440       Warn("Warning: duplicate function definition '$clean_func_name' detected");
441       last;
442     }
443     $XSStack[$XSS_work_idx]{functions}{$Full_func_name}++;
444     %XsubAliases = %XsubAliasValues = %Interfaces = @Attributes = ();
445     $self->{DoSetMagic} = 1;
446
447     $orig_args =~ s/\\\s*/ /g;    # process line continuations
448     my @args;
449
450     my %only_C_inlist;        # Not in the signature of Perl function
451     if ($args{argtypes} and $orig_args =~ /\S/) {
452       my $args = "$orig_args ,";
453       if ($args =~ /^( (??{ $C_arg }) , )* $ /x) {
454         @args = ($args =~ /\G ( (??{ $C_arg }) ) , /xg);
455         for ( @args ) {
456           s/^\s+//;
457           s/\s+$//;
458           my ($arg, $default) = ($_ =~ m/ ( [^=]* ) ( (?: = .* )? ) /x);
459           my ($pre, $len_name) = ($arg =~ /(.*?) \s*
460                              \b ( \w+ | length\( \s*\w+\s* \) )
461                              \s* $ /x);
462           next unless defined($pre) && length($pre);
463           my $out_type = '';
464           my $inout_var;
465           if ($args{inout} and s/^(IN|IN_OUTLIST|OUTLIST|OUT|IN_OUT)\b\s*//) {
466             my $type = $1;
467             $out_type = $type if $type ne 'IN';
468             $arg =~ s/^(IN|IN_OUTLIST|OUTLIST|OUT|IN_OUT)\b\s*//;
469             $pre =~ s/^(IN|IN_OUTLIST|OUTLIST|OUT|IN_OUT)\b\s*//;
470           }
471           my $islength;
472           if ($len_name =~ /^length\( \s* (\w+) \s* \)\z/x) {
473             $len_name = "XSauto_length_of_$1";
474             $islength = 1;
475             die "Default value on length() argument: `$_'"
476               if length $default;
477           }
478           if (length $pre or $islength) { # Has a type
479             if ($islength) {
480               push @fake_INPUT_pre, $arg;
481             }
482             else {
483               push @fake_INPUT, $arg;
484             }
485             # warn "pushing '$arg'\n";
486             $self->{argtype_seen}->{$len_name}++;
487             $_ = "$len_name$default"; # Assigns to @args
488           }
489           $only_C_inlist{$_} = 1 if $out_type eq "OUTLIST" or $islength;
490           push @outlist, $len_name if $out_type =~ /OUTLIST$/;
491           $self->{in_out}->{$len_name} = $out_type if $out_type;
492         }
493       }
494       else {
495         @args = split(/\s*,\s*/, $orig_args);
496         Warn("Warning: cannot parse argument list '$orig_args', fallback to split");
497       }
498     }
499     else {
500       @args = split(/\s*,\s*/, $orig_args);
501       for (@args) {
502         if ($args{inout} and s/^(IN|IN_OUTLIST|OUTLIST|IN_OUT|OUT)\b\s*//) {
503           my $out_type = $1;
504           next if $out_type eq 'IN';
505           $only_C_inlist{$_} = 1 if $out_type eq "OUTLIST";
506           if ($out_type =~ /OUTLIST$/) {
507               push @outlist, undef;
508           }
509           $self->{in_out}->{$_} = $out_type;
510         }
511       }
512     }
513     if (defined($class)) {
514       my $arg0 = ((defined($static) or $func_name eq 'new')
515           ? "CLASS" : "THIS");
516       unshift(@args, $arg0);
517     }
518     my $extra_args = 0;
519     my @args_num = ();
520     my $num_args = 0;
521     my $report_args = '';
522     foreach my $i (0 .. $#args) {
523       if ($args[$i] =~ s/\.\.\.//) {
524         $ellipsis = 1;
525         if ($args[$i] eq '' && $i == $#args) {
526           $report_args .= ", ...";
527           pop(@args);
528           last;
529         }
530       }
531       if ($only_C_inlist{$args[$i]}) {
532         push @args_num, undef;
533       }
534       else {
535         push @args_num, ++$num_args;
536           $report_args .= ", $args[$i]";
537       }
538       if ($args[$i] =~ /^([^=]*[^\s=])\s*=\s*(.*)/s) {
539         $extra_args++;
540         $args[$i] = $1;
541         $defaults{$args[$i]} = $2;
542         $defaults{$args[$i]} =~ s/"/\\"/g;
543       }
544       $self->{proto_arg}->[$i+1] = '$';
545     }
546     my $min_args = $num_args - $extra_args;
547     $report_args =~ s/"/\\"/g;
548     $report_args =~ s/^,\s+//;
549     my @func_args = @args;
550     shift @func_args if defined($class);
551
552     for (@func_args) {
553       s/^/&/ if $self->{in_out}->{$_};
554     }
555     $self->{func_args} = join(", ", @func_args);
556     @{ $self->{args_match} }{@args} = @args_num;
557
558     my $PPCODE = grep(/^\s*PPCODE\s*:/, @line);
559     my $CODE = grep(/^\s*CODE\s*:/, @line);
560     # Detect CODE: blocks which use ST(n)= or XST_m*(n,v)
561     #   to set explicit return values.
562     my $EXPLICIT_RETURN = ($CODE &&
563             ("@line" =~ /(\bST\s*\([^;]*=) | (\bXST_m\w+\s*\()/x ));
564
565     # The $ALIAS which follows is only explicitly called within the scope of
566     # process_file().  In principle, it ought to be a lexical, i.e., 'my
567     # $ALIAS' like the other nearby variables.  However, implementing that
568     # change produced a slight difference in the resulting .c output in at
569     # least two distributions:  B/BD/BDFOY/Crypt-Rijndael and
570     # G/GF/GFUJI/Hash-FieldHash.  The difference is, arguably, an improvement
571     # in the resulting C code.  Example:
572     # 388c388
573     # <                       GvNAME(CvGV(cv)),
574     # ---
575     # >                       "Crypt::Rijndael::encrypt",
576     # But at this point we're committed to generating the *same* C code that
577     # the current version of ParseXS.pm does.  So we're declaring it as 'our'.
578     $ALIAS  = grep(/^\s*ALIAS\s*:/,  @line);
579
580     my $INTERFACE  = grep(/^\s*INTERFACE\s*:/,  @line);
581
582     $xsreturn = 1 if $EXPLICIT_RETURN;
583
584     $externC = $externC ? qq[extern "C"] : "";
585
586     # print function header
587     print Q(<<"EOF");
588 #$externC
589 #XS(XS_${Full_func_name}); /* prototype to pass -Wmissing-prototypes */
590 #XS(XS_${Full_func_name})
591 #[[
592 ##ifdef dVAR
593 #    dVAR; dXSARGS;
594 ##else
595 #    dXSARGS;
596 ##endif
597 EOF
598     print Q(<<"EOF") if $ALIAS;
599 #    dXSI32;
600 EOF
601     print Q(<<"EOF") if $INTERFACE;
602 #    dXSFUNCTION($self->{ret_type});
603 EOF
604     if ($ellipsis) {
605       $self->{cond} = ($min_args ? qq(items < $min_args) : 0);
606     }
607     elsif ($min_args == $num_args) {
608       $self->{cond} = qq(items != $min_args);
609     }
610     else {
611       $self->{cond} = qq(items < $min_args || items > $num_args);
612     }
613
614     print Q(<<"EOF") if $args{except};
615 #    char errbuf[1024];
616 #    *errbuf = '\0';
617 EOF
618
619     if($self->{cond}) {
620       print Q(<<"EOF");
621 #    if ($self->{cond})
622 #       croak_xs_usage(cv,  "$report_args");
623 EOF
624     }
625     else {
626     # cv likely to be unused
627     print Q(<<"EOF");
628 #    PERL_UNUSED_VAR(cv); /* -W */
629 EOF
630     }
631
632     #gcc -Wall: if an xsub has PPCODE is used
633     #it is possible none of ST, XSRETURN or XSprePUSH macros are used
634     #hence `ax' (setup by dXSARGS) is unused
635     #XXX: could breakup the dXSARGS; into dSP;dMARK;dITEMS
636     #but such a move could break third-party extensions
637     print Q(<<"EOF") if $PPCODE;
638 #    PERL_UNUSED_VAR(ax); /* -Wall */
639 EOF
640
641     print Q(<<"EOF") if $PPCODE;
642 #    SP -= items;
643 EOF
644
645     # Now do a block of some sort.
646
647     $self->{condnum} = 0;
648     $self->{cond} = '';            # last CASE: condidional
649     push(@line, "$END:");
650     push(@line_no, $line_no[-1]);
651     $_ = '';
652     &check_cpp;
653     while (@line) {
654       &CASE_handler if check_keyword("CASE");
655       print Q(<<"EOF");
656 #   $args{except} [[
657 EOF
658
659       # do initialization of input variables
660       $self->{thisdone} = 0;
661       $self->{retvaldone} = 0;
662       $self->{deferred} = "";
663       %{ $self->{arg_list} } = ();
664       $self->{gotRETVAL} = 0;
665
666       INPUT_handler();
667       process_keyword("INPUT|PREINIT|INTERFACE_MACRO|C_ARGS|ALIAS|ATTRS|PROTOTYPE|SCOPE|OVERLOAD");
668
669       print Q(<<"EOF") if $self->{ScopeThisXSUB};
670 #   ENTER;
671 #   [[
672 EOF
673
674       if (!$self->{thisdone} && defined($class)) {
675         if (defined($static) or $func_name eq 'new') {
676           print "\tchar *";
677           $self->{var_types}->{"CLASS"} = "char *";
678           generate_init( {
679             type          => "char *",
680             num           => 1,
681             var           => "CLASS",
682             printed_name  => undef,
683           } );
684         }
685         else {
686           print "\t$class *";
687           $self->{var_types}->{"THIS"} = "$class *";
688           generate_init( {
689             type          => "$class *",
690             num           => 1,
691             var           => "THIS",
692             printed_name  => undef,
693           } );
694         }
695       }
696
697       # do code
698       if (/^\s*NOT_IMPLEMENTED_YET/) {
699         print "\n\tPerl_croak(aTHX_ \"$pname: not implemented yet\");\n";
700         $_ = '';
701       }
702       else {
703         if ($self->{ret_type} ne "void") {
704           print "\t" . &map_type($self->{ret_type}, 'RETVAL', $self->{hiertype}) . ";\n"
705             if !$self->{retvaldone};
706           $self->{args_match}->{"RETVAL"} = 0;
707           $self->{var_types}->{"RETVAL"} = $self->{ret_type};
708           print "\tdXSTARG;\n"
709             if $args{optimize} and $targetable{$self->{type_kind}->{$self->{ret_type}}};
710         }
711
712         if (@fake_INPUT or @fake_INPUT_pre) {
713           unshift @line, @fake_INPUT_pre, @fake_INPUT, $_;
714           $_ = "";
715           $self->{processing_arg_with_types} = 1;
716           INPUT_handler();
717         }
718         print $self->{deferred};
719
720         process_keyword("INIT|ALIAS|ATTRS|PROTOTYPE|INTERFACE_MACRO|INTERFACE|C_ARGS|OVERLOAD");
721
722         if (check_keyword("PPCODE")) {
723           print_section();
724           death ("PPCODE must be last thing") if @line;
725           print "\tLEAVE;\n" if $self->{ScopeThisXSUB};
726           print "\tPUTBACK;\n\treturn;\n";
727         }
728         elsif (check_keyword("CODE")) {
729           print_section();
730         }
731         elsif (defined($class) and $func_name eq "DESTROY") {
732           print "\n\t";
733           print "delete THIS;\n";
734         }
735         else {
736           print "\n\t";
737           if ($self->{ret_type} ne "void") {
738             print "RETVAL = ";
739             $wantRETVAL = 1;
740           }
741           if (defined($static)) {
742             if ($func_name eq 'new') {
743               $func_name = "$class";
744             }
745             else {
746               print "${class}::";
747             }
748           }
749           elsif (defined($class)) {
750             if ($func_name eq 'new') {
751               $func_name .= " $class";
752             }
753             else {
754               print "THIS->";
755             }
756           }
757           $func_name =~ s/^\Q$args{'s'}//
758             if exists $args{'s'};
759           $func_name = 'XSFUNCTION' if $self->{interface};
760           print "$func_name($self->{func_args});\n";
761         }
762       }
763
764       # do output variables
765       $self->{gotRETVAL} = 0;        # 1 if RETVAL seen in OUTPUT section;
766       undef $self->{RETVAL_code} ;    # code to set RETVAL (from OUTPUT section);
767       # $wantRETVAL set if 'RETVAL =' autogenerated
768       ($wantRETVAL, $self->{ret_type}) = (0, 'void') if $RETVAL_no_return;
769       undef %outargs;
770       process_keyword("POSTCALL|OUTPUT|ALIAS|ATTRS|PROTOTYPE|OVERLOAD");
771
772       generate_output( {
773         type        => $self->{var_types}->{$_},
774         num         => $self->{args_match}->{$_},
775         var         => $_,
776         do_setmagic => $self->{DoSetMagic},
777         do_push     => undef,
778       } ) for grep $self->{in_out}->{$_} =~ /OUT$/, keys %{ $self->{in_out} };
779
780       # all OUTPUT done, so now push the return value on the stack
781       if ($self->{gotRETVAL} && $self->{RETVAL_code}) {
782         print "\t$self->{RETVAL_code}\n";
783       }
784       elsif ($self->{gotRETVAL} || $wantRETVAL) {
785         my $t = $args{optimize} && $targetable{$self->{type_kind}->{$self->{ret_type}}};
786         # Although the '$var' declared in the next line is never explicitly
787         # used within this 'elsif' block, commenting it out leads to
788         # disaster, starting with the first 'eval qq' inside the 'elsif' block
789         # below.
790         # It appears that this is related to the fact that at this point the
791         # value of $t is a reference to an array whose [2] element includes
792         # '$var' as a substring:
793         # <i> <> <(IV)$var>
794         my $var = 'RETVAL';
795         my $type = $self->{ret_type};
796     
797         # 0: type, 1: with_size, 2: how, 3: how_size
798         if ($t and not $t->[1] and $t->[0] eq 'p') {
799           # PUSHp corresponds to setpvn.  Treate setpv directly
800           my $what = eval qq("$t->[2]");
801           warn $@ if $@;
802     
803           print "\tsv_setpv(TARG, $what); XSprePUSH; PUSHTARG;\n";
804           $prepush_done = 1;
805         }
806         elsif ($t) {
807           my $what = eval qq("$t->[2]");
808           warn $@ if $@;
809     
810           my $tsize = $t->[3];
811           $tsize = '' unless defined $tsize;
812           $tsize = eval qq("$tsize");
813           warn $@ if $@;
814           print "\tXSprePUSH; PUSH$t->[0]($what$tsize);\n";
815           $prepush_done = 1;
816         }
817         else {
818           # RETVAL almost never needs SvSETMAGIC()
819           generate_output( {
820             type        => $self->{ret_type},
821             num         => 0,
822             var         => 'RETVAL',
823             do_setmagic => 0,
824             do_push     => undef,
825           } );
826         }
827       }
828
829       $xsreturn = 1 if $self->{ret_type} ne "void";
830       my $num = $xsreturn;
831       my $c = @outlist;
832       print "\tXSprePUSH;" if $c and not $prepush_done;
833       print "\tEXTEND(SP,$c);\n" if $c;
834       $xsreturn += $c;
835       generate_output( {
836         type        => $self->{var_types}->{$_},
837         num         => $num++,
838         var         => $_,
839         do_setmagic => 0,
840         do_push     => 1,
841       } ) for @outlist;
842
843       # do cleanup
844       process_keyword("CLEANUP|ALIAS|ATTRS|PROTOTYPE|OVERLOAD");
845
846       print Q(<<"EOF") if $self->{ScopeThisXSUB};
847 #   ]]
848 EOF
849       print Q(<<"EOF") if $self->{ScopeThisXSUB} and not $PPCODE;
850 #   LEAVE;
851 EOF
852
853       # print function trailer
854       print Q(<<"EOF");
855 #    ]]
856 EOF
857       print Q(<<"EOF") if $args{except};
858 #    BEGHANDLERS
859 #    CATCHALL
860 #    sprintf(errbuf, "%s: %s\\tpropagated", Xname, Xreason);
861 #    ENDHANDLERS
862 EOF
863       if (check_keyword("CASE")) {
864         blurt ("Error: No `CASE:' at top of function")
865           unless $self->{condnum};
866         $_ = "CASE: $_";    # Restore CASE: label
867         next;
868       }
869       last if $_ eq "$END:";
870       death(/^$self->{BLOCK_re}/o ? "Misplaced `$1:'" : "Junk at end of function ($_)");
871     }
872
873     print Q(<<"EOF") if $args{except};
874 #    if (errbuf[0])
875 #    Perl_croak(aTHX_ errbuf);
876 EOF
877
878     if ($xsreturn) {
879       print Q(<<"EOF") unless $PPCODE;
880 #    XSRETURN($xsreturn);
881 EOF
882     }
883     else {
884       print Q(<<"EOF") unless $PPCODE;
885 #    XSRETURN_EMPTY;
886 EOF
887     }
888
889     print Q(<<"EOF");
890 #]]
891 #
892 EOF
893
894     $newXS = "newXS";
895     $proto = "";
896
897     # Build the prototype string for the xsub
898     if ($self->{ProtoThisXSUB}) {
899       $newXS = "newXSproto_portable";
900
901       if ($self->{ProtoThisXSUB} eq 2) {
902         # User has specified empty prototype
903       }
904       elsif ($self->{ProtoThisXSUB} eq 1) {
905         my $s = ';';
906         if ($min_args < $num_args)  {
907           $s = '';
908           $self->{proto_arg}->[$min_args] .= ";";
909         }
910         push @{ $self->{proto_arg} }, "$s\@"
911           if $ellipsis;
912     
913         $proto = join ("", grep defined, @{ $self->{proto_arg} } );
914       }
915       else {
916         # User has specified a prototype
917         $proto = $self->{ProtoThisXSUB};
918       }
919       $proto = qq{, "$proto"};
920     }
921
922     if (%XsubAliases) {
923       $XsubAliases{$pname} = 0
924         unless defined $XsubAliases{$pname};
925       while ( my ($xname, $value) = each %XsubAliases) {
926         push(@{ $self->{InitFileCode} }, Q(<<"EOF"));
927 #        cv = ${newXS}(\"$xname\", XS_$Full_func_name, file$proto);
928 #        XSANY.any_i32 = $value;
929 EOF
930       }
931     }
932     elsif (@Attributes) {
933       push(@{ $self->{InitFileCode} }, Q(<<"EOF"));
934 #        cv = ${newXS}(\"$pname\", XS_$Full_func_name, file$proto);
935 #        apply_attrs_string("$Package", cv, "@Attributes", 0);
936 EOF
937     }
938     elsif ($self->{interface}) {
939       while ( my ($yname, $value) = each %Interfaces) {
940         $yname = "$Package\::$yname" unless $yname =~ /::/;
941         push(@{ $self->{InitFileCode} }, Q(<<"EOF"));
942 #        cv = ${newXS}(\"$yname\", XS_$Full_func_name, file$proto);
943 #        $self->{interface_macro_set}(cv,$value);
944 EOF
945       }
946     }
947     elsif($newXS eq 'newXS'){ # work around P5NCI's empty newXS macro
948       push(@{ $self->{InitFileCode} },
949        "        ${newXS}(\"$pname\", XS_$Full_func_name, file$proto);\n");
950     }
951     else {
952       push(@{ $self->{InitFileCode} },
953        "        (void)${newXS}(\"$pname\", XS_$Full_func_name, file$proto);\n");
954     }
955   } # END 'PARAGRAPH' 'while' loop
956
957   if ($self->{Overload}) { # make it findable with fetchmethod
958     print Q(<<"EOF");
959 #XS(XS_${Packid}_nil); /* prototype to pass -Wmissing-prototypes */
960 #XS(XS_${Packid}_nil)
961 #{
962 #   dXSARGS;
963 #   XSRETURN_EMPTY;
964 #}
965 #
966 EOF
967     unshift(@{ $self->{InitFileCode} }, <<"MAKE_FETCHMETHOD_WORK");
968     /* Making a sub named "${Package}::()" allows the package */
969     /* to be findable via fetchmethod(), and causes */
970     /* overload::Overloaded("${Package}") to return true. */
971     (void)${newXS}("${Package}::()", XS_${Packid}_nil, file$proto);
972 MAKE_FETCHMETHOD_WORK
973   }
974
975   # print initialization routine
976
977   print Q(<<"EOF");
978 ##ifdef __cplusplus
979 #extern "C"
980 ##endif
981 EOF
982
983   print Q(<<"EOF");
984 #XS(boot_$Module_cname); /* prototype to pass -Wmissing-prototypes */
985 #XS(boot_$Module_cname)
986 EOF
987
988   print Q(<<"EOF");
989 #[[
990 ##ifdef dVAR
991 #    dVAR; dXSARGS;
992 ##else
993 #    dXSARGS;
994 ##endif
995 EOF
996
997   #Under 5.8.x and lower, newXS is declared in proto.h as expecting a non-const
998   #file name argument. If the wrong qualifier is used, it causes breakage with
999   #C++ compilers and warnings with recent gcc.
1000   #-Wall: if there is no $Full_func_name there are no xsubs in this .xs
1001   #so `file' is unused
1002   print Q(<<"EOF") if $Full_func_name;
1003 ##if (PERL_REVISION == 5 && PERL_VERSION < 9)
1004 #    char* file = __FILE__;
1005 ##else
1006 #    const char* file = __FILE__;
1007 ##endif
1008 EOF
1009
1010   print Q("#\n");
1011
1012   print Q(<<"EOF");
1013 #    PERL_UNUSED_VAR(cv); /* -W */
1014 #    PERL_UNUSED_VAR(items); /* -W */
1015 EOF
1016
1017   print Q(<<"EOF") if $self->{WantVersionChk};
1018 #    XS_VERSION_BOOTCHECK;
1019 #
1020 EOF
1021
1022   print Q(<<"EOF") if defined $self->{xsubaliases} or defined $self->{interfaces};
1023 #    {
1024 #        CV * cv;
1025 #
1026 EOF
1027
1028   print Q(<<"EOF") if ($self->{Overload});
1029 #    /* register the overloading (type 'A') magic */
1030 #    PL_amagic_generation++;
1031 #    /* The magic for overload gets a GV* via gv_fetchmeth as */
1032 #    /* mentioned above, and looks in the SV* slot of it for */
1033 #    /* the "fallback" status. */
1034 #    sv_setsv(
1035 #        get_sv( "${Package}::()", TRUE ),
1036 #        $self->{Fallback}
1037 #    );
1038 EOF
1039
1040   print @{ $self->{InitFileCode} };
1041
1042   print Q(<<"EOF") if defined $self->{xsubaliases} or defined $self->{interfaces};
1043 #    }
1044 EOF
1045
1046   if (@BootCode) {
1047     print "\n    /* Initialisation Section */\n\n";
1048     @line = @BootCode;
1049     print_section();
1050     print "\n    /* End of Initialisation Section */\n\n";
1051   }
1052
1053   print Q(<<'EOF');
1054 ##if (PERL_REVISION == 5 && PERL_VERSION >= 9)
1055 #  if (PL_unitcheckav)
1056 #       call_list(PL_scopestack_ix, PL_unitcheckav);
1057 ##endif
1058 EOF
1059
1060   print Q(<<"EOF");
1061 #    XSRETURN_YES;
1062 #]]
1063 #
1064 EOF
1065
1066   warn("Please specify prototyping behavior for $self->{filename} (see perlxs manual)\n")
1067     unless $self->{ProtoUsed};
1068
1069   chdir($orig_cwd);
1070   select($orig_fh);
1071   untie *PSEUDO_STDOUT if tied *PSEUDO_STDOUT;
1072   close $FH;
1073
1074   return 1;
1075 }
1076
1077 sub report_error_count { $self->{errors} }
1078
1079 # Input:  ($_, @line) == unparsed input.
1080 # Output: ($_, @line) == (rest of line, following lines).
1081 # Return: the matched keyword if found, otherwise 0
1082 sub check_keyword {
1083   $_ = shift(@line) while !/\S/ && @line;
1084   s/^(\s*)($_[0])\s*:\s*(?:#.*)?/$1/s && $2;
1085 }
1086
1087 sub print_section {
1088   # the "do" is required for right semantics
1089   do { $_ = shift(@line) } while !/\S/ && @line;
1090
1091   print("#line ", $line_no[@line_no - @line -1], " \"$self->{filepathname}\"\n")
1092     if $self->{WantLineNumbers} && !/^\s*#\s*line\b/ && !/^#if XSubPPtmp/;
1093   for (;  defined($_) && !/^$self->{BLOCK_re}/o;  $_ = shift(@line)) {
1094     print "$_\n";
1095   }
1096   print 'ExtUtils::ParseXS::CountLines'->end_marker, "\n" if $self->{WantLineNumbers};
1097 }
1098
1099 sub merge_section {
1100   my $in = '';
1101
1102   while (!/\S/ && @line) {
1103     $_ = shift(@line);
1104   }
1105
1106   for (;  defined($_) && !/^$self->{BLOCK_re}/o;  $_ = shift(@line)) {
1107     $in .= "$_\n";
1108   }
1109   chomp $in;
1110   return $in;
1111 }
1112
1113 sub process_keyword($) {
1114   my($pattern) = @_;
1115   my $kwd;
1116
1117   no strict 'refs';
1118   &{"${kwd}_handler"}()
1119     while $kwd = check_keyword($pattern);
1120   use strict 'refs';
1121 }
1122
1123 sub CASE_handler {
1124   blurt ("Error: `CASE:' after unconditional `CASE:'")
1125     if $self->{condnum} && $self->{cond} eq '';
1126   $self->{cond} = $_;
1127   trim_whitespace($self->{cond});
1128   print "   ", ($self->{condnum}++ ? " else" : ""), ($self->{cond} ? " if ($self->{cond})\n" : "\n");
1129   $_ = '';
1130 }
1131
1132 sub INPUT_handler {
1133   for (;  !/^$self->{BLOCK_re}/o;  $_ = shift(@line)) {
1134     last if /^\s*NOT_IMPLEMENTED_YET/;
1135     next unless /\S/;        # skip blank lines
1136
1137     trim_whitespace($_);
1138     my $ln = $_;
1139
1140     # remove trailing semicolon if no initialisation
1141     s/\s*;$//g unless /[=;+].*\S/;
1142
1143     # Process the length(foo) declarations
1144     if (s/^([^=]*)\blength\(\s*(\w+)\s*\)\s*$/$1 XSauto_length_of_$2=NO_INIT/x) {
1145       print "\tSTRLEN\tSTRLEN_length_of_$2;\n";
1146       $lengthof{$2} = undef;
1147       $self->{deferred} .= "\n\tXSauto_length_of_$2 = STRLEN_length_of_$2;\n";
1148     }
1149
1150     # check for optional initialisation code
1151     my $var_init = '';
1152     $var_init = $1 if s/\s*([=;+].*)$//s;
1153     $var_init =~ s/"/\\"/g;
1154
1155     s/\s+/ /g;
1156     my ($var_type, $var_addr, $var_name) = /^(.*?[^&\s])\s*(\&?)\s*\b(\w+)$/s
1157       or blurt("Error: invalid argument declaration '$ln'"), next;
1158
1159     # Check for duplicate definitions
1160     blurt ("Error: duplicate definition of argument '$var_name' ignored"), next
1161       if $self->{arg_list}->{$var_name}++
1162     or defined $self->{argtype_seen}->{$var_name} and not $self->{processing_arg_with_types};
1163
1164     $self->{thisdone} |= $var_name eq "THIS";
1165     $self->{retvaldone} |= $var_name eq "RETVAL";
1166     $self->{var_types}->{$var_name} = $var_type;
1167     # XXXX This check is a safeguard against the unfinished conversion of
1168     # generate_init().  When generate_init() is fixed,
1169     # one can use 2-args map_type() unconditionally.
1170     my $printed_name;
1171     if ($var_type =~ / \( \s* \* \s* \) /x) {
1172       # Function pointers are not yet supported with &output_init!
1173       print "\t" . &map_type($var_type, $var_name, $self->{hiertype});
1174       $printed_name = 1;
1175     }
1176     else {
1177       print "\t" . &map_type($var_type, undef, $self->{hiertype});
1178       $printed_name = 0;
1179     }
1180     $self->{var_num} = $self->{args_match}->{$var_name};
1181
1182     if ($self->{var_num}) {
1183       $self->{proto_arg}->[$self->{var_num}] = $self->{proto_letter}->{$var_type} || "\$";
1184     }
1185     $self->{func_args} =~ s/\b($var_name)\b/&$1/ if $var_addr;
1186     if ($var_init =~ /^[=;]\s*NO_INIT\s*;?\s*$/
1187       or $self->{in_out}->{$var_name} and $self->{in_out}->{$var_name} =~ /^OUT/
1188       and $var_init !~ /\S/) {
1189       if ($printed_name) {
1190         print ";\n";
1191       }
1192       else {
1193         print "\t$var_name;\n";
1194       }
1195     }
1196     elsif ($var_init =~ /\S/) {
1197       output_init( {
1198         type          => $var_type,
1199         num           => $self->{var_num},
1200         var           => $var_name,
1201         init          => $var_init,
1202         printed_name  => $printed_name,
1203       } );
1204     }
1205     elsif ($self->{var_num}) {
1206       generate_init( {
1207         type          => $var_type,
1208         num           => $self->{var_num},
1209         var           => $var_name,
1210         printed_name  => $printed_name,
1211       } );
1212     }
1213     else {
1214       print ";\n";
1215     }
1216   }
1217 }
1218
1219 sub OUTPUT_handler {
1220   for (;  !/^$self->{BLOCK_re}/o;  $_ = shift(@line)) {
1221     next unless /\S/;
1222     if (/^\s*SETMAGIC\s*:\s*(ENABLE|DISABLE)\s*/) {
1223       $self->{DoSetMagic} = ($1 eq "ENABLE" ? 1 : 0);
1224       next;
1225     }
1226     my ($outarg, $outcode) = /^\s*(\S+)\s*(.*?)\s*$/s;
1227     blurt ("Error: duplicate OUTPUT argument '$outarg' ignored"), next
1228       if $outargs{$outarg}++;
1229     if (!$self->{gotRETVAL} and $outarg eq 'RETVAL') {
1230       # deal with RETVAL last
1231       $self->{RETVAL_code} = $outcode;
1232       $self->{gotRETVAL} = 1;
1233       next;
1234     }
1235     blurt ("Error: OUTPUT $outarg not an argument"), next
1236       unless defined($self->{args_match}->{$outarg});
1237     blurt("Error: No input definition for OUTPUT argument '$outarg' - ignored"), next
1238       unless defined $self->{var_types}->{$outarg};
1239     $self->{var_num} = $self->{args_match}->{$outarg};
1240     if ($outcode) {
1241       print "\t$outcode\n";
1242       print "\tSvSETMAGIC(ST(" , $self->{var_num} - 1 , "));\n" if $self->{DoSetMagic};
1243     }
1244     else {
1245       generate_output( {
1246         type        => $self->{var_types}->{$outarg},
1247         num         => $self->{var_num},
1248         var         => $outarg,
1249         do_setmagic => $self->{DoSetMagic},
1250         do_push     => undef,
1251       } );
1252     }
1253     delete $self->{in_out}->{$outarg}     # No need to auto-OUTPUT
1254       if exists $self->{in_out}->{$outarg} and $self->{in_out}->{$outarg} =~ /OUT$/;
1255   }
1256 }
1257
1258 sub C_ARGS_handler() {
1259   my $in = merge_section();
1260
1261   trim_whitespace($in);
1262   $self->{func_args} = $in;
1263 }
1264
1265 sub INTERFACE_MACRO_handler() {
1266   my $in = merge_section();
1267
1268   trim_whitespace($in);
1269   if ($in =~ /\s/) {        # two
1270     ($self->{interface_macro}, $self->{interface_macro_set}) = split ' ', $in;
1271   }
1272   else {
1273     $self->{interface_macro} = $in;
1274     $self->{interface_macro_set} = 'UNKNOWN_CVT'; # catch later
1275   }
1276   $self->{interface} = 1;        # local
1277   $self->{interfaces} = 1;        # global
1278 }
1279
1280 sub INTERFACE_handler() {
1281   my $in = merge_section();
1282
1283   trim_whitespace($in);
1284
1285   foreach (split /[\s,]+/, $in) {
1286     my $iface_name = $_;
1287     $iface_name =~ s/^$self->{Prefix}//;
1288     $Interfaces{$iface_name} = $_;
1289   }
1290   print Q(<<"EOF");
1291 #    XSFUNCTION = $self->{interface_macro}($self->{ret_type},cv,XSANY.any_dptr);
1292 EOF
1293   $self->{interface} = 1;        # local
1294   $self->{interfaces} = 1;        # global
1295 }
1296
1297 sub CLEANUP_handler() { print_section() }
1298 sub PREINIT_handler() { print_section() }
1299 sub POSTCALL_handler() { print_section() }
1300 sub INIT_handler()    { print_section() }
1301
1302 sub GetAliases {
1303   my ($line) = @_;
1304   my ($orig) = $line;
1305
1306   # Parse alias definitions
1307   # format is
1308   #    alias = value alias = value ...
1309
1310   while ($line =~ s/^\s*([\w:]+)\s*=\s*(\w+)\s*//) {
1311     my ($alias, $value) = ($1, $2);
1312     my $orig_alias = $alias;
1313
1314     # check for optional package definition in the alias
1315     $alias = $self->{Packprefix} . $alias if $alias !~ /::/;
1316
1317     # check for duplicate alias name & duplicate value
1318     Warn("Warning: Ignoring duplicate alias '$orig_alias'")
1319       if defined $XsubAliases{$alias};
1320
1321     Warn("Warning: Aliases '$orig_alias' and '$XsubAliasValues{$value}' have identical values")
1322       if $XsubAliasValues{$value};
1323
1324     $self->{xsubaliases} = 1;
1325     $XsubAliases{$alias} = $value;
1326     $XsubAliasValues{$value} = $orig_alias;
1327   }
1328
1329   blurt("Error: Cannot parse ALIAS definitions from '$orig'")
1330     if $line;
1331 }
1332
1333 sub ATTRS_handler () {
1334   for (;  !/^$self->{BLOCK_re}/o;  $_ = shift(@line)) {
1335     next unless /\S/;
1336     trim_whitespace($_);
1337     push @Attributes, $_;
1338   }
1339 }
1340
1341 sub ALIAS_handler () {
1342   for (;  !/^$self->{BLOCK_re}/o;  $_ = shift(@line)) {
1343     next unless /\S/;
1344     trim_whitespace($_);
1345     GetAliases($_) if $_;
1346   }
1347 }
1348
1349 sub OVERLOAD_handler() {
1350   for (;  !/^$self->{BLOCK_re}/o;  $_ = shift(@line)) {
1351     next unless /\S/;
1352     trim_whitespace($_);
1353     while ( s/^\s*([\w:"\\)\+\-\*\/\%\<\>\.\&\|\^\!\~\{\}\=]+)\s*//) {
1354       $self->{Overload} = 1 unless $self->{Overload};
1355       my $overload = "$Package\::(".$1;
1356       push(@{ $self->{InitFileCode} },
1357        "        (void)${newXS}(\"$overload\", XS_$Full_func_name, file$proto);\n");
1358     }
1359   }
1360 }
1361
1362 sub FALLBACK_handler() {
1363   # the rest of the current line should contain either TRUE,
1364   # FALSE or UNDEF
1365
1366   trim_whitespace($_);
1367   my %map = (
1368     TRUE => "&PL_sv_yes", 1 => "&PL_sv_yes",
1369     FALSE => "&PL_sv_no", 0 => "&PL_sv_no",
1370     UNDEF => "&PL_sv_undef",
1371   );
1372
1373   # check for valid FALLBACK value
1374   death ("Error: FALLBACK: TRUE/FALSE/UNDEF") unless exists $map{uc $_};
1375
1376   $self->{Fallback} = $map{uc $_};
1377 }
1378
1379
1380 sub REQUIRE_handler () {
1381   # the rest of the current line should contain a version number
1382   my ($Ver) = $_;
1383
1384   trim_whitespace($Ver);
1385
1386   death ("Error: REQUIRE expects a version number")
1387     unless $Ver;
1388
1389   # check that the version number is of the form n.n
1390   death ("Error: REQUIRE: expected a number, got '$Ver'")
1391     unless $Ver =~ /^\d+(\.\d*)?/;
1392
1393   death ("Error: xsubpp $Ver (or better) required--this is only $VERSION.")
1394     unless $VERSION >= $Ver;
1395 }
1396
1397 sub VERSIONCHECK_handler () {
1398   # the rest of the current line should contain either ENABLE or
1399   # DISABLE
1400
1401   trim_whitespace($_);
1402
1403   # check for ENABLE/DISABLE
1404   death ("Error: VERSIONCHECK: ENABLE/DISABLE")
1405     unless /^(ENABLE|DISABLE)/i;
1406
1407   $self->{WantVersionChk} = 1 if $1 eq 'ENABLE';
1408   $self->{WantVersionChk} = 0 if $1 eq 'DISABLE';
1409
1410 }
1411
1412 sub PROTOTYPE_handler () {
1413   my $specified;
1414
1415   death("Error: Only 1 PROTOTYPE definition allowed per xsub")
1416     if $self->{proto_in_this_xsub}++;
1417
1418   for (;  !/^$self->{BLOCK_re}/o;  $_ = shift(@line)) {
1419     next unless /\S/;
1420     $specified = 1;
1421     trim_whitespace($_);
1422     if ($_ eq 'DISABLE') {
1423       $self->{ProtoThisXSUB} = 0;
1424     }
1425     elsif ($_ eq 'ENABLE') {
1426       $self->{ProtoThisXSUB} = 1;
1427     }
1428     else {
1429       # remove any whitespace
1430       s/\s+//g;
1431       death("Error: Invalid prototype '$_'")
1432         unless valid_proto_string($_);
1433       $self->{ProtoThisXSUB} = C_string($_);
1434     }
1435   }
1436
1437   # If no prototype specified, then assume empty prototype ""
1438   $self->{ProtoThisXSUB} = 2 unless $specified;
1439
1440   $self->{ProtoUsed} = 1;
1441 }
1442
1443 sub SCOPE_handler () {
1444   death("Error: Only 1 SCOPE declaration allowed per xsub")
1445     if $self->{scope_in_this_xsub}++;
1446
1447   trim_whitespace($_);
1448   death ("Error: SCOPE: ENABLE/DISABLE")
1449       unless /^(ENABLE|DISABLE)\b/i;
1450   $self->{ScopeThisXSUB} = ( uc($1) eq 'ENABLE' );
1451 }
1452
1453 sub PROTOTYPES_handler () {
1454   # the rest of the current line should contain either ENABLE or
1455   # DISABLE
1456
1457   trim_whitespace($_);
1458
1459   # check for ENABLE/DISABLE
1460   death ("Error: PROTOTYPES: ENABLE/DISABLE")
1461     unless /^(ENABLE|DISABLE)/i;
1462
1463   $self->{WantPrototypes} = 1 if $1 eq 'ENABLE';
1464   $self->{WantPrototypes} = 0 if $1 eq 'DISABLE';
1465   $self->{ProtoUsed} = 1;
1466
1467 }
1468
1469 sub PushXSStack {
1470   my %args = @_;
1471   # Save the current file context.
1472   push(@XSStack, {
1473           type            => 'file',
1474           LastLine        => $self->{lastline},
1475           LastLineNo      => $self->{lastline_no},
1476           Line            => \@line,
1477           LineNo          => \@line_no,
1478           Filename        => $self->{filename},
1479           Filepathname    => $self->{filepathname},
1480           Handle          => $FH,
1481           IsPipe          => scalar($self->{filename} =~ /\|\s*$/),
1482           %args,
1483          });
1484
1485 }
1486
1487 sub INCLUDE_handler () {
1488   # the rest of the current line should contain a valid filename
1489
1490   trim_whitespace($_);
1491
1492   death("INCLUDE: filename missing")
1493     unless $_;
1494
1495   death("INCLUDE: output pipe is illegal")
1496     if /^\s*\|/;
1497
1498   # simple minded recursion detector
1499   death("INCLUDE loop detected")
1500     if $self->{IncludedFiles}->{$_};
1501
1502   ++$self->{IncludedFiles}->{$_} unless /\|\s*$/;
1503
1504   if (/\|\s*$/ && /^\s*perl\s/) {
1505     Warn("The INCLUDE directive with a command is discouraged." .
1506          " Use INCLUDE_COMMAND instead! In particular using 'perl'" .
1507          " in an 'INCLUDE: ... |' directive is not guaranteed to pick" .
1508          " up the correct perl. The INCLUDE_COMMAND directive allows" .
1509          " the use of \$^X as the currently running perl, see" .
1510          " 'perldoc perlxs' for details.");
1511   }
1512
1513   PushXSStack();
1514
1515   $FH = Symbol::gensym();
1516
1517   # open the new file
1518   open ($FH, "$_") or death("Cannot open '$_': $!");
1519
1520   print Q(<<"EOF");
1521 #
1522 #/* INCLUDE:  Including '$_' from '$self->{filename}' */
1523 #
1524 EOF
1525
1526   $self->{filename} = $_;
1527   $self->{filepathname} = File::Spec->catfile($self->{dir}, $self->{filename});
1528
1529   # Prime the pump by reading the first
1530   # non-blank line
1531
1532   # skip leading blank lines
1533   while (<$FH>) {
1534     last unless /^\s*$/;
1535   }
1536
1537   $self->{lastline} = $_;
1538   $self->{lastline_no} = $.;
1539 }
1540
1541 sub QuoteArgs {
1542   my $cmd = shift;
1543   my @args = split /\s+/, $cmd;
1544   $cmd = shift @args;
1545   for (@args) {
1546     $_ = q(").$_.q(") if !/^\"/ && length($_) > 0;
1547   }
1548   return join (' ', ($cmd, @args));
1549 }
1550
1551 sub INCLUDE_COMMAND_handler () {
1552   # the rest of the current line should contain a valid command
1553
1554   trim_whitespace($_);
1555
1556   $_ = QuoteArgs($_) if $^O eq 'VMS';
1557
1558   death("INCLUDE_COMMAND: command missing")
1559     unless $_;
1560
1561   death("INCLUDE_COMMAND: pipes are illegal")
1562     if /^\s*\|/ or /\|\s*$/;
1563
1564   PushXSStack( IsPipe => 1 );
1565
1566   $FH = Symbol::gensym();
1567
1568   # If $^X is used in INCLUDE_COMMAND, we know it's supposed to be
1569   # the same perl interpreter as we're currently running
1570   s/^\s*\$\^X/$^X/;
1571
1572   # open the new file
1573   open ($FH, "-|", "$_")
1574     or death("Cannot run command '$_' to include its output: $!");
1575
1576   print Q(<<"EOF");
1577 #
1578 #/* INCLUDE_COMMAND:  Including output of '$_' from '$self->{filename}' */
1579 #
1580 EOF
1581
1582   $self->{filename} = $_;
1583   $self->{filepathname} = $self->{filename};
1584   $self->{filepathname} =~ s/\"/\\"/g;
1585
1586   # Prime the pump by reading the first
1587   # non-blank line
1588
1589   # skip leading blank lines
1590   while (<$FH>) {
1591     last unless /^\s*$/;
1592   }
1593
1594   $self->{lastline} = $_;
1595   $self->{lastline_no} = $.;
1596 }
1597
1598 sub PopFile() {
1599   return 0 unless $XSStack[-1]{type} eq 'file';
1600
1601   my $data     = pop @XSStack;
1602   my $ThisFile = $self->{filename};
1603   my $isPipe   = $data->{IsPipe};
1604
1605   --$self->{IncludedFiles}->{$self->{filename}}
1606     unless $isPipe;
1607
1608   close $FH;
1609
1610   $FH         = $data->{Handle};
1611   # $filename is the leafname, which for some reason isused for diagnostic
1612   # messages, whereas $filepathname is the full pathname, and is used for
1613   # #line directives.
1614   $self->{filename}   = $data->{Filename};
1615   $self->{filepathname} = $data->{Filepathname};
1616   $self->{lastline}   = $data->{LastLine};
1617   $self->{lastline_no} = $data->{LastLineNo};
1618   @line       = @{ $data->{Line} };
1619   @line_no    = @{ $data->{LineNo} };
1620
1621   if ($isPipe and $? ) {
1622     --$self->{lastline_no};
1623     print STDERR "Error reading from pipe '$ThisFile': $! in $self->{filename}, line $self->{lastline_no}\n" ;
1624     exit 1;
1625   }
1626
1627   print Q(<<"EOF");
1628 #
1629 #/* INCLUDE: Returning to '$self->{filename}' from '$ThisFile' */
1630 #
1631 EOF
1632
1633   return 1;
1634 }
1635
1636 sub check_cpp {
1637   my @cpp = grep(/^\#\s*(?:if|e\w+)/, @line);
1638   if (@cpp) {
1639     my ($cpp, $cpplevel);
1640     for $cpp (@cpp) {
1641       if ($cpp =~ /^\#\s*if/) {
1642         $cpplevel++;
1643       }
1644       elsif (!$cpplevel) {
1645         Warn("Warning: #else/elif/endif without #if in this function");
1646         print STDERR "    (precede it with a blank line if the matching #if is outside the function)\n"
1647           if $XSStack[-1]{type} eq 'if';
1648         return;
1649       }
1650       elsif ($cpp =~ /^\#\s*endif/) {
1651         $cpplevel--;
1652       }
1653     }
1654     Warn("Warning: #if without #endif in this function") if $cpplevel;
1655   }
1656 }
1657
1658
1659 sub Q {
1660   my($text) = @_;
1661   $text =~ s/^#//gm;
1662   $text =~ s/\[\[/{/g;
1663   $text =~ s/\]\]/}/g;
1664   $text;
1665 }
1666
1667 # Read next xsub into @line from ($lastline, <$FH>).
1668 sub fetch_para {
1669   # parse paragraph
1670   death ("Error: Unterminated `#if/#ifdef/#ifndef'")
1671     if !defined $self->{lastline} && $XSStack[-1]{type} eq 'if';
1672   @line = ();
1673   @line_no = ();
1674   return PopFile() if !defined $self->{lastline};
1675
1676   if ($self->{lastline} =~
1677       /^MODULE\s*=\s*([\w:]+)(?:\s+PACKAGE\s*=\s*([\w:]+))?(?:\s+PREFIX\s*=\s*(\S+))?\s*$/) {
1678     my $Module = $1;
1679     $Package = defined($2) ? $2 : ''; # keep -w happy
1680     $self->{Prefix}  = defined($3) ? $3 : ''; # keep -w happy
1681     $self->{Prefix} = quotemeta $self->{Prefix};
1682     ($Module_cname = $Module) =~ s/\W/_/g;
1683     ($Packid = $Package) =~ tr/:/_/;
1684     $self->{Packprefix} = $Package;
1685     $self->{Packprefix} .= "::" if $self->{Packprefix} ne "";
1686     $self->{lastline} = "";
1687   }
1688
1689   for (;;) {
1690     # Skip embedded PODs
1691     while ($self->{lastline} =~ /^=/) {
1692       while ($self->{lastline} = <$FH>) {
1693         last if ($self->{lastline} =~ /^=cut\s*$/);
1694       }
1695       death ("Error: Unterminated pod") unless $self->{lastline};
1696       $self->{lastline} = <$FH>;
1697       chomp $self->{lastline};
1698       $self->{lastline} =~ s/^\s+$//;
1699     }
1700     if ($self->{lastline} !~ /^\s*#/ ||
1701     # CPP directives:
1702     #    ANSI:    if ifdef ifndef elif else endif define undef
1703     #        line error pragma
1704     #    gcc:    warning include_next
1705     #   obj-c:    import
1706     #   others:    ident (gcc notes that some cpps have this one)
1707     $self->{lastline} =~ /^#[ \t]*(?:(?:if|ifn?def|elif|else|endif|define|undef|pragma|error|warning|line\s+\d+|ident)\b|(?:include(?:_next)?|import)\s*["<].*[>"])/) {
1708       last if $self->{lastline} =~ /^\S/ && @line && $line[-1] eq "";
1709       push(@line, $self->{lastline});
1710       push(@line_no, $self->{lastline_no});
1711     }
1712
1713     # Read next line and continuation lines
1714     last unless defined($self->{lastline} = <$FH>);
1715     $self->{lastline_no} = $.;
1716     my $tmp_line;
1717     $self->{lastline} .= $tmp_line
1718       while ($self->{lastline} =~ /\\$/ && defined($tmp_line = <$FH>));
1719
1720     chomp $self->{lastline};
1721     $self->{lastline} =~ s/^\s+$//;
1722   }
1723   pop(@line), pop(@line_no) while @line && $line[-1] eq "";
1724   1;
1725 }
1726
1727 sub output_init {
1728   my $argsref = shift;
1729   my ($type, $num, $var, $init, $printed_name) = (
1730     $argsref->{type},
1731     $argsref->{num},
1732     $argsref->{var},
1733     $argsref->{init},
1734     $argsref->{printed_name}
1735   );
1736   my $arg = "ST(" . ($num - 1) . ")";
1737
1738   if (  $init =~ /^=/  ) {
1739     if ($printed_name) {
1740       eval qq/print " $init\\n"/;
1741     }
1742     else {
1743       eval qq/print "\\t$var $init\\n"/;
1744     }
1745     warn $@ if $@;
1746   }
1747   else {
1748     if (  $init =~ s/^\+//  &&  $num  ) {
1749       generate_init( {
1750         type          => $type,
1751         num           => $num,
1752         var           => $var,
1753         printed_name  => $printed_name,
1754       } );
1755     }
1756     elsif ($printed_name) {
1757       print ";\n";
1758       $init =~ s/^;//;
1759     }
1760     else {
1761       eval qq/print "\\t$var;\\n"/;
1762       warn $@ if $@;
1763       $init =~ s/^;//;
1764     }
1765     $self->{deferred} .= eval qq/"\\n\\t$init\\n"/;
1766     warn $@ if $@;
1767   }
1768 }
1769
1770 sub generate_init {
1771   my $argsref = shift;
1772   my ($type, $num, $var, $printed_name) = (
1773     $argsref->{type},
1774     $argsref->{num},
1775     $argsref->{var},
1776     $argsref->{printed_name},
1777   );
1778   my $arg = "ST(" . ($num - 1) . ")";
1779   my ($argoff, $ntype, $tk);
1780   $argoff = $num - 1;
1781
1782   $type = tidy_type($type);
1783   blurt("Error: '$type' not in typemap"), return
1784     unless defined($self->{type_kind}->{$type});
1785
1786   ($ntype = $type) =~ s/\s*\*/Ptr/g;
1787   my $subtype;
1788   ($subtype = $ntype) =~ s/(?:Array)?(?:Ptr)?$//;
1789   $tk = $self->{type_kind}->{$type};
1790   $tk =~ s/OBJ$/REF/ if $func_name =~ /DESTROY$/;
1791   if ($tk eq 'T_PV' and exists $lengthof{$var}) {
1792     print "\t$var" unless $printed_name;
1793     print " = ($type)SvPV($arg, STRLEN_length_of_$var);\n";
1794     die "default value not supported with length(NAME) supplied"
1795       if defined $defaults{$var};
1796     return;
1797   }
1798   $type =~ tr/:/_/ unless $self->{hiertype};
1799   blurt("Error: No INPUT definition for type '$type', typekind '$self->{type_kind}->{$type}' found"), return
1800     unless defined $self->{input_expr}->{$tk};
1801   my $expr = $self->{input_expr}->{$tk};
1802   if ($expr =~ /DO_ARRAY_ELEM/) {
1803     blurt("Error: '$subtype' not in typemap"), return
1804       unless defined($self->{type_kind}->{$subtype});
1805     blurt("Error: No INPUT definition for type '$subtype', typekind '$self->{type_kind}->{$subtype}' found"), return
1806       unless defined $self->{input_expr}->{$self->{type_kind}->{$subtype}};
1807     my $subexpr = $self->{input_expr}->{$self->{type_kind}->{$subtype}};
1808     $subexpr =~ s/\$type/\$subtype/g;
1809     $subexpr =~ s/ntype/subtype/g;
1810     $subexpr =~ s/\$arg/ST(ix_$var)/g;
1811     $subexpr =~ s/\n\t/\n\t\t/g;
1812     $subexpr =~ s/is not of (.*\")/[arg %d] is not of $1, ix_$var + 1/g;
1813     $subexpr =~ s/\$var/${var}[ix_$var - $argoff]/;
1814     $expr =~ s/DO_ARRAY_ELEM/$subexpr/;
1815   }
1816   if ($expr =~ m#/\*.*scope.*\*/#i) {  # "scope" in C comments
1817     $self->{ScopeThisXSUB} = 1;
1818   }
1819   if (defined($defaults{$var})) {
1820     $expr =~ s/(\t+)/$1    /g;
1821     $expr =~ s/        /\t/g;
1822     if ($printed_name) {
1823       print ";\n";
1824     }
1825     else {
1826       eval qq/print "\\t$var;\\n"/;
1827       warn $@ if $@;
1828     }
1829     if ($defaults{$var} eq 'NO_INIT') {
1830       $self->{deferred} .= eval qq/"\\n\\tif (items >= $num) {\\n$expr;\\n\\t}\\n"/;
1831     }
1832     else {
1833       $self->{deferred} .= eval qq/"\\n\\tif (items < $num)\\n\\t    $var = $defaults{$var};\\n\\telse {\\n$expr;\\n\\t}\\n"/;
1834     }
1835     warn $@ if $@;
1836   }
1837   elsif ($self->{ScopeThisXSUB} or $expr !~ /^\s*\$var =/) {
1838     if ($printed_name) {
1839       print ";\n";
1840     }
1841     else {
1842       eval qq/print "\\t$var;\\n"/;
1843       warn $@ if $@;
1844     }
1845     $self->{deferred} .= eval qq/"\\n$expr;\\n"/;
1846     warn $@ if $@;
1847   }
1848   else {
1849     die "panic: do not know how to handle this branch for function pointers"
1850       if $printed_name;
1851     eval qq/print "$expr;\\n"/;
1852     warn $@ if $@;
1853   }
1854 }
1855
1856 sub generate_output {
1857   my $argsref = shift;
1858   my ($type, $num, $var, $do_setmagic, $do_push) = (
1859     $argsref->{type},
1860     $argsref->{num},
1861     $argsref->{var},
1862     $argsref->{do_setmagic},
1863     $argsref->{do_push}
1864   );
1865   my $arg = "ST(" . ($num - ($num != 0)) . ")";
1866   my $ntype;
1867
1868   $type = tidy_type($type);
1869   if ($type =~ /^array\(([^,]*),(.*)\)/) {
1870     print "\t$arg = sv_newmortal();\n";
1871     print "\tsv_setpvn($arg, (char *)$var, $2 * sizeof($1));\n";
1872     print "\tSvSETMAGIC($arg);\n" if $do_setmagic;
1873   }
1874   else {
1875     blurt("Error: '$type' not in typemap"), return
1876       unless defined($self->{type_kind}->{$type});
1877     blurt("Error: No OUTPUT definition for type '$type', typekind '$self->{type_kind}->{$type}' found"), return
1878       unless defined $self->{output_expr}->{$self->{type_kind}->{$type}};
1879     ($ntype = $type) =~ s/\s*\*/Ptr/g;
1880     $ntype =~ s/\(\)//g;
1881     my $subtype;
1882     ($subtype = $ntype) =~ s/(?:Array)?(?:Ptr)?$//;
1883     my $expr = $self->{output_expr}->{$self->{type_kind}->{$type}};
1884     if ($expr =~ /DO_ARRAY_ELEM/) {
1885       blurt("Error: '$subtype' not in typemap"), return
1886         unless defined($self->{type_kind}->{$subtype});
1887       blurt("Error: No OUTPUT definition for type '$subtype', typekind '$self->{type_kind}->{$subtype}' found"), return
1888         unless defined $self->{output_expr}->{$self->{type_kind}->{$subtype}};
1889       my $subexpr = $self->{output_expr}->{$self->{type_kind}->{$subtype}};
1890       $subexpr =~ s/ntype/subtype/g;
1891       $subexpr =~ s/\$arg/ST(ix_$var)/g;
1892       $subexpr =~ s/\$var/${var}[ix_$var]/g;
1893       $subexpr =~ s/\n\t/\n\t\t/g;
1894       $expr =~ s/DO_ARRAY_ELEM\n/$subexpr/;
1895       eval "print qq\a$expr\a";
1896       warn $@ if $@;
1897       print "\t\tSvSETMAGIC(ST(ix_$var));\n" if $do_setmagic;
1898     }
1899     elsif ($var eq 'RETVAL') {
1900       if ($expr =~ /^\t\$arg = new/) {
1901         # We expect that $arg has refcnt 1, so we need to
1902         # mortalize it.
1903         eval "print qq\a$expr\a";
1904         warn $@ if $@;
1905         print "\tsv_2mortal(ST($num));\n";
1906         print "\tSvSETMAGIC(ST($num));\n" if $do_setmagic;
1907       }
1908       elsif ($expr =~ /^\s*\$arg\s*=/) {
1909         # We expect that $arg has refcnt >=1, so we need
1910         # to mortalize it!
1911         eval "print qq\a$expr\a";
1912         warn $@ if $@;
1913         print "\tsv_2mortal(ST(0));\n";
1914         print "\tSvSETMAGIC(ST(0));\n" if $do_setmagic;
1915       }
1916       else {
1917         # Just hope that the entry would safely write it
1918         # over an already mortalized value. By
1919         # coincidence, something like $arg = &sv_undef
1920         # works too.
1921         print "\tST(0) = sv_newmortal();\n";
1922         eval "print qq\a$expr\a";
1923         warn $@ if $@;
1924         # new mortals don't have set magic
1925       }
1926     }
1927     elsif ($do_push) {
1928       print "\tPUSHs(sv_newmortal());\n";
1929       $arg = "ST($num)";
1930       eval "print qq\a$expr\a";
1931       warn $@ if $@;
1932       print "\tSvSETMAGIC($arg);\n" if $do_setmagic;
1933     }
1934     elsif ($arg =~ /^ST\(\d+\)$/) {
1935       eval "print qq\a$expr\a";
1936       warn $@ if $@;
1937       print "\tSvSETMAGIC($arg);\n" if $do_setmagic;
1938     }
1939   }
1940 }
1941
1942 sub Warn {
1943   # work out the line number
1944   my $warn_line_number = $line_no[@line_no - @line -1];
1945
1946   print STDERR "@_ in $self->{filename}, line $warn_line_number\n";
1947 }
1948
1949 sub blurt {
1950   Warn @_;
1951   $self->{errors}++
1952 }
1953
1954 sub death {
1955   Warn @_;
1956   exit 1;
1957 }
1958
1959 1;