geoff 2003/08/19 12:31:28
Modified: src/docs/2.0/api/APR Const.pod Table.pod
Log:
added APR::Table::compress()
minor constant tweaks
Revision Changes Path
1.2 +2 -1 modperl-docs/src/docs/2.0/api/APR/Const.pod
Index: Const.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/Const.pod,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- Const.pod 15 May 2003 04:04:05 -0000 1.1
+++ Const.pod 19 Aug 2003 19:31:28 -0000 1.2
@@ -565,7 +565,8 @@
use APR::Const -compile qw(:table);
-The C<:table> group is for XXX constants.
+The C<:table> group is for C<overlap()> and C<compress()> constants.
+See C<L<APR::Table|docs::2.0::api::APR::Table>> for details.
=head3 C<APR::OVERLAP_TABLES_MERGE>
1.3 +25 -2 modperl-docs/src/docs/2.0/api/APR/Table.pod
Index: Table.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/APR/Table.pod,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- Table.pod 5 Jun 2003 06:37:39 -0000 1.2
+++ Table.pod 19 Aug 2003 19:31:28 -0000 1.3
@@ -224,10 +224,10 @@
param C<$flags>: How to add the C<$table_b> to C<$table_a>.
-When C<$flags> == C<APR_OVERLAP_TABLES_SET>, if another element
+When C<$flags> == C<APR::OVERLAP_TABLES_SET>, if another element
already exists with the same key, this will over-write the old data.
-When C<$flags> == C<APR_OVERLAP_TABLES_MERGE>, the key/value pair from
+When C<$flags> == C<APR::OVERLAP_TABLES_MERGE>, the key/value pair from
C<$table_b> is added, regardless of whether there is another element
with the same key in C<$table_a>.
@@ -249,6 +249,29 @@
param C<$table_base>: The table to add at the end of the new table
return: A new table containing all of the data from the two passed in
+
+=item * compress()
+
+ compress($table, $flag);
+
+Compress the data in C<$table>. This function takes duplicate
+table entries and flattens them into a single entry. The
+flattening behavior is controlled by the flag.
+
+param C<$table>: The table to add the data to.
+
+param C<$flag>: How to compress C<$table>.
+
+When C<$flag> == C<APR::OVERLAP_TABLES_SET>, each key will be
+set to the last value seen for that key. For example, given
+key/value pairs 'foo => bar' and 'foo => baz', 'foo' would
+have a final value of 'baz' after compression - the 'bar'
+value would be lost.
+
+When C<$flag> == C<APR::OVERLAP_TABLES_MERGE>, multiple values
+for the same key are flattened into a comma-separated list.
+Given key/value pairs 'foo => bar' and 'foo => baz', 'foo'
+would have a final value of 'bar, baz' after compression.
=back
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
