cvs: phpdoc /en/reference/dbase/functions dbase-add-record.xml dbase-close.xml dbase-create.xml dbase-delete-record.xml dbase-get-header-info.xml
dbase-get-record-with-names.xml dbase-get-record.xml dbase-numfields.xml dbase-numrecords.xml dbase-open.xml dbase-pack.xml dbase-replace-record.xml

From: Date: Sun, 06 Feb 2005 03:03:15 +0000
Subject: cvs: phpdoc /en/reference/dbase/functions dbase-add-record.xml dbase-close.xml dbase-create.xml dbase-delete-record.xml dbase-get-header-info.xml
dbase-get-record-with-names.xml dbase-get-record.xml dbase-numfields.xml dbase-numrecords.xml dbase-open.xml dbase-pack.xml dbase-replace-record.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969366382@lists.php.net to get a copy of this message
didou Sat Feb 5 22:03:15 2005 EDT Modified files: /phpdoc/en/reference/dbase/functions dbase-add-record.xml dbase-close.xml dbase-create.xml dbase-delete-record.xml dbase-get-header-info.xml dbase-get-record-with-names.xml dbase-get-record.xml dbase-numfields.xml dbase-numrecords.xml dbase-open.xml dbase-pack.xml dbase-replace-record.xml Log: WS (start at col 0)

http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-add-record.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-add-record.xml diff -u phpdoc/en/reference/dbase/functions/dbase-add-record.xml:1.4 phpdoc/en/reference/dbase/functions/dbase-add-record.xml:1.5 --- phpdoc/en/reference/dbase/functions/dbase-add-record.xml:1.4 Sat Jan 29 18:23:50 2005 +++ phpdoc/en/reference/dbase/functions/dbase-add-record.xml Sat Feb 5 22:03:14 2005 @@ -1,65 +1,65 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.dbase-add-record"> - <refnamediv> - <refname>dbase_add_record</refname> - <refpurpose>Adds a record to a database</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>dbase_add_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>array</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - Adds the given data to the database. - </para> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>dbase_identifier</parameter></term> - <listitem> - <para> - The database link identifier, returned by <function>dbase_open</function> - or <function>dbase_create</function>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>record</parameter></term> - <listitem> - <para> - An indexed array of data. The number of items must be equal to the number of - fields in the database, otherwise <function>dbase_add_record</function> - will fail. - </para> - <note> - <para> - If you're using <function>dbase_get_record</function> return value for this - parameter, remember to reset the key named <literal>deleted</literal>. - </para> - </note> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>Inserting a record in a dBase database</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<refentry id="function.dbase-add-record"> + <refnamediv> + <refname>dbase_add_record</refname> + <refpurpose>Adds a record to a database</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_add_record</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + <methodparam><type>array</type><parameter>record</parameter></methodparam> + </methodsynopsis> + <para> + Adds the given data to the database. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + The database link identifier, returned by <function>dbase_open</function> + or <function>dbase_create</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record</parameter></term> + <listitem> + <para> + An indexed array of data. The number of items must be equal to the number of + fields in the database, otherwise <function>dbase_add_record</function> + will fail. + </para> + <note> + <para> + If you're using <function>dbase_get_record</function> return value for this + parameter, remember to reset the key named <literal>deleted</literal>. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Inserting a record in a dBase database</title> + <programlisting role="php"> <![CDATA[ <?php @@ -67,31 +67,31 @@ $db = dbase_open('/tmp/test.dbf', 2); if ($db) { - dbase_add_record($db, array( - date('Ymd'), - 'Maxim Topolov', - '23', - 'max@example.com', - 'T')); - dbase_close($db); + dbase_add_record($db, array( + date('Ymd'), + 'Maxim Topolov', + '23', + 'max@example.com', + 'T')); + dbase_close($db); } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>dbase_delete_record</function></member> - <member><function>dbase_replace_record</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_delete_record</function></member> + <member><function>dbase_replace_record</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-close.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-close.xml diff -u phpdoc/en/reference/dbase/functions/dbase-close.xml:1.4 phpdoc/en/reference/dbase/functions/dbase-close.xml:1.5 --- phpdoc/en/reference/dbase/functions/dbase-close.xml:1.4 Sat Jan 29 18:23:50 2005 +++ phpdoc/en/reference/dbase/functions/dbase-close.xml Sat Feb 5 22:03:14 2005 @@ -1,48 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.dbase-close"> - <refnamediv> - <refname>dbase_close</refname> - <refpurpose>Closes a database</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>dbase_close</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Closes the given database link identifier. - </para> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>dbase_identifier</parameter></term> - <listitem> - <para> - The database link identifier, returned by <function>dbase_open</function> - or <function>dbase_create</function>. - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>Closing a dBase database file</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<refentry id="function.dbase-close"> + <refnamediv> + <refname>dbase_close</refname> + <refpurpose>Closes a database</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_close</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Closes the given database link identifier. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + The database link identifier, returned by <function>dbase_open</function> + or <function>dbase_create</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Closing a dBase database file</title> + <programlisting role="php"> <![CDATA[ <?php @@ -50,27 +50,27 @@ $db = dbase_open('/tmp/test.dbf', 0); if ($db) { - // read some data .. - - dbase_close($db); + // read some data .. + + dbase_close($db); } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>dbase_open</function></member> - <member><function>dbase_create</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_open</function></member> + <member><function>dbase_create</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-create.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-create.xml diff -u phpdoc/en/reference/dbase/functions/dbase-create.xml:1.8 phpdoc/en/reference/dbase/functions/dbase-create.xml:1.9 --- phpdoc/en/reference/dbase/functions/dbase-create.xml:1.8 Sat Jan 29 18:23:50 2005 +++ phpdoc/en/reference/dbase/functions/dbase-create.xml Sat Feb 5 22:03:14 2005 @@ -1,101 +1,101 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.dbase-create"> - <refnamediv> - <refname>dbase_create</refname> - <refpurpose>Creates a database</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>dbase_create</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>array</type><parameter>fields</parameter></methodparam> - </methodsynopsis> - <para> - <function>dbase_create</function> creates a dBase database with the given - definition. - </para> - &note.sm.uidcheck; - &note.open-basedir.func; - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>filename</parameter></term> - <listitem> - <para> - The name of the database. It can be a relative or absolute path to - the file where dBase will store your data. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>fields</parameter></term> - <listitem> - <para> - An array of arrays, each array describing the format of one field of the - database. Each field consists of a name, a character indicating the field - type, and optionally, a length, and a precision. - </para> - <note> - <para> - The fieldnames are limited in length and must not exceed 10 chars, - </para> - </note> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - Returns a database link identifier if the database is successfully created, - or &false; if an error occured. - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>Creating a dBase database file</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.dbase-create"> + <refnamediv> + <refname>dbase_create</refname> + <refpurpose>Creates a database</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_create</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>array</type><parameter>fields</parameter></methodparam> + </methodsynopsis> + <para> + <function>dbase_create</function> creates a dBase database with the given + definition. + </para> + &note.sm.uidcheck; + &note.open-basedir.func; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + The name of the database. It can be a relative or absolute path to + the file where dBase will store your data. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>fields</parameter></term> + <listitem> + <para> + An array of arrays, each array describing the format of one field of the + database. Each field consists of a name, a character indicating the field + type, and optionally, a length, and a precision. + </para> + <note> + <para> + The fieldnames are limited in length and must not exceed 10 chars, + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Returns a database link identifier if the database is successfully created, + or &false; if an error occured. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Creating a dBase database file</title> + <programlisting role="php"> <![CDATA[ <?php // database "definition" $def = array( - array("date", "D"), - array("name", "C", 50), - array("age", "N", 3, 0), - array("email", "C", 128), - array("ismember", "L") + array("date", "D"), + array("name", "C", 50), + array("age", "N", 3, 0), + array("email", "C", 128), + array("ismember", "L") ); // creation if (!dbase_create('/tmp/test.dbf', $def)) { - echo "Error, can't create the database\n"; + echo "Error, can't create the database\n"; } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>dbase_open</function></member> - <member><function>dbase_close</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_open</function></member> + <member><function>dbase_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-delete-record.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-delete-record.xml diff -u phpdoc/en/reference/dbase/functions/dbase-delete-record.xml:1.4 phpdoc/en/reference/dbase/functions/dbase-delete-record.xml:1.5 --- phpdoc/en/reference/dbase/functions/dbase-delete-record.xml:1.4 Sat Jan 29 18:23:50 2005 +++ phpdoc/en/reference/dbase/functions/dbase-delete-record.xml Sat Feb 5 22:03:14 2005 @@ -1,68 +1,68 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.dbase-delete-record"> - <refnamediv> - <refname>dbase_delete_record</refname> - <refpurpose>Deletes a record from a database</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>dbase_delete_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record_number</parameter></methodparam> - </methodsynopsis> - <para> - Marks the given record to be deleted from the database. - </para> - <note> - <para> - To actually remove the record from the database, you must also call - <function>dbase_pack</function>. - </para> - </note> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>dbase_identifier</parameter></term> - <listitem> - <para> - The database link identifier, returned by <function>dbase_open</function> - or <function>dbase_create</function>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>record_number</parameter></term> - <listitem> - <para> - An integer which spans from 1 to the number of records in the database - (as returned by <function>dbase_numrecords</function>). - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>dbase_add_record</function></member> - <member><function>dbase_replace_record</function></member> - </simplelist> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.dbase-delete-record"> + <refnamediv> + <refname>dbase_delete_record</refname> + <refpurpose>Deletes a record from a database</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_delete_record</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + <methodparam><type>int</type><parameter>record_number</parameter></methodparam> + </methodsynopsis> + <para> + Marks the given record to be deleted from the database. + </para> + <note> + <para> + To actually remove the record from the database, you must also call + <function>dbase_pack</function>. + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + The database link identifier, returned by <function>dbase_open</function> + or <function>dbase_create</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record_number</parameter></term> + <listitem> + <para> + An integer which spans from 1 to the number of records in the database + (as returned by <function>dbase_numrecords</function>). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_add_record</function></member> + <member><function>dbase_replace_record</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-get-header-info.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-get-header-info.xml diff -u phpdoc/en/reference/dbase/functions/dbase-get-header-info.xml:1.5 phpdoc/en/reference/dbase/functions/dbase-get-header-info.xml:1.6 --- phpdoc/en/reference/dbase/functions/dbase-get-header-info.xml:1.5 Sat Jan 29 18:23:50 2005 +++ phpdoc/en/reference/dbase/functions/dbase-get-header-info.xml Sat Feb 5 22:03:14 2005 @@ -1,108 +1,108 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> - <refentry id="function.dbase-get-header-info"> - <refnamediv> - <refname>dbase_get_header_info</refname> - <refpurpose>Gets the header info of a database</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>dbase_get_header_info</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Returns information on the column structure of the given database link - identifier. - </para> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>dbase_identifier</parameter></term> - <listitem> - <para> - The database link identifier, returned by <function>dbase_open</function> - or <function>dbase_create</function>. - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - An indexed array with an entry for each column in the database. The array index - starts at 0. - </para> - <para> - Each array element contains an associative array of column information, as - described here: - <variablelist> - <varlistentry> - <term>name</term> - <listitem> - <simpara> - The name of the column - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>type</term> - <listitem> - <simpara> - The human-readable name for the dbase type of the column (i.e. date, - boolean, etc) - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>length</term> - <listitem> - <simpara> - The number of bytes this column can hold - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>precision</term> - <listitem> - <simpara> - The number of digits of decimal precision for the column - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>format</term> - <listitem> - <simpara> - A suggested <function>printf</function> format specifier for the column - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>offset</term> - <listitem> - <simpara> - The byte offset of the column from the start of the row - </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - <para> - If the database header information cannot be read, &false; is returned. - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>Showing header information for a dBase database file</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.dbase-get-header-info"> + <refnamediv> + <refname>dbase_get_header_info</refname> + <refpurpose>Gets the header info of a database</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>dbase_get_header_info</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Returns information on the column structure of the given database link + identifier. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + The database link identifier, returned by <function>dbase_open</function> + or <function>dbase_create</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + An indexed array with an entry for each column in the database. The array index + starts at 0. + </para> + <para> + Each array element contains an associative array of column information, as + described here: + <variablelist> + <varlistentry> + <term>name</term> + <listitem> + <simpara> + The name of the column + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>type</term> + <listitem> + <simpara> + The human-readable name for the dbase type of the column (i.e. date, + boolean, etc) + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>length</term> + <listitem> + <simpara> + The number of bytes this column can hold + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>precision</term> + <listitem> + <simpara> + The number of digits of decimal precision for the column + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>format</term> + <listitem> + <simpara> + A suggested <function>printf</function> format specifier for the column + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term>offset</term> + <listitem> + <simpara> + The byte offset of the column from the start of the row + </simpara> + </listitem> + </varlistentry> + </variablelist> + </para> + <para> + If the database header information cannot be read, &false; is returned. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Showing header information for a dBase database file</title> + <programlisting role="php"> <![CDATA[ <?php // Path to dbase file @@ -110,7 +110,7 @@ // Open dbase file $dbh = dbase_open($db_path, 0) - or die("Error! Could not open dbase database file '$db_path'."); + or die("Error! Could not open dbase database file '$db_path'."); // Get column information $column_info = dbase_get_header_info($dbh); @@ -119,11 +119,11 @@ print_r($column_info); ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-get-record-with-names.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-get-record-with-names.xml diff -u phpdoc/en/reference/dbase/functions/dbase-get-record-with-names.xml:1.5 phpdoc/en/reference/dbase/functions/dbase-get-record-with-names.xml:1.6 --- phpdoc/en/reference/dbase/functions/dbase-get-record-with-names.xml:1.5 Sat Jan 29 18:23:50 2005 +++ phpdoc/en/reference/dbase/functions/dbase-get-record-with-names.xml Sat Feb 5 22:03:14 2005 @@ -1,109 +1,109 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> - <refentry id="function.dbase-get-record-with-names"> - <refnamediv> - <refname>dbase_get_record_with_names</refname> - <refpurpose> - Gets a record from a database as an associative array - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>dbase_get_record_with_names</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record_number</parameter></methodparam> - </methodsynopsis> - <para> - Gets a record from a dBase database as an associative array. - </para> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>dbase_identifier</parameter></term> - <listitem> - <para> - The database link identifier, returned by <function>dbase_open</function> - or <function>dbase_create</function>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>record_number</parameter></term> - <listitem> - <para> - The index of the record. - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - An associative array with the record. This will also include a key named - <literal>deleted</literal> which is set to 1 if the record has been marked - for deletion (see <function>dbase_delete_record</function>). - </para> - <para> - Each field is converted to the appropriate PHP type, except: - <itemizedlist> - <listitem> - <simpara> - Dates are left as strings. - </simpara> - </listitem> - <listitem> - <simpara> - Integers that would have caused an overflow (> 32 bits) - are returned as strings. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - On error, <function>dbase_get_record_with_names</function> will return &false; - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>Listing all the registred members in the database</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.dbase-get-record-with-names"> + <refnamediv> + <refname>dbase_get_record_with_names</refname> + <refpurpose> + Gets a record from a database as an associative array + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>dbase_get_record_with_names</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + <methodparam><type>int</type><parameter>record_number</parameter></methodparam> + </methodsynopsis> + <para> + Gets a record from a dBase database as an associative array. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + The database link identifier, returned by <function>dbase_open</function> + or <function>dbase_create</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record_number</parameter></term> + <listitem> + <para> + The index of the record. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + An associative array with the record. This will also include a key named + <literal>deleted</literal> which is set to 1 if the record has been marked + for deletion (see <function>dbase_delete_record</function>). + </para> + <para> + Each field is converted to the appropriate PHP type, except: + <itemizedlist> + <listitem> + <simpara> + Dates are left as strings. + </simpara> + </listitem> + <listitem> + <simpara> + Integers that would have caused an overflow (> 32 bits) + are returned as strings. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + On error, <function>dbase_get_record_with_names</function> will return &false; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Listing all the registred members in the database</title> + <programlisting role="php"> <![CDATA[ <?php // open in read-only mode $db = dbase_open('/tmp/test.dbf', 0); if ($db) { - $record_numbers = dbase_numrecords($db); - for ($i = 1; $i <= $record_numbers; $i++) { - $row = dbase_get_record_with_names($db, $i); - if ($row['ismember'] == 1) { - echo "Member #$i: " . trim($row['name']) . "\n"; - } - } + $record_numbers = dbase_numrecords($db); + for ($i = 1; $i <= $record_numbers; $i++) { + $row = dbase_get_record_with_names($db, $i); + if ($row['ismember'] == 1) { + echo "Member #$i: " . trim($row['name']) . "\n"; + } + } } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>dbase_get_record</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_get_record</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-get-record.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-get-record.xml diff -u phpdoc/en/reference/dbase/functions/dbase-get-record.xml:1.5 phpdoc/en/reference/dbase/functions/dbase-get-record.xml:1.6 --- phpdoc/en/reference/dbase/functions/dbase-get-record.xml:1.5 Sat Jan 29 18:23:50 2005 +++ phpdoc/en/reference/dbase/functions/dbase-get-record.xml Sat Feb 5 22:03:14 2005 @@ -1,83 +1,83 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> - <refentry id="function.dbase-get-record"> - <refnamediv> - <refname>dbase_get_record</refname> - <refpurpose> - Gets a record from a database as an indexed array - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>array</type><methodname>dbase_get_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record_number</parameter></methodparam> - </methodsynopsis> - <para> - Gets a record from athe database as an indexed array. - </para> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>dbase_identifier</parameter></term> - <listitem> - <para> - The database link identifier, returned by <function>dbase_open</function> - or <function>dbase_create</function>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>record_number</parameter></term> - <listitem> - <para> - The index of the record. - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - An indexed array with the record. This array will also include an associative - key named <literal>deleted</literal> which is set to 1 if the record has been - marked for deletion (see <function>dbase_delete_record</function>). - </para> - <para> - Each field is converted to the appropriate PHP type, except: - <itemizedlist> - <listitem> - <simpara> - Dates are left as strings. - </simpara> - </listitem> - <listitem> - <simpara> - Integers that would have caused an overflow (> 32 bits) - are returned as strings. - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - On error, <function>dbase_get_record</function> will return &false; - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>dbase_get_record_with_names</function></member> - </simplelist> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.dbase-get-record"> + <refnamediv> + <refname>dbase_get_record</refname> + <refpurpose> + Gets a record from a database as an indexed array + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>dbase_get_record</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + <methodparam><type>int</type><parameter>record_number</parameter></methodparam> + </methodsynopsis> + <para> + Gets a record from athe database as an indexed array. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + The database link identifier, returned by <function>dbase_open</function> + or <function>dbase_create</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record_number</parameter></term> + <listitem> + <para> + The index of the record. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + An indexed array with the record. This array will also include an associative + key named <literal>deleted</literal> which is set to 1 if the record has been + marked for deletion (see <function>dbase_delete_record</function>). + </para> + <para> + Each field is converted to the appropriate PHP type, except: + <itemizedlist> + <listitem> + <simpara> + Dates are left as strings. + </simpara> + </listitem> + <listitem> + <simpara> + Integers that would have caused an overflow (> 32 bits) + are returned as strings. + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + On error, <function>dbase_get_record</function> will return &false; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_get_record_with_names</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-numfields.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-numfields.xml diff -u phpdoc/en/reference/dbase/functions/dbase-numfields.xml:1.6 phpdoc/en/reference/dbase/functions/dbase-numfields.xml:1.7 --- phpdoc/en/reference/dbase/functions/dbase-numfields.xml:1.6 Sat Jan 29 18:23:50 2005 +++ phpdoc/en/reference/dbase/functions/dbase-numfields.xml Sat Feb 5 22:03:14 2005 @@ -1,78 +1,78 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.dbase-numfields"> - <refnamediv> - <refname>dbase_numfields</refname> - <refpurpose>Gets the number of fields of a database</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>dbase_numfields</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Gets the number of fields (columns) in the specified database. - </para> - <note> - <para> - Field numbers are between 0 and dbase_numfields($db)-1, - while record numbers are between 1 and dbase_numrecords($db). - </para> - </note> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>dbase_identifier</parameter></term> - <listitem> - <para> - The database link identifier, returned by <function>dbase_open</function> - or <function>dbase_create</function>. - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - The number of fields in the database, or &false; if an error occurs. - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title><function>dbase_numfields</function> Example</title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<refentry id="function.dbase-numfields"> + <refnamediv> + <refname>dbase_numfields</refname> + <refpurpose>Gets the number of fields of a database</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_numfields</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Gets the number of fields (columns) in the specified database. + </para> + <note> + <para> + Field numbers are between 0 and dbase_numfields($db)-1, + while record numbers are between 1 and dbase_numrecords($db). + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + The database link identifier, returned by <function>dbase_open</function> + or <function>dbase_create</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + The number of fields in the database, or &false; if an error occurs. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>dbase_numfields</function> Example</title> + <programlisting role="php"> <![CDATA[ <?php $rec = dbase_get_record($db, $recno); $nf = dbase_numfields($db); for ($i = 0; $i < $nf; $i++) { - echo $rec[$i], "\n"; + echo $rec[$i], "\n"; } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>dbase_numrecords</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_numrecords</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-numrecords.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-numrecords.xml diff -u phpdoc/en/reference/dbase/functions/dbase-numrecords.xml:1.4 phpdoc/en/reference/dbase/functions/dbase-numrecords.xml:1.5 --- phpdoc/en/reference/dbase/functions/dbase-numrecords.xml:1.4 Sat Jan 29 18:23:50 2005 +++ phpdoc/en/reference/dbase/functions/dbase-numrecords.xml Sat Feb 5 22:03:14 2005 @@ -1,54 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.dbase-numrecords"> - <refnamediv> - <refname>dbase_numrecords</refname> - <refpurpose>Gets the number of records in a database</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>dbase_numrecords</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Gets the number of records (rows) in the specified database. - </para> - <note> - <para> - Record numbers are between 1 and dbase_numrecords($db), - while field numbers are between 0 and dbase_numfields($db)-1. - </para> - </note> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>dbase_identifier</parameter></term> - <listitem> - <para> - The database link identifier, returned by <function>dbase_open</function> - or <function>dbase_create</function>. - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - The number of records in the database, or &false; if an error occurs. - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>Looping over all the records of the database</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<refentry id="function.dbase-numrecords"> + <refnamediv> + <refname>dbase_numrecords</refname> + <refpurpose>Gets the number of records in a database</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_numrecords</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Gets the number of records (rows) in the specified database. + </para> + <note> + <para> + Record numbers are between 1 and dbase_numrecords($db), + while field numbers are between 0 and dbase_numfields($db)-1. + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + The database link identifier, returned by <function>dbase_open</function> + or <function>dbase_create</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + The number of records in the database, or &false; if an error occurs. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Looping over all the records of the database</title> + <programlisting role="php"> <![CDATA[ <?php @@ -56,27 +56,27 @@ $db = dbase_open('/tmp/test.dbf', 0); if ($db) { - $record_numbers = dbase_numrecords($db); - for ($i = 1; $i <= $record_numbers; $i++) { - // do something here, for each record - } + $record_numbers = dbase_numrecords($db); + for ($i = 1; $i <= $record_numbers; $i++) { + // do something here, for each record + } } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>dbase_num_fields</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_num_fields</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-open.xml?r1=1.7&r2=1.8&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-open.xml diff -u phpdoc/en/reference/dbase/functions/dbase-open.xml:1.7 phpdoc/en/reference/dbase/functions/dbase-open.xml:1.8 --- phpdoc/en/reference/dbase/functions/dbase-open.xml:1.7 Fri Feb 4 11:00:58 2005 +++ phpdoc/en/reference/dbase/functions/dbase-open.xml Sat Feb 5 22:03:14 2005 @@ -1,63 +1,63 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.dbase-open"> - <refnamediv> - <refname>dbase_open</refname> - <refpurpose>Opens a database</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>dbase_open</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>int</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - <para> - <function>dbase_open</function> opens a dBase database with the given - access mode. - </para> - &note.sm.uidcheck; - &note.open-basedir.func; - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>filename</parameter></term> - <listitem> - <para> - The name of the database. It can be a relative or absolute path to - the file where dBase will store your data. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>mode</parameter></term> - <listitem> - <para> - An integer which correspond to those for the <command>open()</command> - system call (Typically 0 means read-only, 1 means write-only, and 2 - means read and write). - </para> - <note> - <para> - You can't open a dBase file in write-only mode as the function will - fail to read the headers infomation and thus you can't use 1 as - <parameter>mode</parameter>. - </para> - </note> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>Opening a dBase database file</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.dbase-open"> + <refnamediv> + <refname>dbase_open</refname> + <refpurpose>Opens a database</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_open</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>int</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + <para> + <function>dbase_open</function> opens a dBase database with the given + access mode. + </para> + &note.sm.uidcheck; + &note.open-basedir.func; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + The name of the database. It can be a relative or absolute path to + the file where dBase will store your data. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + An integer which correspond to those for the <command>open()</command> + system call (Typically 0 means read-only, 1 means write-only, and 2 + means read and write). + </para> + <note> + <para> + You can't open a dBase file in write-only mode as the function will + fail to read the headers infomation and thus you can't use 1 as + <parameter>mode</parameter>. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Opening a dBase database file</title> + <programlisting role="php"> <![CDATA[ <?php @@ -65,34 +65,34 @@ $db = dbase_open('/tmp/test.dbf', 0); if ($db) { - // read some data .. - - dbase_close($db); + // read some data .. + + dbase_close($db); } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - Returns a database link identifier if the database is successfully opened, - or &false; if an error occured. - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>dbase_create</function></member> - <member><function>dbase_close</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Returns a database link identifier if the database is successfully opened, + or &false; if an error occured. + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_create</function></member> + <member><function>dbase_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-pack.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-pack.xml diff -u phpdoc/en/reference/dbase/functions/dbase-pack.xml:1.4 phpdoc/en/reference/dbase/functions/dbase-pack.xml:1.5 --- phpdoc/en/reference/dbase/functions/dbase-pack.xml:1.4 Sat Jan 29 18:23:50 2005 +++ phpdoc/en/reference/dbase/functions/dbase-pack.xml Sat Feb 5 22:03:14 2005 @@ -1,49 +1,49 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.dbase-pack"> - <refnamediv> - <refname>dbase_pack</refname> - <refpurpose>Packs a database</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>dbase_pack</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - Packs the specified database by permanently deleting all records marked - for deletion using <function>dbase_delete_record</function>. - </para> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>dbase_identifier</parameter></term> - <listitem> - <para> - The database link identifier, returned by <function>dbase_open</function> - or <function>dbase_create</function>. - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>Emptying a dBase database</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<refentry id="function.dbase-pack"> + <refnamediv> + <refname>dbase_pack</refname> + <refpurpose>Packs a database</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_pack</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + </methodsynopsis> + <para> + Packs the specified database by permanently deleting all records marked + for deletion using <function>dbase_delete_record</function>. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + The database link identifier, returned by <function>dbase_open</function> + or <function>dbase_create</function>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Emptying a dBase database</title> + <programlisting role="php"> <![CDATA[ <?php @@ -51,29 +51,29 @@ $db = dbase_open('/tmp/test.dbf', 2); if ($db) { - $record_numbers = dbase_numrecords($db); - for ($i = 1; $i <= $record_numbers; $i++) { - dbase_delete_record($db, $i); - } - // expunge the database - dbase_pack($db); + $record_numbers = dbase_numrecords($db); + for ($i = 1; $i <= $record_numbers; $i++) { + dbase_delete_record($db, $i); + } + // expunge the database + dbase_pack($db); } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>dbase_delete_record</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_delete_record</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc/en/reference/dbase/functions/dbase-replace-record.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/reference/dbase/functions/dbase-replace-record.xml diff -u phpdoc/en/reference/dbase/functions/dbase-replace-record.xml:1.5 phpdoc/en/reference/dbase/functions/dbase-replace-record.xml:1.6 --- phpdoc/en/reference/dbase/functions/dbase-replace-record.xml:1.5 Sat Jan 29 18:23:50 2005 +++ phpdoc/en/reference/dbase/functions/dbase-replace-record.xml Sat Feb 5 22:03:14 2005 @@ -1,75 +1,75 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> - <refentry id="function.dbase-replace-record"> - <refnamediv> - <refname>dbase_replace_record</refname> - <refpurpose>Replaces a record in a database</refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>bool</type><methodname>dbase_replace_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>array</type><parameter>record</parameter></methodparam> - <methodparam><type>int</type><parameter>record_number</parameter></methodparam> - </methodsynopsis> - <para> - Replaces the given record in the database with the given data. - </para> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter>dbase_identifier</parameter></term> - <listitem> - <para> - The database link identifier, returned by <function>dbase_open</function> - or <function>dbase_create</function>. - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>record</parameter></term> - <listitem> - <para> - An indexed array of data. The number of items must be equal to the number of - fields in the database, otherwise <function>dbase_add_record</function> - will fail. - </para> - <note> - <para> - If you're using <function>dbase_get_record</function> return value for this - parameter, remember to reset the key named <literal>deleted</literal>. - </para> - </note> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>record_number</parameter></term> - <listitem> - <para> - An integer which spans from 1 to the number of records in the database - (as returned by <function>dbase_numrecords</function>). - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - <example> - <title>Updating a record in the database</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.dbase-replace-record"> + <refnamediv> + <refname>dbase_replace_record</refname> + <refpurpose>Replaces a record in a database</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_replace_record</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + <methodparam><type>array</type><parameter>record</parameter></methodparam> + <methodparam><type>int</type><parameter>record_number</parameter></methodparam> + </methodsynopsis> + <para> + Replaces the given record in the database with the given data. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + The database link identifier, returned by <function>dbase_open</function> + or <function>dbase_create</function>. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record</parameter></term> + <listitem> + <para> + An indexed array of data. The number of items must be equal to the number of + fields in the database, otherwise <function>dbase_add_record</function> + will fail. + </para> + <note> + <para> + If you're using <function>dbase_get_record</function> return value for this + parameter, remember to reset the key named <literal>deleted</literal>. + </para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record_number</parameter></term> + <listitem> + <para> + An integer which spans from 1 to the number of records in the database + (as returned by <function>dbase_numrecords</function>). + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Updating a record in the database</title> + <programlisting role="php"> <![CDATA[ <?php @@ -77,36 +77,36 @@ $db = dbase_open('/tmp/test.dbf', 2); if ($db) { - // gets the old row - $row = dbase_get_record_with_names($db, 1); - - // remove the 'deleted' entry - unset($row['deleted']); - - // Update the date field with the current timestamp - $row['date'] = date('Ymd'); - - // Replace the record - dbase_replace_record($db, $row, 1); - dbase_close($db); + // gets the old row + $row = dbase_get_record_with_names($db, 1); + + // remove the 'deleted' entry + unset($row['deleted']); + + // Update the date field with the current timestamp + $row['date'] = date('Ymd'); + + // Replace the record + dbase_replace_record($db, $row, 1); + dbase_close($db); } ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function>dbase_add_record</function></member> - <member><function>dbase_delete_record</function></member> - </simplelist> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_add_record</function></member> + <member><function>dbase_delete_record</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables:
« previous php.doc (#969366382) next »