1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55
|
package Filter::Util::Exec ;
use strict;
require 5.006 ;
require XSLoader;
our $VERSION = "1.64" ;
XSLoader::load('Filter::Util::Exec');
1 ;
__END__
=head1 NAME
Filter::Util::Exec - exec source filter
=head1 SYNOPSIS
use Filter::Util::Exec;
=head1 DESCRIPTION
This module is provides the interface to allow the creation of I<Source
Filters> which use a Unix coprocess.
See L<Filter::exec>, L<Filter::cpp> and L<Filter::sh> for examples of
the use of this module.
Note that the size of the buffers is limited to 32-bit.
=head2 B<filter_add()>
The function, C<filter_add> installs a filter. It takes one
parameter which should be a reference. The kind of reference used will
dictate which of the two filter types will be used.
If a CODE reference is used then a I<closure filter> will be assumed.
If a CODE reference is not used, a I<method filter> will be assumed.
In a I<method filter>, the reference can be used to store context
information. The reference will be I<blessed> into the package by
C<filter_add>.
See L<Filter::Util::Call> for examples of using context information
using both I<method filters> and I<closure filters>.
=head1 AUTHOR
Paul Marquess
=head1 DATE
11th December 1995.
=cut
|