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.