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

NAME

APR::Pool - Perl API for XXX

Synopsis

  use APR::Pool ();

META: to be completed

Description

META: to be completed

API

APR::Pool provides the following functions and/or methods:

cleanup_for_exec

META: Autogenerated - needs to be reviewed/completed

buffers, *don't* wait for subprocesses, and *don't* free any memory. * Run all of the child_cleanups, so that any unnecessary files are closed because we are about to exec a new program

ret: no return value

clear

META: Autogenerated - needs to be reviewed/completed

Clear all memory in the pool and run all the cleanups. This also destroys all subpools.

  $p->clear();
arg1: $p (APR::Pool)

The pool to clear

ret: no return value

This does not actually free the memory, it just allows the pool to re-use this memory for the next allocation.

destroy

META: Autogenerated - needs to be reviewed/completed

Destroy the pool. This takes similar action as apr_pool_clear() and then frees all the memory.

  $p->destroy();
arg1: $p (APR::Pool)

The pool to destroy

ret: no return value

This will actually free the memory

is_ancestor

META: Autogenerated - needs to be reviewed/completed

Determine if pool a is an ancestor of pool b

  $ret = $a->is_ancestor($b);
arg1: $a (APR::Pool)

The pool to search

arg2: $b (APR::Pool)

The pool to search for

ret: $ret (integer)

True if a is an ancestor of b, NULL is considered an ancestor of all pools.

tag

META: Autogenerated - needs to be reviewed/completed

Tag a pool (give it a name)

  $pool->tag($tag);
arg1: $pool (APR::Pool)

The pool to tag

arg2: $tag (string)

The tag

ret: no return value

See Also

mod_perl 2.0 documentation.

Copyright

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

Authors

The mod_perl development team and numerous contributors.