stas 2004/08/14 23:26:50
Modified: src/docs/2.0/api/APR Bucket.pod
Log:
help to visualize what methods do
Revision Changes Path
1.11 +22 -5 modperl-docs/src/docs/2.0/api/APR/Bucket.pod
Index: Bucket.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/Bucket.pod,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -u -r1.10 -r1.11
--- Bucket.pod 13 Aug 2004 02:03:24 -0000 1.10
+++ Bucket.pod 15 Aug 2004 06:26:50 -0000 1.11
@@ -8,10 +8,11 @@
=head1 Synopsis
use APR::Bucket ();
+ my $ba = $c->bucket_alloc;
$b1 = APR::Bucket->new("aaa");
- $b2 = APR::Bucket::eos_create($c->bucket_alloc);
- $b3 = APR::Bucket::flush_create($c->bucket_alloc);
+ $b2 = APR::Bucket::eos_create($ba);
+ $b3 = APR::Bucket::flush_create($ba);
$b2->is_eos;
$b3->is_flush;
@@ -25,15 +26,31 @@
$b1->remove();
+=head1 Description
+C<APR::Bucket> allows you to create, manipulate and delete APR
+buckets.
+You will probably find the various insert methods confusing, the tip
+is to read the function right to left. The following code sample helps
+to visualize the operations:
+
+ my $bb = APR::Brigade->new($r->pool, $ba);
+ my $d1 = APR::Bucket->new("d1");
+ my $d2 = APR::Bucket->new("d2");
+ my $f1 = APR::Bucket::flush_create($ba);
+ my $f2 = APR::Bucket::flush_create($ba);
+ my $e1 = APR::Bucket::eos_create($ba);
+ # head->tail
+ $bb->insert_head( $d1); # head->d1->tail
+ $d1->insert_after( $d2); # head->d1->d2->tail
+ $d2->insert_before($f1); # head->d1->f1->d2->tail
+ $d2->insert_after( $f2); # head->d1->f1->d2->f2->tail
+ $bb->insert_tail( $e1); # head->d1->f1->d2->f2->e1->tail
-=head1 Description
-C<APR::Bucket> allows you to create, manipulate and delete APR
-buckets.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
