"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "Basic/Pod/PP.pod" between
PDL-2.080.tar.gz and PDL-2.081.tar.gz

About: PDL (Perl Data Language) aims to turn perl into an efficient numerical language for scientific computing (similar to IDL and MatLab).

PP.pod  (PDL-2.080)	:	PP.pod  (PDL-2.081)
skipping to change at line 1616		skipping to change at line 1616
pp_def('init_meat',		pp_def('init_meat',
Pars => 'double x(n); double y(n);',		Pars => 'double x(n); double y(n);',
OtherPars => 'gsl_spline *spl',		OtherPars => 'gsl_spline *spl',
Code =>'gsl_spline_init,($COMP(spl),$P(x),$P(y),$SIZE(n)));'		Code =>'gsl_spline_init,($COMP(spl),$P(x),$P(y),$SIZE(n)));'
);		);
where I have removed a macro wrapper call, but that would obscure the		where I have removed a macro wrapper call, but that would obscure the
discussion.		discussion.
		=head3 OtherPars as outputs
		As of 2.081, you can specify an C<OtherPar> as an output. This looks like:
		pp_def('output_op',
		Pars => 'in(n=2)',
		OtherPars => '[o] PDL_Anyval v0; [o] PDL_Anyval v1',
		Code => '
		pdl_datatypes dt = $PDL(in)->datatype;
		ANYVAL_FROM_CTYPE($COMP(v0), dt, $in(n=>0));
		ANYVAL_FROM_CTYPE($COMP(v1), dt, $in(n=>1));
		',
		);
		The passed-in stack SV will be mutated in place, so this code will then work:
		output_op([5,7], my $v0, my $v1);
		is_deeply [$v0,$v1], [5,7], 'output OtherPars work';
		An operation with output C<OtherPars> cannot broadcast, since that would
		cause undefined results. A runtime check is generated that throws an
		exception if any C<Par> would cause broadcasting.
		Note the syntax for C<OtherPars> has C<[o]> go I<before> the type, while
		it goes I<after> the type in C<Pars>. It was felt this was the best way
		to avoid ambiguity given C types can have C<[]> in them.
		This relies on the relevant C<OtherPar> having an C<OUTPUT> entry in an
		XS typemap.
=head2 Other useful PP keys in data operation definitions		=head2 Other useful PP keys in data operation definitions
You have already heard about the C<OtherPars> key. Currently, there are not		You have already heard about the C<OtherPars> key. Currently, there are not
many other keys for a data operation that will be useful in normal (whatever		many other keys for a data operation that will be useful in normal (whatever
that is) PP programming. In fact, it would be interesting to hear about		that is) PP programming. In fact, it would be interesting to hear about
a case where you think you need more than what is provided at the moment.		a case where you think you need more than what is provided at the moment.
Please speak up on one of the PDL mailing lists. Most other keys recognised		Please speak up on one of the PDL mailing lists. Most other keys recognised
by C<pp_def> are only really useful for what we call I<slice operations>		by C<pp_def> are only really useful for what we call I<slice operations>
(see also above).		(see also above).
End of changes. 1 change blocks.
0 lines changed or deleted		30 lines changed or added

---