helly Thu Nov 13 04:40:08 2003 EDT
Added files:
/phpdoc/en/reference/dba/functions dba-key-split.xml
Modified files:
/phpdoc/en/reference/dba reference.xml
/phpdoc/en/reference/dba/functions dba-fetch.xml dba-firstkey.xml
dba-nextkey.xml
Log:
Update inifile and new function dba_key_split()
Index: phpdoc/en/reference/dba/reference.xml
diff -u phpdoc/en/reference/dba/reference.xml:1.11
phpdoc/en/reference/dba/reference.xml:1.12
--- phpdoc/en/reference/dba/reference.xml:1.11 Fri Jan 24 07:58:51 2003
+++ phpdoc/en/reference/dba/reference.xml Thu Nov 13 04:40:08 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.11 $ -->
+<!-- $Revision: 1.12 $ -->
<reference id="ref.dba">
<title>Database (dbm-style) abstraction layer functions</title>
<titleabbrev>dba</titleabbrev>
@@ -119,6 +119,20 @@
<link linkend="ref.dbm">dbm</link> extension only and should be avoided.
However you may use this where files were created in this format. That
happens when configure could not find any external library.
+ </entry>
+ </row>
+
+ <row>
+ <entry><literal>flatfile</literal></entry>
+ <entry>
+ This is available since PHP 4.3.3 to be able to modify php.ini files
+ from within php scripts. When working with ini files you can pass arrays
+ of the form array(0=>group,1=>value_name) or strings of the form
+ "[group]value_name" where group is optional. As the functions
+ <function>dba_firstkey</function> and <function>dba_nextkey</function>
+ return string representations of the key there is a new function
+ <function>dba_key_split</function> available since PHP 5 which allows
+ to convert the string keys into array keys without loosing &false;.
</entry>
</row>
Index: phpdoc/en/reference/dba/functions/dba-fetch.xml
diff -u phpdoc/en/reference/dba/functions/dba-fetch.xml:1.5
phpdoc/en/reference/dba/functions/dba-fetch.xml:1.6
--- phpdoc/en/reference/dba/functions/dba-fetch.xml:1.5 Tue Jul 8 04:48:45 2003
+++ phpdoc/en/reference/dba/functions/dba-fetch.xml Thu Nov 13 04:40:08 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 -->
<refentry id="function.dba-fetch">
<refnamediv>
@@ -44,13 +44,22 @@
<para>
See also: <function>dba_exists</function>,
<function>dba_delete</function>, <function>dba_insert</function>,
- and <function>dba_replace</function>.
+ <function>dba_replace</function> and <function>dba_key_split</function>.
</para>
<para>
<note>
<simpara>
The skip parameter is available since PHP 4.3 to support cdb's
capability of multiple keys having the same name.
+ </simpara>
+ </note>
+ </para>
+ <para>
+ <note>
+ <simpara>
+ When working with inifiles this function accepts arrays as keys
+ where index 0 is the group and index 1 is the value name. See:
+ <function>dba_key_split</function>.
</simpara>
</note>
</para>
Index: phpdoc/en/reference/dba/functions/dba-firstkey.xml
diff -u phpdoc/en/reference/dba/functions/dba-firstkey.xml:1.3
phpdoc/en/reference/dba/functions/dba-firstkey.xml:1.4
--- phpdoc/en/reference/dba/functions/dba-firstkey.xml:1.3 Thu Apr 25 17:45:45
2002
+++ phpdoc/en/reference/dba/functions/dba-firstkey.xml Thu Nov 13 04:40:08 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 -->
<refentry id="function.dba-firstkey">
<refnamediv>
@@ -28,7 +28,7 @@
</para>
<para>
See also:
- <function>dba_nextkey</function>
+ <function>dba_firstkey</function>, <function>dba_key_split</function>
and example 2 in the <link linkend="dba.examples">DBA examples</link>
</para>
</refsect1>
Index: phpdoc/en/reference/dba/functions/dba-nextkey.xml
diff -u phpdoc/en/reference/dba/functions/dba-nextkey.xml:1.3
phpdoc/en/reference/dba/functions/dba-nextkey.xml:1.4
--- phpdoc/en/reference/dba/functions/dba-nextkey.xml:1.3 Thu Apr 25 17:45:45
2002
+++ phpdoc/en/reference/dba/functions/dba-nextkey.xml Thu Nov 13 04:40:08 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
<!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 -->
<refentry id="function.dba-nextkey">
<refnamediv>
@@ -27,7 +27,7 @@
</para>
<para>
See also:
- <function>dba_firstkey</function>
+ <function>dba_firstkey</function>, <function>dba_key_split</function>
and example 2 in the <link linkend="dba.examples">DBA examples</link>
</para>
</refsect1>
Index: phpdoc/en/reference/dba/functions/dba-key-split.xml
+++ phpdoc/en/reference/dba/functions/dba-key-split.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 -->
<refentry id="function.dba-key-split">
<refnamediv>
<refname>dba_key_split</refname>
<refpurpose>Splits a key in string representation into array
representation</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>array|false</type><methodname>dba_key_split</methodname>
<methodparam><type>string|false</type><parameter>key</parameter></methodparam>
</methodsynopsis>
<para>
<function>dba_key_split</function> returns &false; if key is NULL of
&false; or an array of the form array(0=>group,1=>value_name).
</para>
<para>
<parameter>key</parameter> the key in string representation.
</para>
<para>
See also:
<function>dba_firstkey</function>, <function>dba_nextkey</function>
and <function>dba_fetch</function>.
</para>
<para>
<note>
<simpara>
This function is available since PHP 5.0.0.
</simpara>
</note>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
