The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Apache::FilterRec - Perl API for manipulating the Apache filter record

Synopsis

  use Apache::Filter ();
  use Apache::FilterRec ();
  
  my $frec = $filter->frec;
  print "filter name is:", $frec->name;

Description

Apache::FilterRec provides an access to the filter record structure.

The Apache::FilterRec object is retrieved by calling frec():

  $frec = $filter->frec;

API

Apache::FilterRec provides the following functions and/or methods:

name

The registered name for this filter

  $name = $frec->name();
obj: $frec ( Apache::FilterRec object )
ret: $name (string)
since: 1.99_10

mod_perl filters have four names:

  modperl_request_output
  modperl_request_input
  modperl_connection_output
  modperl_connection_input

You can see the names of the non-mod_perl filters as well. By calling $filter->next->frec->name you can get the name of the next filter in the chain.

Example:

Let's print the name of the current and the filter that follows it:

  use Apache::Filter ();
  use Apache::FilterRec ();
  for my $frec ($filter->frec, $filter->next->frec) {
      print "Name: ", $frec->name;
  }

See Also

mod_perl 2.0 documentation.

Copyright

mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.

Authors

The mod_perl development team and numerous contributors.