Author: stas
Date: Tue Feb 15 15:13:19 2005
New Revision: 153974
URL: http://svn.apache.org/viewcvs?view=rev&rev=153974
Log:
explain what kind of data is stored in APR::Table and what are the
side-effects (the loss of meta data)
Modified:
perl/modperl/docs/trunk/src/docs/2.0/api/APR/Table.pod
Modified: perl/modperl/docs/trunk/src/docs/2.0/api/APR/Table.pod
URL:
http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/api/APR/Table.pod?view=diff&r1=153973&r2=153974
==============================================================================
--- perl/modperl/docs/trunk/src/docs/2.0/api/APR/Table.pod (original)
+++ perl/modperl/docs/trunk/src/docs/2.0/api/APR/Table.pod Tue Feb 15 15:13:19
2005
@@ -48,6 +48,15 @@
C<APR::Table> allows its users to manipulate opaque string-content
tables.
+On the C level the "opaque string-content" means: you can put in
+'\0'-terminated strings and whatever you put in your get out.
+
+On the Perl level that means that we convert scalars into strings and
+store those strings. Any special information that was in the Perl
+scalar is not stored. So for example if a scalar was marked as utf8,
+tainted or tied, that information is not stored. When you get the data
+back as a Perl scalar you get only the string.
+
The table's structure is somewhat similar to the Perl's hash
structure, but allows multiple values for the same key. An access to
the records stored in the table always requires a key.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
