NAME

Apache::Table - Perl interface to the Apache table structure

SYNOPSIS

    use Apache::Table ();
    my $headers_out = $r->headers_out;
    while(my($key,$val) = each %$headers_out) {
    ...
    }
    my $table = $r->headers_out;
    $table->set(From => 'dougm@perl.apache.org');

mod_perl needs to be compiled with at least one of the following options:

 DYNAMIC=1
 PERL_TABLE_API=1
 EVERYTHING=1

DESCRIPTION

This module provides tied interfaces to Apache data structures.

CLASSES

Apache::Table

The Apache::Table class provides methods for interfacing with the Apache table structure. The following Apache class methods, when called in a scalar context with no "key" argument, will return a HASH reference blessed into the Apache::Table class and where HASH is tied to Apache::Table:

 headers_in
 headers_out
 err_headers_out
 notes
 dir_config
 subprocess_env

METHODS

get

Corresponds to the ap_table_get function.

    my $value = $table->get($key);
    my $value = $headers_out->{$key};
set

Corresponds to the ap_table_set function.

    $table->set($key, $value);
    $headers_out->{$key} = $value;
unset

Corresponds to the ap_table_unset function.

    $table->unset($key);
    delete $headers_out->{$key};
clear

Corresponds to the ap_table_clear function.

    $table->clear;
    %$headers_out = ();
add

Corresponds to the ap_table_add function.

    $table->add($key, $value);
merge

Corresponds to the ap_table_merge function.

    $table->merge($key, $value);

AUTHOR

Doug MacEachern

SEE ALSO

Apache(3), mod_perl(3)