cvs: phpdoc /en/reference/mysqli/functions mysqli-affected-rows.xml mysqli-autocommit.xml mysqli-bind-param.xml mysqli-bind-result.xml
mysqli-change-user.xml mysqli-character-set-name.xml mysqli-client-encoding.xml mysqli-close.xml mysqli-commit.xml mysqli-connect-errno.xml
mysqli-connect-error.xml mysqli-connect.xml mysqli-data-seek.xml mysqli-debug.xml mysqli-disable-reads-from-master.xml mysqli-disable-rpl-parse.xml
mysqli-dump-debug-info.xml mysqli-embedded-connect.xml mysqli-enable-reads-from-master.xml mysqli-enable-rpl-parse.xml mysqli-errno.xml
mysqli-error.xml mysqli-escape-string.xml mysqli-execute.xml mysqli-fetch-array.xml mysqli-fetch-assoc.xml mysqli-fetch-field-direct.xml
mysqli-fetch-field.xml mysqli-fetch-fields.xml mysqli-fetch-lengths.xml mysqli-fetch-object.xml mysqli-fetch-row.xml mysqli-fetch.xml
mysqli-field-count.xml mysqli-field-seek.xml mysqli-field-tell.xml mysqli-free-result.xml mysqli-get-client-info.xml mysqli-get-client-version.xml
mys! qli-get-host-info.xml mysqli-get-metadata.xml mysqli-get-proto-info.xml mysqli-get-server-info.xml mysqli-get-server-version.xml mysqli-info.xml
mysqli-init.xml mysqli-insert-id.xml mysqli-kill.xml mysqli-master-query.xml mysqli-more-results.xml mysqli-multi-query.xml mysqli-next-result.xml
mysqli-num-fields.xml mysqli-num-rows.xml mysqli-options.xml mysqli-param-count.xml mysqli-ping.xml mysqli-prepare.xml mysqli-query.xml
mysqli-real-connect.xml mysqli-real-escape-string.xml mysqli-real-query.xml mysqli-report.xml mysqli-rollback.xml mysqli-rpl-parse-enabled.xml
mysqli-rpl-probe.xml mysqli-rpl-query-type.xml mysqli-select-db.xml mysqli-send-long-data.xml mysqli-send-query.xml mysqli-server-end.xml
mysqli-server-init.xml mysqli-set-charset.xml mysqli-set-opt.xml mysqli-sqlstate.xml mysqli-ssl-set.xml mysqli-stat.xml mysqli-stmt-affected-rows.xml
mysqli-stmt-bind-param.xml mysqli-stmt-bind-result.xml mysqli-stmt-close.xml mysqli-stmt-data-seek.xml mysqli-stmt-errno.xml mysq! li-stmt-error.xml
mysqli-stmt-execute.xml mysqli-stmt-fetch.xml mysqli-stmt-free-result.xml mysqli-stmt-init.xml mysqli-stmt-num-rows.xml mysqli-stmt-param-count.xml
mysqli-stmt-prepare.xml mysqli-stmt-reset.xml mysqli-stmt-result-metadata.xml mysqli-stmt-send-long-data.xml mysqli-stmt-sqlstate.xml
mysqli-stmt-store-result.x

didou Sat Jan 27 17:37:37 2007 UTC Modified files: /phpdoc/en/reference/mysqli/functions mysqli-affected-rows.xml mysqli-autocommit.xml mysqli-bind-param.xml mysqli-bind-result.xml mysqli-change-user.xml mysqli-character-set-name.xml mysqli-client-encoding.xml mysqli-close.xml mysqli-commit.xml mysqli-connect-errno.xml mysqli-connect-error.xml mysqli-connect.xml mysqli-data-seek.xml mysqli-debug.xml mysqli-disable-reads-from-master.xml mysqli-disable-rpl-parse.xml mysqli-dump-debug-info.xml mysqli-embedded-connect.xml mysqli-enable-reads-from-master.xml mysqli-enable-rpl-parse.xml mysqli-errno.xml mysqli-error.xml mysqli-escape-string.xml mysqli-execute.xml mysqli-fetch-array.xml mysqli-fetch-assoc.xml mysqli-fetch-field-direct.xml mysqli-fetch-field.xml mysqli-fetch-fields.xml mysqli-fetch-lengths.xml mysqli-fetch-object.xml mysqli-fetch-row.xml mysqli-fetch.xml mysqli-field-count.xml mysqli-field-seek.xml mysqli-field-tell.xml mysqli-free-result.xml mysqli-get-client-info.xml mysqli-get-client-version.xml mysqli-get-host-info.xml mysqli-get-metadata.xml mysqli-get-proto-info.xml mysqli-get-server-info.xml mysqli-get-server-version.xml mysqli-info.xml mysqli-init.xml mysqli-insert-id.xml mysqli-kill.xml mysqli-master-query.xml mysqli-more-results.xml mysqli-multi-query.xml mysqli-next-result.xml mysqli-num-fields.xml mysqli-num-rows.xml mysqli-options.xml mysqli-param-count.xml mysqli-ping.xml mysqli-prepare.xml mysqli-query.xml mysqli-real-connect.xml mysqli-real-escape-string.xml mysqli-real-query.xml mysqli-report.xml mysqli-rollback.xml mysqli-rpl-parse-enabled.xml mysqli-rpl-probe.xml mysqli-rpl-query-type.xml mysqli-select-db.xml mysqli-send-long-data.xml mysqli-send-query.xml mysqli-server-end.xml mysqli-server-init.xml mysqli-set-charset.xml mysqli-set-opt.xml mysqli-sqlstate.xml mysqli-ssl-set.xml mysqli-stat.xml mysqli-stmt-affected-rows.xml mysqli-stmt-bind-param.xml mysqli-stmt-bind-result.xml mysqli-stmt-close.xml mysqli-stmt-data-seek.xml mysqli-stmt-errno.xml mysqli-stmt-error.xml mysqli-stmt-execute.xml mysqli-stmt-fetch.xml mysqli-stmt-free-result.xml mysqli-stmt-init.xml mysqli-stmt-num-rows.xml mysqli-stmt-param-count.xml mysqli-stmt-prepare.xml mysqli-stmt-reset.xml mysqli-stmt-result-metadata.xml mysqli-stmt-send-long-data.xml mysqli-stmt-sqlstate.xml mysqli-stmt-store-result.xml mysqli-store-result.xml mysqli-thread-id.xml mysqli-thread-safe.xml mysqli-use-result.xml mysqli-warning-count.xml Log: WS, prepare for new doc style

http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-affected-rows.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-affected-rows.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-affected-rows.xml:1.21 phpdoc/en/reference/mysqli/functions/mysqli-affected-rows.xml:1.22 --- phpdoc/en/reference/mysqli/functions/mysqli-affected-rows.xml:1.21 Mon Jan 22 02:48:08 2007 +++ phpdoc/en/reference/mysqli/functions/mysqli-affected-rows.xml Sat Jan 27 17:37:35 2007 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> - <refentry id="function.mysqli-affected-rows"> +<!-- $Revision: 1.22 $ --> +<refentry id="function.mysqli-affected-rows"> <refnamediv> <refname>mysqli_affected_rows</refname> <refname>mysqli->affected_rows</refname> @@ -19,7 +19,7 @@ <fieldsynopsis><type>int</type><varname>affected_rows</varname></fieldsynopsis> </classsynopsis> <para> - <function>mysqli_affected_rows</function> returns the number of rows affected by the last + <function>mysqli_affected_rows</function> returns the number of rows affected by the last INSERT, UPDATE, REPLACE or DELETE query associated with the provided <parameter>link</parameter> parameter. If the last query was invalid, this function will return -1. </para> @@ -32,12 +32,12 @@ <refsect1> &reftitle.returnvalues; <para> - An integer greater than zero indicates the number of rows affected or retrieved. - Zero indicates that no records where updated for an UPDATE statement, no rows matched - the WHERE clause in the query or that no query has yet been executed. + An integer greater than zero indicates the number of rows affected or retrieved. + Zero indicates that no records where updated for an UPDATE statement, no rows matched + the WHERE clause in the query or that no query has yet been executed. -1 indicates that the query returned an error. </para> - <note> + <note> <para> If the number of affected rows is greater than maximal int value, the number of affected rows will be returned as a string. @@ -135,7 +135,7 @@ ?> ]]> </programlisting> - </example> + </example> &example.outputs; <screen> <![CDATA[ http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-autocommit.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-autocommit.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-autocommit.xml:1.18 phpdoc/en/reference/mysqli/functions/mysqli-autocommit.xml:1.19 --- phpdoc/en/reference/mysqli/functions/mysqli-autocommit.xml:1.18 Thu Dec 16 08:47:55 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-autocommit.xml Sat Jan 27 17:37:35 2007 @@ -1,61 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> - <refentry id="function.mysqli-autocommit"> - <refnamediv> - <refname>mysqli_autocommit</refname> - <refname>mysqli->autocommit</refname> - <refpurpose>Turns on or off auto-commiting database modifications</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_autocommit</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>bool</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method)</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>autocommit</methodname> - <methodparam><type>bool</type><parameter>mode</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - <function>mysqli_autocommit</function> is used to turn on or off auto-commit mode - on queries for the database connection represented by the <parameter>link</parameter> - object. - </para> - <note> - <para> - <function>mysqli_autocommit</function> doesn't work with non transactional - table types (like MyISAM or ISAM). - </para> - <para> - To determine the current state of autocommit use the SQL command - 'SELECT @@autocommit'. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_commit</function>&listendand; - <function>mysqli_rollback</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.19 $ --> +<refentry id="function.mysqli-autocommit"> + <refnamediv> + <refname>mysqli_autocommit</refname> + <refname>mysqli->autocommit</refname> + <refpurpose>Turns on or off auto-commiting database modifications</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_autocommit</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>bool</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method)</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>autocommit</methodname> + <methodparam><type>bool</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + <function>mysqli_autocommit</function> is used to turn on or off auto-commit mode + on queries for the database connection represented by the <parameter>link</parameter> + object. + </para> + <note> + <para> + <function>mysqli_autocommit</function> doesn't work with non transactional + table types (like MyISAM or ISAM). + </para> + <para> + To determine the current state of autocommit use the SQL command + 'SELECT @@autocommit'. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_commit</function>&listendand; + <function>mysqli_rollback</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -78,11 +78,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -105,16 +105,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Autocommit is 1 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-bind-param.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-bind-param.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-bind-param.xml:1.11 phpdoc/en/reference/mysqli/functions/mysqli-bind-param.xml:1.12 --- phpdoc/en/reference/mysqli/functions/mysqli-bind-param.xml:1.11 Sun Oct 31 16:05:09 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-bind-param.xml Sat Jan 27 17:37:35 2007 @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> - <refentry id="function.mysqli-bind-param"> - <refnamediv> - <refname>mysqli_bind_param</refname> - <refpurpose>Alias for <function>mysqli_stmt_bind_param</function></refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para> - This function is an alias of <function>mysqli_stmt_bind_param</function>. - For a detailled descripton see description of - <function>mysqli_stmt_bind_param</function>. - </para> - <note> - <para> - <function>mysqli_bind_param</function> is deprecated and will be removed. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_bind_param</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.12 $ --> +<refentry id="function.mysqli-bind-param"> + <refnamediv> + <refname>mysqli_bind_param</refname> + <refpurpose>Alias for <function>mysqli_stmt_bind_param</function></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + This function is an alias of <function>mysqli_stmt_bind_param</function>. + For a detailled descripton see description of + <function>mysqli_stmt_bind_param</function>. + </para> + <note> + <para> + <function>mysqli_bind_param</function> is deprecated and will be removed. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_bind_param</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-bind-result.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-bind-result.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-bind-result.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-bind-result.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-bind-result.xml:1.8 Sun Oct 31 16:05:09 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-bind-result.xml Sat Jan 27 17:37:35 2007 @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-bind-result"> - <refnamediv> - <refname>mysqli_bind_result</refname> - <refpurpose>Alias for <function>mysqli_stmt_bind_result</function></refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para> - This function is an alias of <function>mysqli_stmt_bind_result</function>. - For a detailled descripton see description of - <function>mysqli_stmt_bind_result</function>. - </para> - <note> - <para> - <function>mysqli_bind_result</function> is deprecated and will be removed. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_bind_result</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-bind-result"> + <refnamediv> + <refname>mysqli_bind_result</refname> + <refpurpose>Alias for <function>mysqli_stmt_bind_result</function></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + This function is an alias of <function>mysqli_stmt_bind_result</function>. + For a detailled descripton see description of + <function>mysqli_stmt_bind_result</function>. + </para> + <note> + <para> + <function>mysqli_bind_result</function> is deprecated and will be removed. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_bind_result</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-change-user.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-change-user.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-change-user.xml:1.14 phpdoc/en/reference/mysqli/functions/mysqli-change-user.xml:1.15 --- phpdoc/en/reference/mysqli/functions/mysqli-change-user.xml:1.14 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-change-user.xml Sat Jan 27 17:37:35 2007 @@ -1,74 +1,74 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> - <refentry id="function.mysqli-change-user"> - <refnamediv> - <refname>mysqli_change_user</refname> - <refname>mysqli->change_user</refname> - <refpurpose>Changes the user of the specified database connection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_change_user</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>string</type><parameter>user</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam><type>string</type><parameter>database</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>change_user</methodname> - <methodparam><type>string</type><parameter>user</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam><type>string</type><parameter>database</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - <function>mysqli_change_user</function> is used to change the user of the specified - database connection as given by the <parameter>link</parameter> parameter and to set the - current database to that specified by the <parameter>database</parameter> parameter. - </para> - <para> - If desired, the &null; value may be passed in place of the <parameter>database</parameter> - parameter resulting in only changing the user and not selecting a database. To select - a database in this case use the <function>mysqli_select_db</function> function. - </para> - <para> - In order to successfully change users a valid <parameter>username</parameter> and - <parameter>password</parameter> parameters must be provided and that user must have - sufficient permissions to access the desired database. If for any reason authorization - fails, the current user authentication will remain. - </para> - <note> - <para> - Using this command will always cause the current database connection to behave as if - was a completely new database connection, regardless of if the operation was completed - successfully. This reset includes performing a rollback on any active transactions, - closing all temporary tables, and unlocking all locked tables. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_connect</function>&listendand; - <function>mysqli_select_db</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.15 $ --> +<refentry id="function.mysqli-change-user"> + <refnamediv> + <refname>mysqli_change_user</refname> + <refname>mysqli->change_user</refname> + <refpurpose>Changes the user of the specified database connection</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_change_user</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>user</parameter></methodparam> + <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam><type>string</type><parameter>database</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>change_user</methodname> + <methodparam><type>string</type><parameter>user</parameter></methodparam> + <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam><type>string</type><parameter>database</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + <function>mysqli_change_user</function> is used to change the user of the specified + database connection as given by the <parameter>link</parameter> parameter and to set the + current database to that specified by the <parameter>database</parameter> parameter. + </para> + <para> + If desired, the &null; value may be passed in place of the <parameter>database</parameter> + parameter resulting in only changing the user and not selecting a database. To select + a database in this case use the <function>mysqli_select_db</function> function. + </para> + <para> + In order to successfully change users a valid <parameter>username</parameter> and + <parameter>password</parameter> parameters must be provided and that user must have + sufficient permissions to access the desired database. If for any reason authorization + fails, the current user authentication will remain. + </para> + <note> + <para> + Using this command will always cause the current database connection to behave as if + was a completely new database connection, regardless of if the operation was completed + successfully. This reset includes performing a rollback on any active transactions, + closing all temporary tables, and unlocking all locked tables. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_connect</function>&listendand; + <function>mysqli_select_db</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php @@ -83,7 +83,7 @@ /* Set Variable a */ $mysqli->query("SET @a:=1"); - + /* reset all and select a new database */ $mysqli->change_user("my_user", "my_password", "world"); @@ -105,11 +105,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php /* connect database test */ @@ -123,7 +123,7 @@ /* Set Variable a */ mysqli_query($link, "SET @a:=1"); - + /* reset all and select a new database */ mysqli_change_user($link, "my_user", "my_password", "world"); @@ -145,17 +145,17 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Default database: world Value of variable a is NULL ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-character-set-name.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-character-set-name.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-character-set-name.xml:1.15 phpdoc/en/reference/mysqli/functions/mysqli-character-set-name.xml:1.16 --- phpdoc/en/reference/mysqli/functions/mysqli-character-set-name.xml:1.15 Tue Apr 26 14:33:30 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-character-set-name.xml Sat Jan 27 17:37:35 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> +<!-- $Revision: 1.16 $ --> <refentry id="function.mysqli-character-set-name"> <refnamediv> <refname>mysqli_character_set_name</refname> @@ -8,19 +8,19 @@ </refnamediv> <refsect1> <title>Description</title> - <para>Procedural style:</para> + <para>Procedural style:</para> + <methodsynopsis> + <type>string</type><methodname>mysqli_character_set_name</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> <methodsynopsis> - <type>string</type><methodname>mysqli_character_set_name</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <type>string</type><methodname>character_set_name</methodname> + <void /> </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>string</type><methodname>character_set_name</methodname> - <void /> - </methodsynopsis> - </classsynopsis> + </classsynopsis> <para> Returns the current character set for the database connection specified by the <parameter>link</parameter> parameter. @@ -46,7 +46,7 @@ <?php /* Open a connection */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); - + /* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); @@ -69,7 +69,7 @@ <?php /* Open a connection */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); - + /* check connection */ if (!$link) { printf("Connect failed: %s\n", mysqli_connect_error()); http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-client-encoding.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-client-encoding.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-client-encoding.xml:1.6 phpdoc/en/reference/mysqli/functions/mysqli-client-encoding.xml:1.7 --- phpdoc/en/reference/mysqli/functions/mysqli-client-encoding.xml:1.6 Fri Apr 22 15:39:28 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-client-encoding.xml Sat Jan 27 17:37:35 2007 @@ -1,25 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.mysqli-client-encoding"> - <refnamediv> - <refname>mysqli_client_encoding</refname> - <refpurpose>Alias of <function>mysqli_character_set_name</function></refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para> - This function is an alias of <function>mysqli_character_set_name</function>. - For a detailled descripton see description of - <function>mysqli_character_set_name</function>. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_real_escape_string</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id="function.mysqli-client-encoding"> + <refnamediv> + <refname>mysqli_client_encoding</refname> + <refpurpose>Alias of <function>mysqli_character_set_name</function></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + This function is an alias of <function>mysqli_character_set_name</function>. + For a detailled descripton see description of + <function>mysqli_character_set_name</function>. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_real_escape_string</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-close.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-close.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-close.xml:1.11 phpdoc/en/reference/mysqli/functions/mysqli-close.xml:1.12 --- phpdoc/en/reference/mysqli/functions/mysqli-close.xml:1.11 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-close.xml Sat Jan 27 17:37:35 2007 @@ -1,46 +1,46 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> - <refentry id="function.mysqli-close"> - <refnamediv> - <refname>mysqli_close</refname> - <refname>mysqli->close</refname> - <refpurpose>Closes a previously opened database connection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_close</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>close</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - The <function>mysqli_close</function> function closes a previously opened database - connection specified by the <parameter>link</parameter> parameter. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_connect</function>, - <function>mysqli_init</function>&listendand; - <function>mysqli_real_connect</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.12 $ --> +<refentry id="function.mysqli-close"> + <refnamediv> + <refname>mysqli_close</refname> + <refname>mysqli->close</refname> + <refpurpose>Closes a previously opened database connection</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_close</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>close</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + The <function>mysqli_close</function> function closes a previously opened database + connection specified by the <parameter>link</parameter> parameter. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_connect</function>, + <function>mysqli_init</function>&listendand; + <function>mysqli_real_connect</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-commit.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-commit.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-commit.xml:1.12 phpdoc/en/reference/mysqli/functions/mysqli-commit.xml:1.13 --- phpdoc/en/reference/mysqli/functions/mysqli-commit.xml:1.12 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-commit.xml Sat Jan 27 17:37:35 2007 @@ -1,50 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> - <refentry id="function.mysqli-commit"> - <refnamediv> - <refname>mysqli_commit</refname> - <refname>mysqli->commit</refname> - <refpurpose>Commits the current transaction</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_commit</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method)</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>commit</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - Commits the current transaction for the database connection specified by the - <parameter>link</parameter> parameter. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_autocommit</function>&listendand; - <function>mysqli_rollback</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <para> - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.13 $ --> +<refentry id="function.mysqli-commit"> + <refnamediv> + <refname>mysqli_commit</refname> + <refname>mysqli->commit</refname> + <refpurpose>Commits the current transaction</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_commit</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method)</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>commit</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Commits the current transaction for the database connection specified by the + <parameter>link</parameter> parameter. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_autocommit</function>&listendand; + <function>mysqli_rollback</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <para> + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -74,11 +74,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "test"); @@ -105,11 +105,11 @@ mysqli_close($link); ?> ]]> - </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/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-connect-errno.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-connect-errno.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-connect-errno.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-connect-errno.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-connect-errno.xml:1.7 Sun Oct 31 16:05:10 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-connect-errno.xml Sat Jan 27 17:37:35 2007 @@ -1,53 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-connect-errno"> - <refnamediv> - <refname>mysqli_connect_errno</refname> - <refpurpose>Returns the error code from last connect call</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>mysqli_connect_errno</methodname> - <void /> - </methodsynopsis> - <para> - The <function>mysqli_connect_errno</function> function will return the last error code number - for last call to <function>mysqli_connect</function>. - If no errors have occured, this function will return zero. - </para> - <note> - <para> - Client error message numbers are listed in the MySQL <filename>errmsg.h</filename> header file, - server error message numbers are listed in <filename>mysqld_error.h</filename>. - In the MySQL source distribution you can find a complete list of error messages and error numbers - in the file <filename>Docs/mysqld_error.txt</filename>. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - An error code value for the last call to <function>mysqli_connect</function>, if it failed. - zero means no error occurred. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_connect</function>, - <function>mysqli_connect_error</function>, - <function>mysqli_errno</function>, - <function>mysqli_error</function>&listendand; - <function>mysqli_sqlstate</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <para> - <example> - <title>mysqli_connect_errno sample</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-connect-errno"> + <refnamediv> + <refname>mysqli_connect_errno</refname> + <refpurpose>Returns the error code from last connect call</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>mysqli_connect_errno</methodname> + <void /> + </methodsynopsis> + <para> + The <function>mysqli_connect_errno</function> function will return the last error code number + for last call to <function>mysqli_connect</function>. + If no errors have occured, this function will return zero. + </para> + <note> + <para> + Client error message numbers are listed in the MySQL <filename>errmsg.h</filename> header file, + server error message numbers are listed in <filename>mysqld_error.h</filename>. + In the MySQL source distribution you can find a complete list of error messages and error numbers + in the file <filename>Docs/mysqld_error.txt</filename>. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + An error code value for the last call to <function>mysqli_connect</function>, if it failed. + zero means no error occurred. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_connect</function>, + <function>mysqli_connect_error</function>, + <function>mysqli_errno</function>, + <function>mysqli_error</function>&listendand; + <function>mysqli_sqlstate</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <para> + <example> + <title>mysqli_connect_errno sample</title> + <programlisting role="php"> <![CDATA[ <?php @@ -58,11 +58,11 @@ } ?> ]]> - </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/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-connect-error.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-connect-error.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-connect-error.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-connect-error.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-connect-error.xml:1.7 Sun Oct 31 16:05:10 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-connect-error.xml Sat Jan 27 17:37:35 2007 @@ -1,47 +1,47 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-connect-error"> - <refnamediv> - <refname>mysqli_connect_error</refname> - <refpurpose>Returns a string description of the last connect error</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>mysqli_connect_error</methodname> - <void /> - </methodsynopsis> - <para> - The <function>mysqli_connect_error</function> function is identical to the corresponding - <function>mysqli_connect_errno</function> function in every way, except instead of returning - an integer error code the <function>mysqli_connect_error</function> function will return - a string representation of the last error to occur for the last - <function>mysqli_connect</function> call. - If no error has occured, this function will return an empty string. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - A string that describes the error. An empty string if no error occurred. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_connect</function>, - <function>mysqli_connect_errno</function>, - <function>mysqli_errno</function>, - <function>mysqli_error</function>&listendand; - <function>mysqli_sqlstate</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <para> - <example> - <title>mysqli_connect_error sample</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-connect-error"> + <refnamediv> + <refname>mysqli_connect_error</refname> + <refpurpose>Returns a string description of the last connect error</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>mysqli_connect_error</methodname> + <void /> + </methodsynopsis> + <para> + The <function>mysqli_connect_error</function> function is identical to the corresponding + <function>mysqli_connect_errno</function> function in every way, except instead of returning + an integer error code the <function>mysqli_connect_error</function> function will return + a string representation of the last error to occur for the last + <function>mysqli_connect</function> call. + If no error has occured, this function will return an empty string. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + A string that describes the error. An empty string if no error occurred. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_connect</function>, + <function>mysqli_connect_errno</function>, + <function>mysqli_errno</function>, + <function>mysqli_error</function>&listendand; + <function>mysqli_sqlstate</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <para> + <example> + <title>mysqli_connect_error sample</title> + <programlisting role="php"> <![CDATA[ <?php @@ -52,11 +52,11 @@ } ?> ]]> - </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/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-connect.xml?r1=1.20&r2=1.21&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-connect.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-connect.xml:1.20 phpdoc/en/reference/mysqli/functions/mysqli-connect.xml:1.21 --- phpdoc/en/reference/mysqli/functions/mysqli-connect.xml:1.20 Fri Jun 24 09:11:41 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-connect.xml Sat Jan 27 17:37:35 2007 @@ -1,86 +1,86 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> - <refentry id="function.mysqli-connect"> - <refnamediv> - <refname>mysqli_connect</refname> - <refname>mysqli()</refname> - <refpurpose>Open a new connection to the MySQL server</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style</para> - <methodsynopsis> - <type>mysqli</type><methodname>mysqli_connect</methodname> - <methodparam choice='opt'><type>string</type><parameter>host</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>username</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>passwd</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>dbname</parameter></methodparam> - <methodparam choice='opt'><type>int</type><parameter>port</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>socket</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (constructor):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <constructorsynopsis> - <methodname>__construct</methodname> - <methodparam choice='opt'><type>string</type><parameter>host</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>username</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>passwd</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>dbname</parameter></methodparam> - <methodparam choice='opt'><type>int</type><parameter>port</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>socket</parameter></methodparam> - </constructorsynopsis> - </classsynopsis> - <para> - The <function>mysqli_connect</function> function attempts to open a connection to the MySQL Server - running on <parameter>host</parameter> which can be either a host name or an IP address. Passing the - &null; value or the string "localhost" to this parameter, the local host is assumed. When possible, - pipes will be used instead of the TCP/IP protocol. If successful, the <function>mysqli_connect</function> - will return an object representing the connection to the database, or &false; on failure. - </para> - <para> - The <parameter>username</parameter> and <parameter>password</parameter> parameters specify the - username and password under which to connect to the MySQL server. If the password is not provided - (the &null; value is passed), the MySQL server will attempt to authenticate the user against those - user records which have no password only. This allows one username to be used with different - permissions (depending on if a password as provided or not). - </para> - <para> - The <parameter>dbname</parameter> parameter if provided will specify the default database to be - used when performing queries. - </para> - <para> - The <parameter>port</parameter> and <parameter>socket</parameter> parameters are used in - conjunction with the <parameter>host</parameter> parameter to further control how to connect - to the database server. The <parameter>port</parameter> parameter specifies the port number to - attempt to connect to the MySQL server on, while the <parameter>socket</parameter> parameter - specifies the socket or named pipe that should be used. - </para> - <note> - <para> - Specifying the <parameter>socket</parameter> parameter will not explicitly determine the type - of connection to be used when connecting to the MySQL server. How the connection is made to the - MySQL database is determined by the <parameter>host</parameter> parameter. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns a object which represents the connection to a MySQL Server or - &false; if the connection failed. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.21 $ --> +<refentry id="function.mysqli-connect"> + <refnamediv> + <refname>mysqli_connect</refname> + <refname>mysqli()</refname> + <refpurpose>Open a new connection to the MySQL server</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style</para> + <methodsynopsis> + <type>mysqli</type><methodname>mysqli_connect</methodname> + <methodparam choice='opt'><type>string</type><parameter>host</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>username</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>passwd</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>dbname</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>port</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>socket</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (constructor):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <constructorsynopsis> + <methodname>__construct</methodname> + <methodparam choice='opt'><type>string</type><parameter>host</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>username</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>passwd</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>dbname</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>port</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>socket</parameter></methodparam> + </constructorsynopsis> + </classsynopsis> + <para> + The <function>mysqli_connect</function> function attempts to open a connection to the MySQL Server + running on <parameter>host</parameter> which can be either a host name or an IP address. Passing the + &null; value or the string "localhost" to this parameter, the local host is assumed. When possible, + pipes will be used instead of the TCP/IP protocol. If successful, the <function>mysqli_connect</function> + will return an object representing the connection to the database, or &false; on failure. + </para> + <para> + The <parameter>username</parameter> and <parameter>password</parameter> parameters specify the + username and password under which to connect to the MySQL server. If the password is not provided + (the &null; value is passed), the MySQL server will attempt to authenticate the user against those + user records which have no password only. This allows one username to be used with different + permissions (depending on if a password as provided or not). + </para> + <para> + The <parameter>dbname</parameter> parameter if provided will specify the default database to be + used when performing queries. + </para> + <para> + The <parameter>port</parameter> and <parameter>socket</parameter> parameters are used in + conjunction with the <parameter>host</parameter> parameter to further control how to connect + to the database server. The <parameter>port</parameter> parameter specifies the port number to + attempt to connect to the MySQL server on, while the <parameter>socket</parameter> parameter + specifies the socket or named pipe that should be used. + </para> + <note> + <para> + Specifying the <parameter>socket</parameter> parameter will not explicitly determine the type + of connection to be used when connecting to the MySQL server. How the connection is made to the + MySQL database is determined by the <parameter>host</parameter> parameter. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns a object which represents the connection to a MySQL Server or + &false; if the connection failed. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -92,16 +92,16 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (!$link) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -113,16 +113,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Host information: Localhost via UNIX socket ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml:1.18 phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml:1.19 --- phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml:1.18 Tue Apr 5 10:57:48 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-data-seek.xml Sat Jan 27 17:37:35 2007 @@ -1,69 +1,69 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> - <refentry id="function.mysqli-data-seek"> - <refnamediv> - <refname>mysqli_data_seek</refname> - <refname>result->data_seek</refname> - <refpurpose>Adjusts the result pointer to an arbitary row in the result</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_data_seek</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>data_seek</methodname> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - The <function>mysqli_data_seek</function> function seeks to an arbitrary result pointer - specified by the <parameter>offset</parameter> in the result set represented by - <parameter>result</parameter>. The <parameter>offset</parameter> parameter must be between - zero and the total number of rows minus one (0..<function>mysqli_num_rows</function> - 1). - </para> - <note> - <para> - This function can only be used with buffered results attained from the use of the - <function>mysqli_store_result</function> or <function>mysqli_query</function> functions. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_store_result</function>, - <function>mysqli_fetch_row</function>, - <function>mysqli_fetch_array</function>, - <function>mysqli_fetch_assoc</function>, - <function>mysqli_fetch_object</function>, - <function>mysqli_query</function>&listendand; - <function>mysqli_num_rows</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.19 $ --> +<refentry id="function.mysqli-data-seek"> + <refnamediv> + <refname>mysqli_data_seek</refname> + <refname>result->data_seek</refname> + <refpurpose>Adjusts the result pointer to an arbitary row in the result</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_data_seek</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>data_seek</methodname> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + The <function>mysqli_data_seek</function> function seeks to an arbitrary result pointer + specified by the <parameter>offset</parameter> in the result set represented by + <parameter>result</parameter>. The <parameter>offset</parameter> parameter must be between + zero and the total number of rows minus one (0..<function>mysqli_num_rows</function> - 1). + </para> + <note> + <para> + This function can only be used with buffered results attained from the use of the + <function>mysqli_store_result</function> or <function>mysqli_query</function> functions. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_store_result</function>, + <function>mysqli_fetch_row</function>, + <function>mysqli_fetch_array</function>, + <function>mysqli_fetch_assoc</function>, + <function>mysqli_fetch_object</function>, + <function>mysqli_query</function>&listendand; + <function>mysqli_num_rows</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -79,7 +79,7 @@ $row = $result->fetch_row(); printf ("City: %s Countrycode: %s\n", $row[0], $row[1]); - + /* free result set*/ $result->close(); } @@ -88,17 +88,17 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (!$link) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -115,7 +115,7 @@ $row = mysqli_fetch_row($result); printf ("City: %s Countrycode: %s\n", $row[0], $row[1]); - + /* free result set*/ mysqli_free_result($result); } @@ -124,16 +124,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ City: Benin City Countrycode: NGA ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-debug.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-debug.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-debug.xml:1.11 phpdoc/en/reference/mysqli/functions/mysqli-debug.xml:1.12 --- phpdoc/en/reference/mysqli/functions/mysqli-debug.xml:1.11 Thu Jun 23 16:53:26 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-debug.xml Sat Jan 27 17:37:35 2007 @@ -1,58 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> - <refentry id="function.mysqli-debug"> - <refnamediv> - <refname>mysqli_debug</refname> - <refpurpose>Performs debugging operations</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_debug</methodname> - <methodparam><type>string</type><parameter>debug</parameter></methodparam> - </methodsynopsis> - <para> - The <function>mysqli_debug</function> function is used to perform debugging - operations using the Fred Fish debugging library. The <parameter>debug</parameter> - parameter is a string representing the debugging operation to perform. - </para> - <note> - <para> - To use the <function>mysqli_debug</function> function you must complile - the MySQL client library to support debugging. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para><function>mysqli_debug</function> doesn't return any value.</para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_dump_debug_info</function>&listendand; - <function>mysqli_report</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <para> - <example> - <title>Generating a Trace File</title> - <programlisting role="php"> +<!-- $Revision: 1.12 $ --> +<refentry id="function.mysqli-debug"> + <refnamediv> + <refname>mysqli_debug</refname> + <refpurpose>Performs debugging operations</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_debug</methodname> + <methodparam><type>string</type><parameter>debug</parameter></methodparam> + </methodsynopsis> + <para> + The <function>mysqli_debug</function> function is used to perform debugging + operations using the Fred Fish debugging library. The <parameter>debug</parameter> + parameter is a string representing the debugging operation to perform. + </para> + <note> + <para> + To use the <function>mysqli_debug</function> function you must complile + the MySQL client library to support debugging. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para><function>mysqli_debug</function> doesn't return any value.</para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_dump_debug_info</function>&listendand; + <function>mysqli_report</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <para> + <example> + <title>Generating a Trace File</title> + <programlisting role="php"> <![CDATA[ <?php - + /* Create a trace file in '/tmp/client.trace' on the local (client) machine: */ mysqli_debug("d:t:0,/tmp/client.trace"); - + ?> ]]> - </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/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-disable-reads-from-master.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-disable-reads-from-master.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-disable-reads-from-master.xml:1.9 phpdoc/en/reference/mysqli/functions/mysqli-disable-reads-from-master.xml:1.10 --- phpdoc/en/reference/mysqli/functions/mysqli-disable-reads-from-master.xml:1.9 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-disable-reads-from-master.xml Sat Jan 27 17:37:35 2007 @@ -1,31 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> - <refentry id="function.mysqli-disable-reads-from-master"> - <refnamediv> - <refname>mysqli_disable_reads_from_master</refname> - <refname>mysqli->disable_reads_from_master</refname> - <refpurpose>Disable reads from master</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_disable_reads_from_master</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>void</type><methodname>disable_reads_from_master</methodname> - <void /> - </methodsynopsis> - </classsynopsis> +<!-- $Revision: 1.10 $ --> +<refentry id="function.mysqli-disable-reads-from-master"> + <refnamediv> + <refname>mysqli_disable_reads_from_master</refname> + <refname>mysqli->disable_reads_from_master</refname> + <refpurpose>Disable reads from master</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_disable_reads_from_master</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>void</type><methodname>disable_reads_from_master</methodname> + <void /> + </methodsynopsis> + </classsynopsis> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-disable-rpl-parse.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-disable-rpl-parse.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-disable-rpl-parse.xml:1.11 phpdoc/en/reference/mysqli/functions/mysqli-disable-rpl-parse.xml:1.12 --- phpdoc/en/reference/mysqli/functions/mysqli-disable-rpl-parse.xml:1.11 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-disable-rpl-parse.xml Sat Jan 27 17:37:35 2007 @@ -1,21 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> - <refentry id="function.mysqli-disable-rpl-parse"> - <refnamediv> - <refname>mysqli_disable_rpl_parse</refname> - <refpurpose>Disable RPL parse</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_disable_rpl_parse</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.12 $ --> +<refentry id="function.mysqli-disable-rpl-parse"> + <refnamediv> + <refname>mysqli_disable_rpl_parse</refname> + <refpurpose>Disable RPL parse</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_disable_rpl_parse</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-dump-debug-info.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-dump-debug-info.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-dump-debug-info.xml:1.12 phpdoc/en/reference/mysqli/functions/mysqli-dump-debug-info.xml:1.13 --- phpdoc/en/reference/mysqli/functions/mysqli-dump-debug-info.xml:1.12 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-dump-debug-info.xml Sat Jan 27 17:37:35 2007 @@ -1,36 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> - <refentry id="function.mysqli-dump-debug-info"> - <refnamediv> - <refname>mysqli_dump_debug_info</refname> - <refname>mysqli->dump_debug_info</refname> - <refpurpose>Dump debugging information into the log</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_dump_debug_info</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para> - This function is designed to be executed by an user with the SUPER privilege and - is used to dump debugging information into the log for the MySQL Server relating - to the connection specified by the <parameter>link</parameter> parameter. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_debug</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.13 $ --> +<refentry id="function.mysqli-dump-debug-info"> + <refnamediv> + <refname>mysqli_dump_debug_info</refname> + <refname>mysqli->dump_debug_info</refname> + <refpurpose>Dump debugging information into the log</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_dump_debug_info</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para> + This function is designed to be executed by an user with the SUPER privilege and + is used to dump debugging information into the log for the MySQL Server relating + to the connection specified by the <parameter>link</parameter> parameter. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_debug</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-embedded-connect.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-embedded-connect.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-embedded-connect.xml:1.9 phpdoc/en/reference/mysqli/functions/mysqli-embedded-connect.xml:1.10 --- phpdoc/en/reference/mysqli/functions/mysqli-embedded-connect.xml:1.9 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-embedded-connect.xml Sat Jan 27 17:37:35 2007 @@ -1,21 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> - <refentry id="function.mysqli-embedded-connect"> - <refnamediv> - <refname>mysqli_embedded_connect</refname> - <refpurpose>Open a connection to an embedded mysql server</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>mysqli</type><methodname>mysqli_embedded_connect</methodname> - <methodparam choice="opt"><type>string</type><parameter>dbname</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.10 $ --> +<refentry id="function.mysqli-embedded-connect"> + <refnamediv> + <refname>mysqli_embedded_connect</refname> + <refpurpose>Open a connection to an embedded mysql server</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>mysqli</type><methodname>mysqli_embedded_connect</methodname> + <methodparam choice="opt"><type>string</type><parameter>dbname</parameter></methodparam> + </methodsynopsis> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-enable-reads-from-master.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-enable-reads-from-master.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-enable-reads-from-master.xml:1.12 phpdoc/en/reference/mysqli/functions/mysqli-enable-reads-from-master.xml:1.13 --- phpdoc/en/reference/mysqli/functions/mysqli-enable-reads-from-master.xml:1.12 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-enable-reads-from-master.xml Sat Jan 27 17:37:35 2007 @@ -1,21 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> - <refentry id="function.mysqli-enable-reads-from-master"> - <refnamediv> - <refname>mysqli_enable_reads_from_master</refname> - <refpurpose>Enable reads from master</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_enable_reads_from_master</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.13 $ --> +<refentry id="function.mysqli-enable-reads-from-master"> + <refnamediv> + <refname>mysqli_enable_reads_from_master</refname> + <refpurpose>Enable reads from master</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_enable_reads_from_master</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-enable-rpl-parse.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-enable-rpl-parse.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-enable-rpl-parse.xml:1.12 phpdoc/en/reference/mysqli/functions/mysqli-enable-rpl-parse.xml:1.13 --- phpdoc/en/reference/mysqli/functions/mysqli-enable-rpl-parse.xml:1.12 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-enable-rpl-parse.xml Sat Jan 27 17:37:35 2007 @@ -1,21 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> - <refentry id="function.mysqli-enable-rpl-parse"> - <refnamediv> - <refname>mysqli_enable_rpl_parse</refname> - <refpurpose>Enable RPL parse</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_enable_rpl_parse</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.13 $ --> +<refentry id="function.mysqli-enable-rpl-parse"> + <refnamediv> + <refname>mysqli_enable_rpl_parse</refname> + <refpurpose>Enable RPL parse</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_enable_rpl_parse</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-errno.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-errno.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-errno.xml:1.13 phpdoc/en/reference/mysqli/functions/mysqli-errno.xml:1.14 --- phpdoc/en/reference/mysqli/functions/mysqli-errno.xml:1.13 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-errno.xml Sat Jan 27 17:37:35 2007 @@ -1,58 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> - <refentry id="function.mysqli-errno"> - <refnamediv> - <refname>mysqli_errno</refname> - <refname>mysqli->errno</refname> - <refpurpose>Returns the error code for the most recent function call</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_errno</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <fieldsynopsis><type>int</type><varname>errno</varname></fieldsynopsis> - </classsynopsis> - <para> - The <function>mysqli_errno</function> function will return the last error code for - the most recent MySQLi function call that can succeed or fail with respect to the - database link defined by the <parameter>link</parameter> parameter. If no errors - have occured, this function will return zero. - </para> - <note> - <para> - Client error message numbers are listed in the MySQL <filename>errmsg.h</filename> header file, - server error message numbers are listed in <filename>mysqld_error.h</filename>. - In the MySQL source distribution you can find a complete list of error messages and error numbers - in the file <filename>Docs/mysqld_error.txt</filename>. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - An error code value for the last call, if it failed. zero means no error occurred. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_connect_errno</function>, - <function>mysqli_connect_error</function>, - <function>mysqli_error</function>&listendand; - <function>mysqli_sqlstate</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.14 $ --> +<refentry id="function.mysqli-errno"> + <refnamediv> + <refname>mysqli_errno</refname> + <refname>mysqli->errno</refname> + <refpurpose>Returns the error code for the most recent function call</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_errno</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>int</type><varname>errno</varname></fieldsynopsis> + </classsynopsis> + <para> + The <function>mysqli_errno</function> function will return the last error code for + the most recent MySQLi function call that can succeed or fail with respect to the + database link defined by the <parameter>link</parameter> parameter. If no errors + have occured, this function will return zero. + </para> + <note> + <para> + Client error message numbers are listed in the MySQL <filename>errmsg.h</filename> header file, + server error message numbers are listed in <filename>mysqld_error.h</filename>. + In the MySQL source distribution you can find a complete list of error messages and error numbers + in the file <filename>Docs/mysqld_error.txt</filename>. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + An error code value for the last call, if it failed. zero means no error occurred. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_connect_errno</function>, + <function>mysqli_connect_error</function>, + <function>mysqli_error</function>&listendand; + <function>mysqli_sqlstate</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -71,11 +71,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -94,16 +94,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Errorcode: 1193 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-error.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-error.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-error.xml:1.14 phpdoc/en/reference/mysqli/functions/mysqli-error.xml:1.15 --- phpdoc/en/reference/mysqli/functions/mysqli-error.xml:1.14 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-error.xml Sat Jan 27 17:37:35 2007 @@ -1,51 +1,51 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> - <refentry id="function.mysqli-error"> - <refnamediv> - <refname>mysqli_error</refname> - <refpurpose>Returns a string description of the last error</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>string</type><methodname>mysqli_error</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property)</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <fieldsynopsis><type>string</type><varname>error</varname></fieldsynopsis> - </classsynopsis> - <para> - The <function>mysqli_error</function> function is identical to the corresponding - <function>mysqli_errno</function> function in every way, except instead of returning - an integer error code the <function>mysqli_error</function> function will return - a string representation of the last error to occur for the database connection - represented by the <parameter>link</parameter> parameter. If no error has occured, - this function will return an empty string. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - A string that describes the error. An empty string if no error occurred. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_connect_errno</function>, - <function>mysqli_connect_error</function>, - <function>mysqli_errno</function>&listendand; - <function>mysqli_sqlstate</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.15 $ --> +<refentry id="function.mysqli-error"> + <refnamediv> + <refname>mysqli_error</refname> + <refpurpose>Returns a string description of the last error</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>string</type><methodname>mysqli_error</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property)</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>string</type><varname>error</varname></fieldsynopsis> + </classsynopsis> + <para> + The <function>mysqli_error</function> function is identical to the corresponding + <function>mysqli_errno</function> function in every way, except instead of returning + an integer error code the <function>mysqli_error</function> function will return + a string representation of the last error to occur for the database connection + represented by the <parameter>link</parameter> parameter. If no error has occured, + this function will return an empty string. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + A string that describes the error. An empty string if no error occurred. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_connect_errno</function>, + <function>mysqli_connect_error</function>, + <function>mysqli_errno</function>&listendand; + <function>mysqli_sqlstate</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -64,11 +64,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -87,16 +87,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Errormessage: Unknown system variable 'a' ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-escape-string.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-escape-string.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-escape-string.xml:1.4 phpdoc/en/reference/mysqli/functions/mysqli-escape-string.xml:1.5 --- phpdoc/en/reference/mysqli/functions/mysqli-escape-string.xml:1.4 Fri Mar 19 10:05:42 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-escape-string.xml Sat Jan 27 17:37:35 2007 @@ -1,17 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.mysqli-escape-string"> - <refnamediv> - <refname>mysqli_escape_string</refname> - <refpurpose>Alias of <function>mysqli_real_escape_string</function></refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para> - This function is an alias of <function>mysqli_real_escape_string</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.mysqli-escape-string"> + <refnamediv> + <refname>mysqli_escape_string</refname> + <refpurpose>Alias of <function>mysqli_real_escape_string</function></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + This function is an alias of <function>mysqli_real_escape_string</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-execute.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-execute.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-execute.xml:1.14 phpdoc/en/reference/mysqli/functions/mysqli-execute.xml:1.15 --- phpdoc/en/reference/mysqli/functions/mysqli-execute.xml:1.14 Sun Oct 31 16:05:10 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-execute.xml Sat Jan 27 17:37:36 2007 @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> - <refentry id="function.mysqli-execute"> - <refnamediv> - <refname>mysqli_execute</refname> - <refpurpose>Alias for <function>mysqli_stmt_execute</function></refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para> - This function is an alias of <function>mysqli_stmt_execute</function>. - For a detailled descripton see description of - <function>mysqli_stmt_execute</function>. - </para> - <note> - <para> - <function>mysqli_execute</function> is deprecated and will be removed. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_execute</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.15 $ --> +<refentry id="function.mysqli-execute"> + <refnamediv> + <refname>mysqli_execute</refname> + <refpurpose>Alias for <function>mysqli_stmt_execute</function></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + This function is an alias of <function>mysqli_stmt_execute</function>. + For a detailled descripton see description of + <function>mysqli_stmt_execute</function>. + </para> + <note> + <para> + <function>mysqli_execute</function> is deprecated and will be removed. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_execute</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-fetch-array.xml?r1=1.20&r2=1.21&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-fetch-array.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-fetch-array.xml:1.20 phpdoc/en/reference/mysqli/functions/mysqli-fetch-array.xml:1.21 --- phpdoc/en/reference/mysqli/functions/mysqli-fetch-array.xml:1.20 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-fetch-array.xml Sat Jan 27 17:37:36 2007 @@ -1,78 +1,78 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> - <refentry id="function.mysqli-fetch-array"> - <refnamediv> - <refname>mysqli_fetch_array</refname> - <refname>result->fetch_array</refname> - <refpurpose>Fetch a result row as an associative, a numeric array, or both</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>mixed</type><methodname>mysqli_fetch_array</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>mixed</type><methodname>fetch_array</methodname> - <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - Returns an array that corresponds to the fetched row or &null; if there are no more rows for the - resultset represented by the <parameter>result</parameter> parameter. - </para> - <para> - <function>mysqli_fetch_array</function> is an extended version of the - <function>mysqli_fetch_row</function> function. In addition to storing the data in the - numeric indices of the result array, the <function>mysqli_fetch_array</function> function can - also store the data in associative indices, using the field names of the result set as keys. - </para> - &database.field-case; - &database.fetch-null; - <para> - If two or more columns of the result have the same field names, the last column will take - precedence and overwrite the earlier data. In order to access multiple columns with the same - name, the numerically indexed version of the row must be used. - </para> - <para> - The optional second argument <parameter>resulttype</parameter> is a constant indicating what - type of array should be produced from the current row data. The possible values for this parameter - are the constants MYSQLI_ASSOC, MYSQLI_NUM, or MYSQLI_BOTH. By default the - <function>mysqli_fetch_array</function> function will assume MYSQLI_BOTH for this parameter. - </para> - <para> - By using the MYSQLI_ASSOC constant this function will behave identically to the - <function>mysqli_fetch_assoc</function>, while MYSQLI_NUM will behave identically to the - <function>mysqli_fetch_row</function> function. The final option MYSQLI_BOTH will create a single - array with the attributes of both. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns an array that corresponds to the fetched row or &null; if there are no more rows in resultset. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_assoc</function>, - <function>mysqli_fetch_row</function>, - <function>mysqli_fetch_object</function>, - <function>mysqli_query</function>&listendand; - <function>mysqli_data_seek</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.21 $ --> +<refentry id="function.mysqli-fetch-array"> + <refnamediv> + <refname>mysqli_fetch_array</refname> + <refname>result->fetch_array</refname> + <refpurpose>Fetch a result row as an associative, a numeric array, or both</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>mixed</type><methodname>mysqli_fetch_array</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>mixed</type><methodname>fetch_array</methodname> + <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Returns an array that corresponds to the fetched row or &null; if there are no more rows for the + resultset represented by the <parameter>result</parameter> parameter. + </para> + <para> + <function>mysqli_fetch_array</function> is an extended version of the + <function>mysqli_fetch_row</function> function. In addition to storing the data in the + numeric indices of the result array, the <function>mysqli_fetch_array</function> function can + also store the data in associative indices, using the field names of the result set as keys. + </para> + &database.field-case; + &database.fetch-null; + <para> + If two or more columns of the result have the same field names, the last column will take + precedence and overwrite the earlier data. In order to access multiple columns with the same + name, the numerically indexed version of the row must be used. + </para> + <para> + The optional second argument <parameter>resulttype</parameter> is a constant indicating what + type of array should be produced from the current row data. The possible values for this parameter + are the constants MYSQLI_ASSOC, MYSQLI_NUM, or MYSQLI_BOTH. By default the + <function>mysqli_fetch_array</function> function will assume MYSQLI_BOTH for this parameter. + </para> + <para> + By using the MYSQLI_ASSOC constant this function will behave identically to the + <function>mysqli_fetch_assoc</function>, while MYSQLI_NUM will behave identically to the + <function>mysqli_fetch_row</function> function. The final option MYSQLI_BOTH will create a single + array with the attributes of both. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns an array that corresponds to the fetched row or &null; if there are no more rows in resultset. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_fetch_assoc</function>, + <function>mysqli_fetch_row</function>, + <function>mysqli_fetch_object</function>, + <function>mysqli_query</function>&listendand; + <function>mysqli_data_seek</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -82,21 +82,21 @@ printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } - + $query = "SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3"; $result = $mysqli->query($query); /* numeric array */ $row = $result->fetch_array(MYSQLI_NUM); -printf ("%s (%s)\n", $row[0], $row[1]); +printf ("%s (%s)\n", $row[0], $row[1]); /* associative array */ $row = $result->fetch_array(MYSQLI_ASSOC); -printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); +printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); /* associative and numeric array */ $row = $result->fetch_array(MYSQLI_BOTH); -printf ("%s (%s)\n", $row[0], $row["CountryCode"]); +printf ("%s (%s)\n", $row[0], $row["CountryCode"]); /* free result set */ $result->close(); @@ -105,11 +105,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -125,15 +125,15 @@ /* numeric array */ $row = mysqli_fetch_array($result, MYSQLI_NUM); -printf ("%s (%s)\n", $row[0], $row[1]); +printf ("%s (%s)\n", $row[0], $row[1]); /* associative array */ $row = mysqli_fetch_array($result, MYSQLI_ASSOC); -printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); +printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); /* associative and numeric array */ $row = mysqli_fetch_array($result, MYSQLI_BOTH); -printf ("%s (%s)\n", $row[0], $row["CountryCode"]); +printf ("%s (%s)\n", $row[0], $row["CountryCode"]); /* free result set */ mysqli_free_result($result); @@ -142,18 +142,18 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Kabul (AFG) Qandahar (AFG) Herat (AFG) ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-fetch-assoc.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-fetch-assoc.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-fetch-assoc.xml:1.18 phpdoc/en/reference/mysqli/functions/mysqli-fetch-assoc.xml:1.19 --- phpdoc/en/reference/mysqli/functions/mysqli-fetch-assoc.xml:1.18 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-fetch-assoc.xml Sat Jan 27 17:37:36 2007 @@ -1,67 +1,67 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> - <refentry id="function.mysqli-fetch-assoc"> - <refnamediv> - <refname>mysqli_fetch_assoc</refname> - <refname>mysqli->fetch_assoc</refname> - <refpurpose>Fetch a result row as an associative array</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>array</type><methodname>mysqli_fetch_assoc</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>array</type><methodname>fetch_assoc</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - Returns an associative array that corresponds to the fetched row or &null; if there are - no more rows. - </para> - <para> - The <function>mysqli_fetch_assoc</function> function is used to return an associative array - representing the next row in the result set for the result represented by the - <parameter>result</parameter> parameter, where each key in the array represents the name - of one of the result set's columns. - </para> - <para> - If two or more columns of the result have the same field names, - the last column will take precedence. To access the other - column(s) of the same name, you either need to access the - result with numeric indices by using - <function>mysqli_fetch_row</function> or add alias names. - </para> - &database.field-case; - &database.fetch-null; - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns an array that corresponds to the fetched row or &null; if there are no more rows in resultset. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_array</function>, - <function>mysqli_fetch_row</function>, - <function>mysqli_fetch_object</function>, - <function>mysqli_query</function>&listendand; - <function>mysqli_data_seek</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.19 $ --> +<refentry id="function.mysqli-fetch-assoc"> + <refnamediv> + <refname>mysqli_fetch_assoc</refname> + <refname>mysqli->fetch_assoc</refname> + <refpurpose>Fetch a result row as an associative array</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>array</type><methodname>mysqli_fetch_assoc</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>array</type><methodname>fetch_assoc</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns an associative array that corresponds to the fetched row or &null; if there are + no more rows. + </para> + <para> + The <function>mysqli_fetch_assoc</function> function is used to return an associative array + representing the next row in the result set for the result represented by the + <parameter>result</parameter> parameter, where each key in the array represents the name + of one of the result set's columns. + </para> + <para> + If two or more columns of the result have the same field names, + the last column will take precedence. To access the other + column(s) of the same name, you either need to access the + result with numeric indices by using + <function>mysqli_fetch_row</function> or add alias names. + </para> + &database.field-case; + &database.fetch-null; + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns an array that corresponds to the fetched row or &null; if there are no more rows in resultset. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_fetch_array</function>, + <function>mysqli_fetch_row</function>, + <function>mysqli_fetch_object</function>, + <function>mysqli_query</function>&listendand; + <function>mysqli_data_seek</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -71,7 +71,7 @@ printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } - + $query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5"; if ($result = $mysqli->query($query)) { @@ -89,11 +89,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -121,10 +121,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Pueblo (USA) Arvada (USA) @@ -132,9 +132,9 @@ Green Bay (USA) Santa Clara (USA) ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-fetch-field-direct.xml?r1=1.14&r2=1.15&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-fetch-field-direct.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-fetch-field-direct.xml:1.14 phpdoc/en/reference/mysqli/functions/mysqli-fetch-field-direct.xml:1.15 --- phpdoc/en/reference/mysqli/functions/mysqli-fetch-field-direct.xml:1.14 Thu Mar 2 12:22:50 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-fetch-field-direct.xml Sat Jan 27 17:37:36 2007 @@ -1,114 +1,112 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.14 $ --> - <refentry id="function.mysqli-fetch-field-direct"> - <refnamediv> - <refname>mysqli_fetch_field_direct</refname> - <refname>result->fetch_field_direct</refname> - <refpurpose> - Fetch meta-data for a single field - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>object</type><methodname>mysqli_fetch_field_direct</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>object</type><methodname>fetch_field_direct</methodname> - <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - <function>mysqli_fetch_field_direct</function> returns an object which contains - field definition informations from specified resultset. The value of fieldnr must be in the - range from <literal>0</literal> to <literal>number of fields - 1</literal>. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns an object which contains field definition information or &false; if no field information - for specified <literal>fieldnr</literal> is available. - </para> - <para> - <table> - <title>Object attributes</title> - <tgroup cols='2'> - <thead> - <row> - <entry>Attribute</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>name</entry> - <entry>The name of the column</entry> - </row> - <row> - <entry>orgname</entry> - <entry>Original column name if an alias was specified</entry> - </row> - <row> - <entry>table</entry> - <entry>The name of the table this field belongs to (if not calculated)</entry> - </row> - <row> - <entry>orgtable</entry> - <entry>Original table name if an alias was specified</entry> - </row> - <row> - <entry>def</entry> - <entry>The default value for this field, represented as a string</entry> - </row> - <row> - <entry>max_length</entry> - <entry>The maximum width of the field for the result set.</entry> - </row> - <row> - <entry>length</entry> - <entry>The width of the field, as specified in the tabl definition.</entry> - </row> - <row> - <entry>charsetnr</entry> - <entry>The character set number for the field.</entry> - </row> - <row> - <entry>flags</entry> - <entry>An integer representing the bit-flags for the field.</entry> - </row> - <row> - <entry>type</entry> - <entry>The data type used for this field</entry> - </row> - <row> - <entry>decimals</entry> - <entry>The number of decimals used (for integer fields)</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_num_fields</function>, - <function>mysqli_fetch_field</function>&listendand; - <function>mysqli_fetch_fields</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.15 $ --> +<refentry id="function.mysqli-fetch-field-direct"> + <refnamediv> + <refname>mysqli_fetch_field_direct</refname> + <refname>result->fetch_field_direct</refname> + <refpurpose>Fetch meta-data for a single field</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>object</type><methodname>mysqli_fetch_field_direct</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>object</type><methodname>fetch_field_direct</methodname> + <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + <function>mysqli_fetch_field_direct</function> returns an object which contains + field definition informations from specified resultset. The value of fieldnr must be in the + range from <literal>0</literal> to <literal>number of fields - 1</literal>. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns an object which contains field definition information or &false; if no field information + for specified <literal>fieldnr</literal> is available. + </para> + <para> + <table> + <title>Object attributes</title> + <tgroup cols='2'> + <thead> + <row> + <entry>Attribute</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>name</entry> + <entry>The name of the column</entry> + </row> + <row> + <entry>orgname</entry> + <entry>Original column name if an alias was specified</entry> + </row> + <row> + <entry>table</entry> + <entry>The name of the table this field belongs to (if not calculated)</entry> + </row> + <row> + <entry>orgtable</entry> + <entry>Original table name if an alias was specified</entry> + </row> + <row> + <entry>def</entry> + <entry>The default value for this field, represented as a string</entry> + </row> + <row> + <entry>max_length</entry> + <entry>The maximum width of the field for the result set.</entry> + </row> + <row> + <entry>length</entry> + <entry>The width of the field, as specified in the tabl definition.</entry> + </row> + <row> + <entry>charsetnr</entry> + <entry>The character set number for the field.</entry> + </row> + <row> + <entry>flags</entry> + <entry>An integer representing the bit-flags for the field.</entry> + </row> + <row> + <entry>type</entry> + <entry>The data type used for this field</entry> + </row> + <row> + <entry>decimals</entry> + <entry>The number of decimals used (for integer fields)</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_num_fields</function>, + <function>mysqli_fetch_field</function>&listendand; + <function>mysqli_fetch_fields</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -125,13 +123,13 @@ /* Get field information for column 'SurfaceArea' */ $finfo = $result->fetch_field_direct(1); - + printf("Name: %s\n", $finfo->name); printf("Table: %s\n", $finfo->table); printf("max. Len: %d\n", $finfo->max_length); printf("Flags: %d\n", $finfo->flags); printf("Type: %d\n", $finfo->type); - + $result->close(); } @@ -139,11 +137,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -160,7 +158,7 @@ /* Get field information for column 'SurfaceArea' */ $finfo = mysqli_fetch_field_direct($result, 1); - + printf("Name: %s\n", $finfo->name); printf("Table: %s\n", $finfo->table); printf("max. Len: %d\n", $finfo->max_length); @@ -174,10 +172,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Name: SurfaceArea Table: Country @@ -185,9 +183,9 @@ Flags: 32769 Type: 4 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-fetch-field.xml?r1=1.19&r2=1.20&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-fetch-field.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-fetch-field.xml:1.19 phpdoc/en/reference/mysqli/functions/mysqli-fetch-field.xml:1.20 --- phpdoc/en/reference/mysqli/functions/mysqli-fetch-field.xml:1.19 Thu Mar 2 12:22:50 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-fetch-field.xml Sat Jan 27 17:37:36 2007 @@ -1,114 +1,114 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> - <refentry id="function.mysqli-fetch-field"> - <refnamediv> - <refname>mysqli_fetch_field</refname> - <refname>result->fetch_field</refname> - <refpurpose>Returns the next field in the result set</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>object</type><methodname>mysqli_fetch_field</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>object</type><methodname>fetch_field</methodname> - <void/> - </methodsynopsis> - </classsynopsis> - <para> - The <function>mysqli_fetch_field</function> returns the definition of one column - of a result set as an object. Call this function repeatedly to retrieve - information about all columns in the result set. - <function>mysqli_fetch_field</function> returns &false; when no more fields - are left. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns an object which contains field definition information or &false; if no field information - is available. - </para> - <para> - <table> - <title>Object properties</title> - <tgroup cols='2'> - <thead> - <row> - <entry>Property</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>name</entry> - <entry>The name of the column</entry> - </row> - <row> - <entry>orgname</entry> - <entry>Original column name if an alias was specified</entry> - </row> - <row> - <entry>table</entry> - <entry>The name of the table this field belongs to (if not calculated)</entry> - </row> - <row> - <entry>orgtable</entry> - <entry>Original table name if an alias was specified</entry> - </row> - <row> - <entry>def</entry> - <entry>The default value for this field, represented as a string</entry> - </row> - <row> - <entry>max_length</entry> - <entry>The maximum width of the field for the result set.</entry> - </row> - <row> - <entry>length</entry> - <entry>The width of the field, as specified in the table definition.</entry> - </row> - <row> - <entry>charsetnr</entry> - <entry>The character set number for the field.</entry> - </row> - <row> - <entry>flags</entry> - <entry>An integer representing the bit-flags for the field.</entry> - </row> - <row> - <entry>type</entry> - <entry>The data type used for this field</entry> - </row> - <row> - <entry>decimals</entry> - <entry>The number of decimals used (for integer fields)</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_num_fields</function>, - <function>mysqli_fetch_field_direct</function>, - <function>mysqli_fetch_fields</function>&listendand; - <function>mysqli_field_seek</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.20 $ --> +<refentry id="function.mysqli-fetch-field"> + <refnamediv> + <refname>mysqli_fetch_field</refname> + <refname>result->fetch_field</refname> + <refpurpose>Returns the next field in the result set</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>object</type><methodname>mysqli_fetch_field</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>object</type><methodname>fetch_field</methodname> + <void/> + </methodsynopsis> + </classsynopsis> + <para> + The <function>mysqli_fetch_field</function> returns the definition of one column + of a result set as an object. Call this function repeatedly to retrieve + information about all columns in the result set. + <function>mysqli_fetch_field</function> returns &false; when no more fields + are left. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns an object which contains field definition information or &false; if no field information + is available. + </para> + <para> + <table> + <title>Object properties</title> + <tgroup cols='2'> + <thead> + <row> + <entry>Property</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>name</entry> + <entry>The name of the column</entry> + </row> + <row> + <entry>orgname</entry> + <entry>Original column name if an alias was specified</entry> + </row> + <row> + <entry>table</entry> + <entry>The name of the table this field belongs to (if not calculated)</entry> + </row> + <row> + <entry>orgtable</entry> + <entry>Original table name if an alias was specified</entry> + </row> + <row> + <entry>def</entry> + <entry>The default value for this field, represented as a string</entry> + </row> + <row> + <entry>max_length</entry> + <entry>The maximum width of the field for the result set.</entry> + </row> + <row> + <entry>length</entry> + <entry>The width of the field, as specified in the table definition.</entry> + </row> + <row> + <entry>charsetnr</entry> + <entry>The character set number for the field.</entry> + </row> + <row> + <entry>flags</entry> + <entry>An integer representing the bit-flags for the field.</entry> + </row> + <row> + <entry>type</entry> + <entry>The data type used for this field</entry> + </row> + <row> + <entry>decimals</entry> + <entry>The number of decimals used (for integer fields)</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_num_fields</function>, + <function>mysqli_fetch_field_direct</function>, + <function>mysqli_fetch_fields</function>&listendand; + <function>mysqli_field_seek</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -125,13 +125,13 @@ /* Get field information for all columns */ while ($finfo = $result->fetch_field()) { - + printf("Name: %s\n", $finfo->name); printf("Table: %s\n", $finfo->table); printf("max. Len: %d\n", $finfo->max_length); printf("Flags: %d\n", $finfo->flags); printf("Type: %d\n\n", $finfo->type); - } + } $result->close(); } @@ -139,11 +139,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -160,7 +160,7 @@ /* Get field information for all fields */ while ($finfo = mysqli_fetch_field($result)) { - + printf("Name: %s\n", $finfo->name); printf("Table: %s\n", $finfo->table); printf("max. Len: %d\n", $finfo->max_length); @@ -174,10 +174,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Name: Name Table: Country @@ -192,9 +192,9 @@ Type: 4 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-fetch-fields.xml?r1=1.21&r2=1.22&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-fetch-fields.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-fetch-fields.xml:1.21 phpdoc/en/reference/mysqli/functions/mysqli-fetch-fields.xml:1.22 --- phpdoc/en/reference/mysqli/functions/mysqli-fetch-fields.xml:1.21 Thu Mar 2 12:22:50 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-fetch-fields.xml Sat Jan 27 17:37:36 2007 @@ -1,111 +1,111 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.21 $ --> - <refentry id="function.mysqli-fetch-fields"> - <refnamediv> - <refname>mysqli_fetch_fields</refname> - <refname>result->fetch_fields</refname> - <refpurpose>Returns an array of objects representing the fields in a result set</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural Style:</para> - <methodsynopsis> - <type>array</type><methodname>mysqli_fetch_fields</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>array</type><methodname>fetch_fields</methodname> - <void/> - </methodsynopsis> - </classsynopsis> - <para> - This function serves an identical purpose to the <function>mysqli_fetch_field</function> - function with the single difference that, instead of returning one object at a time for - each field, the columns are returned as an array of objects. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns an array of objects which contains field definition information or &false; if no field information - is available. - </para> - <para> - <table> - <title>Object properties</title> - <tgroup cols='2'> - <thead> - <row> - <entry>Property</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>name</entry> - <entry>The name of the column</entry> - </row> - <row> - <entry>orgname</entry> - <entry>Original column name if an alias was specified</entry> - </row> - <row> - <entry>table</entry> - <entry>The name of the table this field belongs to (if not calculated)</entry> - </row> - <row> - <entry>orgtable</entry> - <entry>Original table name if an alias was specified</entry> - </row> - <row> - <entry>def</entry> - <entry>The default value for this field, represented as a string</entry> - </row> - <row> - <entry>max_length</entry> - <entry>The maximum width of the field for the result set.</entry> - </row> - <row> - <entry>length</entry> - <entry>The width of the field, as specified in the table definition.</entry> - </row> - <row> - <entry>charsetnr</entry> - <entry>The character set number for the field.</entry> - </row> - <row> - <entry>flags</entry> - <entry>An integer representing the bit-flags for the field.</entry> - </row> - <row> - <entry>type</entry> - <entry>The data type used for this field</entry> - </row> - <row> - <entry>decimals</entry> - <entry>The number of decimals used (for integer fields)</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_num_fields</function>, - <function>mysqli_fetch_field</function>&listendand; - <function>mysqli_fetch_field_direct</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.22 $ --> +<refentry id="function.mysqli-fetch-fields"> + <refnamediv> + <refname>mysqli_fetch_fields</refname> + <refname>result->fetch_fields</refname> + <refpurpose>Returns an array of objects representing the fields in a result set</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural Style:</para> + <methodsynopsis> + <type>array</type><methodname>mysqli_fetch_fields</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>array</type><methodname>fetch_fields</methodname> + <void/> + </methodsynopsis> + </classsynopsis> + <para> + This function serves an identical purpose to the <function>mysqli_fetch_field</function> + function with the single difference that, instead of returning one object at a time for + each field, the columns are returned as an array of objects. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns an array of objects which contains field definition information or &false; if no field information + is available. + </para> + <para> + <table> + <title>Object properties</title> + <tgroup cols='2'> + <thead> + <row> + <entry>Property</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry>name</entry> + <entry>The name of the column</entry> + </row> + <row> + <entry>orgname</entry> + <entry>Original column name if an alias was specified</entry> + </row> + <row> + <entry>table</entry> + <entry>The name of the table this field belongs to (if not calculated)</entry> + </row> + <row> + <entry>orgtable</entry> + <entry>Original table name if an alias was specified</entry> + </row> + <row> + <entry>def</entry> + <entry>The default value for this field, represented as a string</entry> + </row> + <row> + <entry>max_length</entry> + <entry>The maximum width of the field for the result set.</entry> + </row> + <row> + <entry>length</entry> + <entry>The width of the field, as specified in the table definition.</entry> + </row> + <row> + <entry>charsetnr</entry> + <entry>The character set number for the field.</entry> + </row> + <row> + <entry>flags</entry> + <entry>An integer representing the bit-flags for the field.</entry> + </row> + <row> + <entry>type</entry> + <entry>The data type used for this field</entry> + </row> + <row> + <entry>decimals</entry> + <entry>The number of decimals used (for integer fields)</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_num_fields</function>, + <function>mysqli_fetch_field</function>&listendand; + <function>mysqli_fetch_field_direct</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -129,7 +129,7 @@ printf("max. Len: %d\n", $val->max_length); printf("Flags: %d\n", $val->flags); printf("Type: %d\n\n", $val->type); - } + } $result->close(); } @@ -137,11 +137,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -158,14 +158,14 @@ /* Get field information for all columns */ $finfo = mysqli_fetch_fields($result); - + foreach ($finfo as $val) { printf("Name: %s\n", $val->name); printf("Table: %s\n", $val->table); printf("max. Len: %d\n", $val->max_length); printf("Flags: %d\n", $val->flags); printf("Type: %d\n\n", $val->type); - } + } mysqli_free_result($result); } @@ -173,10 +173,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Name: Name Table: Country @@ -191,9 +191,9 @@ Type: 4 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-fetch-lengths.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-fetch-lengths.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-fetch-lengths.xml:1.17 phpdoc/en/reference/mysqli/functions/mysqli-fetch-lengths.xml:1.18 --- phpdoc/en/reference/mysqli/functions/mysqli-fetch-lengths.xml:1.17 Fri Jul 1 13:07:49 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-fetch-lengths.xml Sat Jan 27 17:37:36 2007 @@ -1,47 +1,47 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> - <refentry id="function.mysqli-fetch-lengths"> - <refnamediv> - <refname>mysqli_fetch_lengths</refname> - <refname>result->lengths</refname> - <refpurpose>Returns the lengths of the columns of the current row in the result set</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>array</type><methodname>mysqli_fetch_lengths</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <fieldsynopsis><type>array</type><varname>lengths</varname></fieldsynopsis> - </classsynopsis> - <para> - The <function>mysqli_fetch_lengths</function> function returns an array containing the - lengths of every column of the current row within the result set represented by the - <parameter>result</parameter> parameter. If successful, a numerically indexed array - representing the lengths of each column is returned or &false; on failure. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - An array of integers representing the size of each column (not including - any terminating null characters). &false; if an error occurred. - </para> - <para> - <function>mysqli_fetch_lengths</function> is valid only for the current row of the result set. - It returns &false; if you call it before calling mysqli_fetch_row/array/object or after retrieving - all rows in the result. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.18 $ --> +<refentry id="function.mysqli-fetch-lengths"> + <refnamediv> + <refname>mysqli_fetch_lengths</refname> + <refname>result->lengths</refname> + <refpurpose>Returns the lengths of the columns of the current row in the result set</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>array</type><methodname>mysqli_fetch_lengths</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <fieldsynopsis><type>array</type><varname>lengths</varname></fieldsynopsis> + </classsynopsis> + <para> + The <function>mysqli_fetch_lengths</function> function returns an array containing the + lengths of every column of the current row within the result set represented by the + <parameter>result</parameter> parameter. If successful, a numerically indexed array + representing the lengths of each column is returned or &false; on failure. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + An array of integers representing the size of each column (not including + any terminating null characters). &false; if an error occurred. + </para> + <para> + <function>mysqli_fetch_lengths</function> is valid only for the current row of the result set. + It returns &false; if you call it before calling mysqli_fetch_row/array/object or after retrieving + all rows in the result. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -69,11 +69,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -101,10 +101,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Field 1 has Length 3 Field 2 has Length 5 @@ -122,9 +122,9 @@ Field 14 has Length 3 Field 15 has Length 2 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-fetch-object.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-fetch-object.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-fetch-object.xml:1.17 phpdoc/en/reference/mysqli/functions/mysqli-fetch-object.xml:1.18 --- phpdoc/en/reference/mysqli/functions/mysqli-fetch-object.xml:1.17 Thu Aug 31 22:09:10 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-fetch-object.xml Sat Jan 27 17:37:36 2007 @@ -1,83 +1,81 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> - <refentry id="function.mysqli-fetch-object"> - <refnamediv> - <refname>mysqli_fetch_object</refname> - <refname>result->fetch_object</refname> - <refpurpose>Returns the current row of a result set as an object</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>object</type><methodname>mysqli_fetch_object</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>params</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>object</type><methodname>fetch_object</methodname> - <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>params</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - The <function>mysqli_fetch_object</function> will return the current row result set - as an object where the attributes of the object represent the names of the fields found - within the result set. If no more rows exist in the current result set, &null; is returned. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns an object that corresponds to the fetched row or &null; if there are no more rows in resultset. - </para> - &database.field-case; - &database.fetch-null; - </refsect1> - - <refsect1 role="changelog"> - &reftitle.changelog; - <para> - <informaltable> - <tgroup cols="2"> - <thead> - <row> - <entry>&Version;</entry> - <entry>&Description;</entry> - </row> - </thead> - <tbody> - <row> - <entry>5.0.0</entry> - <entry> - Added the ability to return as a different object. - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </para> - </refsect1> - - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_array</function>, - <function>mysqli_fetch_assoc</function>, - <function>mysqli_fetch_row</function>, - <function>mysqli_query</function>&listendand; - <function>mysqli_data_seek</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.18 $ --> +<refentry id="function.mysqli-fetch-object"> + <refnamediv> + <refname>mysqli_fetch_object</refname> + <refname>result->fetch_object</refname> + <refpurpose>Returns the current row of a result set as an object</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>object</type><methodname>mysqli_fetch_object</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>params</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>object</type><methodname>fetch_object</methodname> + <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>params</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + The <function>mysqli_fetch_object</function> will return the current row result set + as an object where the attributes of the object represent the names of the fields found + within the result set. If no more rows exist in the current result set, &null; is returned. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns an object that corresponds to the fetched row or &null; if there are no more rows in resultset. + </para> + &database.field-case; + &database.fetch-null; + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>5.0.0</entry> + <entry> + Added the ability to return as a different object. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_fetch_array</function>, + <function>mysqli_fetch_assoc</function>, + <function>mysqli_fetch_row</function>, + <function>mysqli_query</function>&listendand; + <function>mysqli_data_seek</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -105,11 +103,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -137,10 +135,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Pueblo (USA) Arvada (USA) @@ -148,9 +146,9 @@ Green Bay (USA) Santa Clara (USA) ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-fetch-row.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-fetch-row.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-fetch-row.xml:1.16 phpdoc/en/reference/mysqli/functions/mysqli-fetch-row.xml:1.17 --- phpdoc/en/reference/mysqli/functions/mysqli-fetch-row.xml:1.16 Thu Nov 2 21:03:18 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-fetch-row.xml Sat Jan 27 17:37:36 2007 @@ -1,60 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> - <refentry id="function.mysqli-fetch-row"> - <refnamediv> - <refname>mysqli_fetch_row</refname> - <refname>result->fetch_row</refname> - <refpurpose>Get a result row as an enumerated array</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>mixed</type><methodname>mysqli_fetch_row</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>mixed</type><methodname>fetch_row</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - Returns an array that corresponds to the fetched row, or &null; if there are no more rows. - </para> - <para> - <function>mysqli_fetch_row</function> fetches one row of data from the result set represented by - <parameter>result</parameter> and returns it as an enumerated array, where each column is stored - in an array offset starting from 0 (zero). Each subsequent call to the - <function>mysqli_fetch_row</function> function will return the next row within the result set, - or &null; if there are no more rows. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - <function>mysqli_fetch_row</function> returns an array that corresponds to the fetched row - or &null; if there are no more rows in result set. - </para> - &database.fetch-null; - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_array</function>, - <function>mysqli_fetch_assoc</function>, - <function>mysqli_fetch_object</function>, - <function>mysqli_query</function>&listendand; - <function>mysqli_data_seek</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.17 $ --> +<refentry id="function.mysqli-fetch-row"> + <refnamediv> + <refname>mysqli_fetch_row</refname> + <refname>result->fetch_row</refname> + <refpurpose>Get a result row as an enumerated array</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>mixed</type><methodname>mysqli_fetch_row</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>mixed</type><methodname>fetch_row</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns an array that corresponds to the fetched row, or &null; if there are no more rows. + </para> + <para> + <function>mysqli_fetch_row</function> fetches one row of data from the result set represented by + <parameter>result</parameter> and returns it as an enumerated array, where each column is stored + in an array offset starting from 0 (zero). Each subsequent call to the + <function>mysqli_fetch_row</function> function will return the next row within the result set, + or &null; if there are no more rows. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + <function>mysqli_fetch_row</function> returns an array that corresponds to the fetched row + or &null; if there are no more rows in result set. + </para> + &database.fetch-null; + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_fetch_array</function>, + <function>mysqli_fetch_assoc</function>, + <function>mysqli_fetch_object</function>, + <function>mysqli_query</function>&listendand; + <function>mysqli_data_seek</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -64,7 +64,7 @@ printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } - + $query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5"; if ($result = $mysqli->query($query)) { @@ -82,11 +82,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -114,10 +114,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Pueblo (USA) Arvada (USA) @@ -125,9 +125,9 @@ Green Bay (USA) Santa Clara (USA) ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-fetch.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-fetch.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-fetch.xml:1.10 phpdoc/en/reference/mysqli/functions/mysqli-fetch.xml:1.11 --- phpdoc/en/reference/mysqli/functions/mysqli-fetch.xml:1.10 Sun Oct 31 16:05:11 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-fetch.xml Sat Jan 27 17:37:36 2007 @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> - <refentry id="function.mysqli-fetch"> - <refnamediv> - <refname>mysqli_fetch</refname> - <refpurpose>Alias for <function>mysqli_stmt_fetch</function></refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para> - This function is an alias of <function>mysqli_stmt_fetch</function>. - For a detailled descripton see description of - <function>mysqli_stmt_fetch</function>. - </para> - <note> - <para> - <function>mysqli_fetch</function> is deprecated and will be removed. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_fetch</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.11 $ --> +<refentry id="function.mysqli-fetch"> + <refnamediv> + <refname>mysqli_fetch</refname> + <refpurpose>Alias for <function>mysqli_stmt_fetch</function></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + This function is an alias of <function>mysqli_stmt_fetch</function>. + For a detailled descripton see description of + <function>mysqli_stmt_fetch</function>. + </para> + <note> + <para> + <function>mysqli_fetch</function> is deprecated and will be removed. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_fetch</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-field-count.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-field-count.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-field-count.xml:1.13 phpdoc/en/reference/mysqli/functions/mysqli-field-count.xml:1.14 --- phpdoc/en/reference/mysqli/functions/mysqli-field-count.xml:1.13 Thu Dec 15 23:27:02 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-field-count.xml Sat Jan 27 17:37:36 2007 @@ -1,50 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> - <refentry id="function.mysqli-field-count"> - <refnamediv> - <refname>mysqli_field_count</refname> - <refname>mysqli->field_count</refname> - <refpurpose>Returns the number of columns for the most recent query</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_field_count</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>int</type><methodname>field_count</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - Returns the number of columns for the most recent query on the connection - represented by the <parameter>link</parameter> parameter. This function - can be useful when using the <function>mysqli_store_result</function> - function to determine if the query should have produced a non-empty result - set or not without knowing the nature of the query. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para>An integer representing the number of fields in a result set</para> - </refsect1> - <refsect1> - &reftitle.examples; - <para> - <example> - <title>Object oriented style</title> - <programlisting role='php'> +<!-- $Revision: 1.14 $ --> +<refentry id="function.mysqli-field-count"> + <refnamediv> + <refname>mysqli_field_count</refname> + <refname>mysqli->field_count</refname> + <refpurpose>Returns the number of columns for the most recent query</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_field_count</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>field_count</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Returns the number of columns for the most recent query on the connection + represented by the <parameter>link</parameter> parameter. This function + can be useful when using the <function>mysqli_store_result</function> + function to determine if the query should have produced a non-empty result + set or not without knowing the nature of the query. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para>An integer representing the number of fields in a result set</para> + </refsect1> + <refsect1> + &reftitle.examples; + <para> + <example> + <title>Object oriented style</title> + <programlisting role='php'> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "test"); -$mysqli->query( "DROP TABLE IF EXISTS friends"); -$mysqli->query( "CREATE TABLE friends (id int, name varchar(20))"); +$mysqli->query( "DROP TABLE IF EXISTS friends"); +$mysqli->query( "CREATE TABLE friends (id int, name varchar(20))"); $mysqli->query( "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"); @@ -66,17 +66,17 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role='php'> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role='php'> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "test"); -mysqli_query($link, "DROP TABLE IF EXISTS friends"); -mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))"); +mysqli_query($link, "DROP TABLE IF EXISTS friends"); +mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))"); mysqli_query($link, "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"); @@ -97,11 +97,11 @@ mysqli_close($link); ?> ]]> - </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/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-field-seek.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-field-seek.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-field-seek.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-field-seek.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-field-seek.xml:1.8 Thu Jun 23 16:53:26 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-field-seek.xml Sat Jan 27 17:37:36 2007 @@ -1,54 +1,52 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-field-seek"> - <refnamediv> - <refname>mysqli_field_seek</refname> - <refname>result->field_seek</refname> - <refpurpose> - Set result pointer to a specified field offset - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_field_seek</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>field_seek</methodname> - <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - Sets the field cursor to the given offset. The next call to <function>mysqli_fetch_field</function> - will retrieve the field definition of the column associated with that offset. - </para> - <note> - <para>To seek to the beginning of a row, pass an offset value of zero.</para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - <function>mysqli_field_seek</function> returns previuos value of field cursor. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_field</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-field-seek"> + <refnamediv> + <refname>mysqli_field_seek</refname> + <refname>result->field_seek</refname> + <refpurpose>Set result pointer to a specified field offset</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_field_seek</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>field_seek</methodname> + <methodparam><type>int</type><parameter>fieldnr</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + Sets the field cursor to the given offset. The next call to <function>mysqli_fetch_field</function> + will retrieve the field definition of the column associated with that offset. + </para> + <note> + <para>To seek to the beginning of a row, pass an offset value of zero.</para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + <function>mysqli_field_seek</function> returns previuos value of field cursor. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_fetch_field</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -66,13 +64,13 @@ /* Get field information for 2nd column */ $result->field_seek(1); $finfo = $result->fetch_field(); - + printf("Name: %s\n", $finfo->name); printf("Table: %s\n", $finfo->table); printf("max. Len: %d\n", $finfo->max_length); printf("Flags: %d\n", $finfo->flags); printf("Type: %d\n\n", $finfo->type); - + $result->close(); } @@ -80,11 +78,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -102,7 +100,7 @@ /* Get field information for 2nd column */ mysqli_field_seek($result, 1); $finfo = mysqli_fetch_field($result); - + printf("Name: %s\n", $finfo->name); printf("Table: %s\n", $finfo->table); printf("max. Len: %d\n", $finfo->max_length); @@ -116,10 +114,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Name: SurfaceArea Table: Country @@ -128,9 +126,9 @@ Type: 4 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-field-tell.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-field-tell.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-field-tell.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-field-tell.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-field-tell.xml:1.7 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-field-tell.xml Sat Jan 27 17:37:36 2007 @@ -1,51 +1,49 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-field-tell"> - <refnamediv> - <refname>mysqli_field_tell</refname> - <refname>result->current_field</refname> - <refpurpose> - Get current field offset of a result pointer - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_field_tell</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <fieldsynopsis> - <type>int</type><varname>current_field</varname> - </fieldsynopsis> - </classsynopsis> - <para> - Returns the position of the field cursor used for the last - <function>mysqli_fetch_field</function> call. This value can - be used as an argument to <function>mysqli_field_seek</function>. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns current offset of field cursor. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_field</function>&listendand; - <function>mysqli_field_seek</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-field-tell"> + <refnamediv> + <refname>mysqli_field_tell</refname> + <refname>result->current_field</refname> + <refpurpose>Get current field offset of a result pointer</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_field_tell</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <fieldsynopsis> + <type>int</type><varname>current_field</varname> + </fieldsynopsis> + </classsynopsis> + <para> + Returns the position of the field cursor used for the last + <function>mysqli_fetch_field</function> call. This value can + be used as an argument to <function>mysqli_field_seek</function>. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns current offset of field cursor. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_fetch_field</function>&listendand; + <function>mysqli_field_seek</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -66,13 +64,13 @@ /* get fieldpointer offset */ $currentfield = $result->current_field; - printf("Column %d:\n", $currentfield); + printf("Column %d:\n", $currentfield); printf("Name: %s\n", $finfo->name); printf("Table: %s\n", $finfo->table); printf("max. Len: %d\n", $finfo->max_length); printf("Flags: %d\n", $finfo->flags); printf("Type: %d\n\n", $finfo->type); - } + } $result->close(); } @@ -80,11 +78,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -101,11 +99,11 @@ /* Get field information for all fields */ while ($finfo = mysqli_fetch_field($result)) { - + /* get fieldpointer offset */ $currentfield = mysqli_field_tell($result); - printf("Column %d:\n", $currentfield); + printf("Column %d:\n", $currentfield); printf("Name: %s\n", $finfo->name); printf("Table: %s\n", $finfo->table); printf("max. Len: %d\n", $finfo->max_length); @@ -119,10 +117,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Column 1: Name: Name @@ -139,9 +137,9 @@ Type: 4 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-free-result.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-free-result.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-free-result.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-free-result.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-free-result.xml:1.8 Tue Nov 1 18:36:38 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-free-result.xml Sat Jan 27 17:37:36 2007 @@ -1,65 +1,65 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-free-result"> - <refnamediv> - <refname>mysqli_free_result</refname> - <refname>result->free</refname> - <refpurpose>Frees the memory associated with a result</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>void</type><methodname>mysqli_free_result</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (all methods are equivalent):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <methodsynopsis> - <type>void</type><methodname>free</methodname> - <void /> - </methodsynopsis> - <methodsynopsis> - <type>void</type><methodname>close</methodname> - <void /> - </methodsynopsis> - <methodsynopsis> - <type>void</type><methodname>free_result</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - The <function>mysqli_free_result</function> function frees the memory - associated with the result represented by the - <parameter>result</parameter> parameter, which was allocated by - <function>mysqli_query</function>, <function>mysqli_store_result</function> - or <function>mysqli_use_result</function>. - </para> - <note> - <para> - You should always free your result with <function>mysqli_free_result</function>, - when your result object is not needed anymore. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - This function doesn't return any value. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_query</function>, - <function>mysqli_stmt_store_result</function>, - <function>mysqli_store_result</function>&listendand; - <function>mysqli_use_result</function>. - </para> - </refsect1> - - </refentry> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-free-result"> + <refnamediv> + <refname>mysqli_free_result</refname> + <refname>result->free</refname> + <refpurpose>Frees the memory associated with a result</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>void</type><methodname>mysqli_free_result</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (all methods are equivalent):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <methodsynopsis> + <type>void</type><methodname>free</methodname> + <void /> + </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>close</methodname> + <void /> + </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>free_result</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + The <function>mysqli_free_result</function> function frees the memory + associated with the result represented by the + <parameter>result</parameter> parameter, which was allocated by + <function>mysqli_query</function>, <function>mysqli_store_result</function> + or <function>mysqli_use_result</function>. + </para> + <note> + <para> + You should always free your result with <function>mysqli_free_result</function>, + when your result object is not needed anymore. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + This function doesn't return any value. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_query</function>, + <function>mysqli_stmt_store_result</function>, + <function>mysqli_store_result</function>&listendand; + <function>mysqli_use_result</function>. + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-get-client-info.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-get-client-info.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-get-client-info.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-get-client-info.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-get-client-info.xml:1.7 Sun Oct 31 16:05:11 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-get-client-info.xml Sat Jan 27 17:37:36 2007 @@ -1,42 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-get-client-info"> - <refnamediv> - <refname>mysqli_get_client_info</refname> - <refpurpose>Returns the MySQL client version as a string</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>mysqli_get_client_info</methodname> - <void /> - </methodsynopsis> - <para> - The <function>mysqli_get_client_info</function> function is used to - return a string representing the client version being used in the - MySQLi extension. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - A string that represents the MySQL client library version - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_get_client_version</function>, - <function>mysqli_get_server_info</function>&listendand; - <function>mysqli_get_server_version</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <para> - <example> - <title>mysqli_get_client_info</title> - <programlisting role='php'> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-get-client-info"> + <refnamediv> + <refname>mysqli_get_client_info</refname> + <refpurpose>Returns the MySQL client version as a string</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>mysqli_get_client_info</methodname> + <void /> + </methodsynopsis> + <para> + The <function>mysqli_get_client_info</function> function is used to + return a string representing the client version being used in the + MySQLi extension. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + A string that represents the MySQL client library version + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_get_client_version</function>, + <function>mysqli_get_server_info</function>&listendand; + <function>mysqli_get_server_version</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <para> + <example> + <title>mysqli_get_client_info</title> + <programlisting role='php'> <![CDATA[ <?php @@ -46,11 +46,11 @@ printf("Client library version: %s\n", mysqli_get_client_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/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-get-client-version.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-get-client-version.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-get-client-version.xml:1.5 phpdoc/en/reference/mysqli/functions/mysqli-get-client-version.xml:1.6 --- phpdoc/en/reference/mysqli/functions/mysqli-get-client-version.xml:1.5 Sun Oct 31 16:05:11 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-get-client-version.xml Sat Jan 27 17:37:36 2007 @@ -1,46 +1,46 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> - <refentry id="function.mysqli-get-client-version"> - <refnamediv> - <refname>mysqli_get_client_version</refname> - <refpurpose>Get MySQL client info</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>mysqli_get_client_version</methodname> - <void/> - </methodsynopsis> - <para> - Returns client version number as an integer. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - A number that represents the MySQL client library version in format: - <literal>main_version*10000 + minor_version *100 + sub_version</literal>. - For example, 4.1.0 is returned as 40100. - </para> - <para> - This is useful to quickly determine the version of the client library - to know if some capability exits. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_get_client_info</function>, - <function>mysqli_get_server_info</function>&listendand; - <function>mysqli_get_server_version</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <para> - <example> - <title>mysqli_get_client_version</title> - <programlisting role='php'> +<!-- $Revision: 1.6 $ --> +<refentry id="function.mysqli-get-client-version"> + <refnamediv> + <refname>mysqli_get_client_version</refname> + <refpurpose>Get MySQL client info</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>mysqli_get_client_version</methodname> + <void/> + </methodsynopsis> + <para> + Returns client version number as an integer. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + A number that represents the MySQL client library version in format: + <literal>main_version*10000 + minor_version *100 + sub_version</literal>. + For example, 4.1.0 is returned as 40100. + </para> + <para> + This is useful to quickly determine the version of the client library + to know if some capability exits. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_get_client_info</function>, + <function>mysqli_get_server_info</function>&listendand; + <function>mysqli_get_server_version</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <para> + <example> + <title>mysqli_get_client_version</title> + <programlisting role='php'> <![CDATA[ <?php @@ -50,11 +50,11 @@ printf("Client library version: %d\n", mysqli_get_client_version()); ?> ]]> - </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/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-get-host-info.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-get-host-info.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-get-host-info.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-get-host-info.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-get-host-info.xml:1.8 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-get-host-info.xml Sat Jan 27 17:37:36 2007 @@ -1,46 +1,46 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-get-host-info"> - <refnamediv> - <refname>mysqli_get_host_info</refname> - <refname>mysqli->get_host_info</refname> - <refpurpose>Returns a string representing the type of connection used</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procdural style:</para> - <methodsynopsis> - <type>string</type><methodname>mysqli_get_host_info</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <fieldsynopsis><type>string</type><varname>host_info</varname></fieldsynopsis> - </classsynopsis> - <para> - The <function>mysqli_get_host_info</function> function returns a string - describing the connection represented by the <parameter>link</parameter> - parameter is using (including the server host name). - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - A character string representing the server hostname and the connection type. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_get_proto_info</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-get-host-info"> + <refnamediv> + <refname>mysqli_get_host_info</refname> + <refname>mysqli->get_host_info</refname> + <refpurpose>Returns a string representing the type of connection used</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procdural style:</para> + <methodsynopsis> + <type>string</type><methodname>mysqli_get_host_info</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>string</type><varname>host_info</varname></fieldsynopsis> + </classsynopsis> + <para> + The <function>mysqli_get_host_info</function> function returns a string + describing the connection represented by the <parameter>link</parameter> + parameter is using (including the server host name). + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + A character string representing the server hostname and the connection type. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_get_proto_info</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -58,11 +58,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -80,16 +80,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Host info: Localhost via UNIX socket ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-get-metadata.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-get-metadata.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-get-metadata.xml:1.5 phpdoc/en/reference/mysqli/functions/mysqli-get-metadata.xml:1.6 --- phpdoc/en/reference/mysqli/functions/mysqli-get-metadata.xml:1.5 Sun Oct 31 16:05:11 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-get-metadata.xml Sat Jan 27 17:37:36 2007 @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> - <refentry id="function.mysqli-get-metadata"> - <refnamediv> - <refname>mysqli_get_metadata</refname> - <refpurpose>Alias for <function>mysqli_stmt_result_metadata</function></refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para> - This function is an alias of <function>mysqli_stmt_result_metadata</function>. - For a detailled descripton see description of - <function>mysqli_stmt_result_metadata</function>. - </para> - <note> - <para> - <function>mysqli_get_metadata</function> is deprecated and will be removed. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_result_metadata</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.mysqli-get-metadata"> + <refnamediv> + <refname>mysqli_get_metadata</refname> + <refpurpose>Alias for <function>mysqli_stmt_result_metadata</function></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + This function is an alias of <function>mysqli_stmt_result_metadata</function>. + For a detailled descripton see description of + <function>mysqli_stmt_result_metadata</function>. + </para> + <note> + <para> + <function>mysqli_get_metadata</function> is deprecated and will be removed. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_result_metadata</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-get-proto-info.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-get-proto-info.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-get-proto-info.xml:1.9 phpdoc/en/reference/mysqli/functions/mysqli-get-proto-info.xml:1.10 --- phpdoc/en/reference/mysqli/functions/mysqli-get-proto-info.xml:1.9 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-get-proto-info.xml Sat Jan 27 17:37:36 2007 @@ -1,45 +1,45 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> - <refentry id="function.mysqli-get-proto-info"> - <refnamediv> - <refname>mysqli_get_proto_info</refname> - <refname>mysqli->protocol_version</refname> - <refpurpose>Returns the version of the MySQL protocol used</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_get_proto_info</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <fieldsynopsis><type>string</type><varname>protocol_version</varname></fieldsynopsis> - </classsynopsis> - <para> - Returns an integer representing the MySQL protocol version used by the - connection represented by the <parameter>link</parameter> parameter. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns an integer representing the protocol version. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_get_host_info</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id="function.mysqli-get-proto-info"> + <refnamediv> + <refname>mysqli_get_proto_info</refname> + <refname>mysqli->protocol_version</refname> + <refpurpose>Returns the version of the MySQL protocol used</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_get_proto_info</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>string</type><varname>protocol_version</varname></fieldsynopsis> + </classsynopsis> + <para> + Returns an integer representing the MySQL protocol version used by the + connection represented by the <parameter>link</parameter> parameter. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns an integer representing the protocol version. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_get_host_info</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password"); @@ -57,11 +57,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password"); @@ -79,16 +79,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Protocol version: 10 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-get-server-info.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-get-server-info.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-get-server-info.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-get-server-info.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-get-server-info.xml:1.7 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-get-server-info.xml Sat Jan 27 17:37:36 2007 @@ -1,48 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-get-server-info"> - <refnamediv> - <refname>mysqli_get_server_info</refname> - <refname>mysqli->server_info</refname> - <refpurpose>Returns the version of the MySQL server</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>string</type><methodname>mysqli_get_server_info</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <fieldsynopsis><type>string</type><varname>server_info</varname></fieldsynopsis> - </classsynopsis> - <para> - Returns a string representing the version of the MySQL server that the - MySQLi extension is connected to (represented by the - <parameter>link</parameter> parameter). - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - A character string representing the server version. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_get_client_info</function>, - <function>mysqli_get_client_version</function>&listendand; - <function>mysqli_get_server_version</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-get-server-info"> + <refnamediv> + <refname>mysqli_get_server_info</refname> + <refname>mysqli->server_info</refname> + <refpurpose>Returns the version of the MySQL server</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>string</type><methodname>mysqli_get_server_info</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>string</type><varname>server_info</varname></fieldsynopsis> + </classsynopsis> + <para> + Returns a string representing the version of the MySQL server that the + MySQLi extension is connected to (represented by the + <parameter>link</parameter> parameter). + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + A character string representing the server version. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_get_client_info</function>, + <function>mysqli_get_client_version</function>&listendand; + <function>mysqli_get_server_version</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password"); @@ -60,11 +60,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password"); @@ -82,16 +82,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Server version: 4.1.2-alpha-debug ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-get-server-version.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-get-server-version.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-get-server-version.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-get-server-version.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-get-server-version.xml:1.7 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-get-server-version.xml Sat Jan 27 17:37:36 2007 @@ -1,52 +1,52 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-get-server-version"> - <refnamediv> - <refname>mysqli_get_server_version</refname> - <refpurpose>Returns the version of the MySQL server as an integer</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_get_server_version</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <fieldsynopsis><type>int</type><varname>server_version</varname></fieldsynopsis> - </classsynopsis> - <para> - The <function>mysqli_get_server_version</function> function returns the - version of the server connected to (represented by the - <parameter>link</parameter> parameter) as an integer. - </para> - <para> - The form of this version number is - <literal>main_version * 10000 + minor_version * 100 + sub_version</literal> - (i.e. version 4.1.0 is 40100). - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - An integer representing the server version. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_get_client_info</function>, - <function>mysqli_get_client_version</function>&listendand; - <function>mysqli_get_server_info</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-get-server-version"> + <refnamediv> + <refname>mysqli_get_server_version</refname> + <refpurpose>Returns the version of the MySQL server as an integer</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_get_server_version</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>int</type><varname>server_version</varname></fieldsynopsis> + </classsynopsis> + <para> + The <function>mysqli_get_server_version</function> function returns the + version of the server connected to (represented by the + <parameter>link</parameter> parameter) as an integer. + </para> + <para> + The form of this version number is + <literal>main_version * 10000 + minor_version * 100 + sub_version</literal> + (i.e. version 4.1.0 is 40100). + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + An integer representing the server version. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_get_client_info</function>, + <function>mysqli_get_client_version</function>&listendand; + <function>mysqli_get_server_info</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password"); @@ -64,11 +64,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password"); @@ -86,16 +86,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Server version: 40102 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-info.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-info.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-info.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-info.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-info.xml:1.8 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-info.xml Sat Jan 27 17:37:36 2007 @@ -1,89 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-info"> - <refnamediv> - <refname>mysqli_info</refname> - <refname>mysqli->info</refname> - <refpurpose>Retrieves information about the most recently executed query</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>string</type><methodname>mysqli_info</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property)</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <fieldsynopsis><type>string</type><varname>info</varname></fieldsynopsis> - </classsynopsis> - <para> - The <function>mysqli_info</function> function returns a string providing - information about the last query executed. The nature of this string is - provided below: - </para> - <para> - <table> - <title>Possible mysqli_info return values</title> - <tgroup cols='2'> - <thead> - <row> - <entry>Query type</entry> - <entry>Example result string</entry> - </row> - </thead> - <tbody> - <row> - <entry>INSERT INTO...SELECT...</entry> - <entry>Records: 100 Duplicates: 0 Warnings: 0</entry> - </row> - <row> - <entry>INSERT INTO...VALUES (...),(...),(...)</entry> - <entry>Records: 3 Duplicates: 0 Warnings: 0</entry> - </row> - <row> - <entry>LOAD DATA INFILE ...</entry> - <entry>Records: 1 Deleted: 0 Skipped: 0 Warnings: 0</entry> - </row> - <row> - <entry>ALTER TABLE ...</entry> - <entry>Records: 3 Duplicates: 0 Warnings: 0</entry> - </row> - <row> - <entry>UPDATE ...</entry> - <entry>Rows matched: 40 Changed: 40 Warnings: 0</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <note> - <para> - Queries which do not fall into one of the above formats are not supported. - In these situations, <function>mysqli_info</function> will return an empty string. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - A character string representing additional information about the most recently executed query. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_affected_rows</function>, - <function>mysqli_warning_count</function>&listendand; - <function>mysqli_num_rows</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-info"> + <refnamediv> + <refname>mysqli_info</refname> + <refname>mysqli->info</refname> + <refpurpose>Retrieves information about the most recently executed query</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>string</type><methodname>mysqli_info</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property)</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>string</type><varname>info</varname></fieldsynopsis> + </classsynopsis> + <para> + The <function>mysqli_info</function> function returns a string providing + information about the last query executed. The nature of this string is + provided below: + </para> + <para> + <table> + <title>Possible mysqli_info return values</title> + <tgroup cols='2'> + <thead> + <row> + <entry>Query type</entry> + <entry>Example result string</entry> + </row> + </thead> + <tbody> + <row> + <entry>INSERT INTO...SELECT...</entry> + <entry>Records: 100 Duplicates: 0 Warnings: 0</entry> + </row> + <row> + <entry>INSERT INTO...VALUES (...),(...),(...)</entry> + <entry>Records: 3 Duplicates: 0 Warnings: 0</entry> + </row> + <row> + <entry>LOAD DATA INFILE ...</entry> + <entry>Records: 1 Deleted: 0 Skipped: 0 Warnings: 0</entry> + </row> + <row> + <entry>ALTER TABLE ...</entry> + <entry>Records: 3 Duplicates: 0 Warnings: 0</entry> + </row> + <row> + <entry>UPDATE ...</entry> + <entry>Rows matched: 40 Changed: 40 Warnings: 0</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <note> + <para> + Queries which do not fall into one of the above formats are not supported. + In these situations, <function>mysqli_info</function> will return an empty string. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + A character string representing additional information about the most recently executed query. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_affected_rows</function>, + <function>mysqli_warning_count</function>&listendand; + <function>mysqli_num_rows</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -104,11 +104,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -129,16 +129,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Records: 150 Duplicates: 0 Warnings: 0 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-init.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-init.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-init.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-init.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-init.xml:1.7 Fri Jun 24 09:11:41 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-init.xml Sat Jan 27 17:37:36 2007 @@ -1,45 +1,43 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-init"> - <refnamediv> - <refname>mysqli_init</refname> - <refpurpose> - Initializes MySQLi and returns a resource for use with mysqli_real_connect() - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>mysqli</type><methodname>mysqli_init</methodname> - <void/> - </methodsynopsis> - <para> - Allocates or initializes a MYSQL object suitable for - <function>mysqli_options</function> and <function>mysqli_real_connect</function>. - </para> - <note> - <para> - Any subsequent calls to any mysqli function (except <function>mysqli_options</function>) - will fail until <function>mysqli_real_connect</function> was called. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns an object. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_options</function>, - <function>mysqli_close</function>, - <function>mysqli_real_connect</function>&listendand; - <function>mysqli_connect</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-init"> + <refnamediv> + <refname>mysqli_init</refname> + <refpurpose>Initializes MySQLi and returns a resource for use with mysqli_real_connect()</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>mysqli</type><methodname>mysqli_init</methodname> + <void/> + </methodsynopsis> + <para> + Allocates or initializes a MYSQL object suitable for + <function>mysqli_options</function> and <function>mysqli_real_connect</function>. + </para> + <note> + <para> + Any subsequent calls to any mysqli function (except <function>mysqli_options</function>) + will fail until <function>mysqli_real_connect</function> was called. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns an object. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_options</function>, + <function>mysqli_close</function>, + <function>mysqli_real_connect</function>&listendand; + <function>mysqli_connect</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-insert-id.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-insert-id.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-insert-id.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-insert-id.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-insert-id.xml:1.8 Thu Jun 23 16:53:26 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-insert-id.xml Sat Jan 27 17:37:36 2007 @@ -1,58 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-insert-id"> - <refnamediv> - <refname>mysqli_insert_id</refname> - <refname>mysqli->insert_id</refname> - <refpurpose>Returns the auto generated id used in the last query</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_insert_id</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <fieldsynopsis><type>int</type><varname>insert_id</varname></fieldsynopsis> - </classsynopsis> - <para> - The <function>mysqli_insert_id</function> function returns the ID generated - by a query on a table with a column having the AUTO_INCREMENT attribute. If - the last query wasn't an INSERT or UPDATE statement or if the modified table - does not have a column with the AUTO_INCREMENT attribute, this function will - return zero. - </para> - <note> - <para> - Performing an INSERT or UPDATE statement using the LAST_INSERT_ID() - function will also modify the value returned by the - <function>mysqli_insert_id</function> function. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - The value of the <literal>AUTO_INCREMENT</literal> field that was updated - by the previous query. Returns zero if there was no previous query on the - connection or if the query did not update an <literal>AUTO_INCREMENT</literal> - value. +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-insert-id"> + <refnamediv> + <refname>mysqli_insert_id</refname> + <refname>mysqli->insert_id</refname> + <refpurpose>Returns the auto generated id used in the last query</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_insert_id</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>int</type><varname>insert_id</varname></fieldsynopsis> + </classsynopsis> + <para> + The <function>mysqli_insert_id</function> function returns the ID generated + by a query on a table with a column having the AUTO_INCREMENT attribute. If + the last query wasn't an INSERT or UPDATE statement or if the modified table + does not have a column with the AUTO_INCREMENT attribute, this function will + return zero. </para> - <note> + <note> <para> - If the number is greater than maximal int value, <function>mysqli_insert_id</function> - will return a string. + Performing an INSERT or UPDATE statement using the LAST_INSERT_ID() + function will also modify the value returned by the + <function>mysqli_insert_id</function> function. </para> </note> </refsect1> <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> + &reftitle.returnvalues; + <para> + The value of the <literal>AUTO_INCREMENT</literal> field that was updated + by the previous query. Returns zero if there was no previous query on the + connection or if the query did not update an <literal>AUTO_INCREMENT</literal> + value. +</para> +<note> + <para> + If the number is greater than maximal int value, <function>mysqli_insert_id</function> + will return a string. + </para> +</note> + </refsect1> + <refsect1> +&reftitle.examples; +<example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -77,11 +77,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> +</programlisting> +</example> +<example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -106,14 +106,14 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> +</example> +&example.outputs; +<screen> <![CDATA[ New Record has id 1. ]]> - </screen> +</screen> </refsect1> </refentry> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-kill.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-kill.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-kill.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-kill.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-kill.xml:1.8 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-kill.xml Sat Jan 27 17:37:36 2007 @@ -1,54 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-kill"> - <refnamediv> - <refname>mysqli_kill</refname> - <refname>mysqli->kill</refname> - <refpurpose>Asks the server to kill a MySQL thread</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_kill</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>int</type><parameter>processid</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method)</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>kill</methodname> - <methodparam><type>int</type><parameter>processid</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - This function is used to ask the server to kill a MySQL thread specified - by the <parameter>processid</parameter> parameter. This value must be - retrieved by calling the <function>mysqli_thread_id</function> function. - </para> - <note> - <para> - To stop a running query you should use the SQL command - <literal>KILL QUERY processid</literal>. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para>&return.success;</para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_thread_id</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-kill"> + <refnamediv> + <refname>mysqli_kill</refname> + <refname>mysqli->kill</refname> + <refpurpose>Asks the server to kill a MySQL thread</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_kill</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>int</type><parameter>processid</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method)</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>kill</methodname> + <methodparam><type>int</type><parameter>processid</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + This function is used to ask the server to kill a MySQL thread specified + by the <parameter>processid</parameter> parameter. This value must be + retrieved by calling the <function>mysqli_thread_id</function> function. + </para> + <note> + <para> + To stop a running query you should use the SQL command + <literal>KILL QUERY processid</literal>. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para>&return.success;</para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_thread_id</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -75,11 +75,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -106,16 +106,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Error: MySQL server has gone away ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-master-query.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-master-query.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-master-query.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-master-query.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-master-query.xml:1.8 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-master-query.xml Sat Jan 27 17:37:36 2007 @@ -1,22 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-master-query"> - <refnamediv> - <refname>mysqli_master_query</refname> - <refpurpose>Enforce execution of a query on the master in a master/slave setup</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_master_query</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-master-query"> + <refnamediv> + <refname>mysqli_master_query</refname> + <refpurpose>Enforce execution of a query on the master in a master/slave setup</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_master_query</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-more-results.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-more-results.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-more-results.xml:1.6 phpdoc/en/reference/mysqli/functions/mysqli-more-results.xml:1.7 --- phpdoc/en/reference/mysqli/functions/mysqli-more-results.xml:1.6 Sat Nov 25 12:20:10 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-more-results.xml Sat Jan 27 17:37:36 2007 @@ -1,40 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.mysqli-more-results"> - <refnamediv> - <refname>mysqli_more_results</refname> - <refname>mysqli->more_results</refname> - <refpurpose>Check if there are any more query results from a multi query</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_more_results</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para> - <function>mysqli_more_results</function> indicates if one or more result sets - are available from a previous call to <function>mysqli_multi_query</function>. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para>&return.success;</para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_multi_query</function>, - <function>mysqli_next_result</function>, - <function>mysqli_store_result</function>&listendand; - <function>mysqli_use_result</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <para>See <function>mysqli_multi_query</function>.</para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id="function.mysqli-more-results"> + <refnamediv> + <refname>mysqli_more_results</refname> + <refname>mysqli->more_results</refname> + <refpurpose>Check if there are any more query results from a multi query</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_more_results</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para> + <function>mysqli_more_results</function> indicates if one or more result sets + are available from a previous call to <function>mysqli_multi_query</function>. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para>&return.success;</para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_multi_query</function>, + <function>mysqli_next_result</function>, + <function>mysqli_store_result</function>&listendand; + <function>mysqli_use_result</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <para>See <function>mysqli_multi_query</function>.</para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-multi-query.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-multi-query.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-multi-query.xml:1.5 phpdoc/en/reference/mysqli/functions/mysqli-multi-query.xml:1.6 --- phpdoc/en/reference/mysqli/functions/mysqli-multi-query.xml:1.5 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-multi-query.xml Sat Jan 27 17:37:36 2007 @@ -1,60 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> - <refentry id="function.mysqli-multi-query"> - <refnamediv> - <refname>mysqli_multi_query</refname> - <refname>mysqli->multi_query</refname> - <refpurpose>Performs a query on the database</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_multi_query</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>multi_query</methodname> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - The <function>mysqli_multi_query</function> executes one or multiple queries - which are concatenated by a semicolon. - </para> - <para> - To retrieve the resultset from the first query you can use - <function>mysqli_use_result</function> or <function>mysqli_store_result</function>. - All subsequent query results can be processed using - <function>mysqli_more_results</function> and <function>mysqli_next_result</function>. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - <function>mysqli_multi_query</function> only returns &false; if the first statement failed. - To retrieve subsequent errors from other statements you have to call - <function>mysqli_next_result</function> first. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_use_result</function>, - <function>mysqli_store_result</function>, - <function>mysqli_next_result</function>&listendand; - <function>mysqli_more_results</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.mysqli-multi-query"> + <refnamediv> + <refname>mysqli_multi_query</refname> + <refname>mysqli->multi_query</refname> + <refpurpose>Performs a query on the database</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_multi_query</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>multi_query</methodname> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + The <function>mysqli_multi_query</function> executes one or multiple queries + which are concatenated by a semicolon. + </para> + <para> + To retrieve the resultset from the first query you can use + <function>mysqli_use_result</function> or <function>mysqli_store_result</function>. + All subsequent query results can be processed using + <function>mysqli_more_results</function> and <function>mysqli_next_result</function>. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + <function>mysqli_multi_query</function> only returns &false; if the first statement failed. + To retrieve subsequent errors from other statements you have to call + <function>mysqli_next_result</function> first. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_use_result</function>, + <function>mysqli_store_result</function>, + <function>mysqli_next_result</function>&listendand; + <function>mysqli_more_results</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -89,11 +89,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -128,10 +128,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ my_user@localhost ----------------- @@ -141,9 +141,9 @@ Leiden Haarlemmermeer ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-next-result.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-next-result.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-next-result.xml:1.6 phpdoc/en/reference/mysqli/functions/mysqli-next-result.xml:1.7 --- phpdoc/en/reference/mysqli/functions/mysqli-next-result.xml:1.6 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-next-result.xml Sat Jan 27 17:37:36 2007 @@ -1,44 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.mysqli-next-result"> - <refnamediv> - <refname>mysqli_next_result</refname> - <refname>mysqli->next_result</refname> - <refpurpose>Prepare next result from multi_query</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_next_result</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para> - <function>mysqli_next_result</function> prepares next result set from a previous - call to <function>mysqli_multi_query</function> which can be retrieved by - <function>mysqli_store_result</function> or - <function>mysqli_use_result</function>. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para>&return.success;</para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_multi_query</function>, - <function>mysqli_more_results</function>, - <function>mysqli_store_result</function>&listendand; - <function>mysqli_use_result</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <para> - See <function>mysqli_multi_query</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id="function.mysqli-next-result"> + <refnamediv> + <refname>mysqli_next_result</refname> + <refname>mysqli->next_result</refname> + <refpurpose>Prepare next result from multi_query</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_next_result</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para> + <function>mysqli_next_result</function> prepares next result set from a previous + call to <function>mysqli_multi_query</function> which can be retrieved by + <function>mysqli_store_result</function> or + <function>mysqli_use_result</function>. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para>&return.success;</para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_multi_query</function>, + <function>mysqli_more_results</function>, + <function>mysqli_store_result</function>&listendand; + <function>mysqli_use_result</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <para> + See <function>mysqli_multi_query</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-num-fields.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-num-fields.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-num-fields.xml:1.6 phpdoc/en/reference/mysqli/functions/mysqli-num-fields.xml:1.7 --- phpdoc/en/reference/mysqli/functions/mysqli-num-fields.xml:1.6 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-num-fields.xml Sat Jan 27 17:37:36 2007 @@ -1,44 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.mysqli-num-fields"> - <refnamediv> - <refname>mysqli_num_fields</refname> - <refname>result->field_count</refname> - <refpurpose> - Get the number of fields in a result - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_num_fields</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <fieldsynopsis><type>int</type><varname>field_count</varname></fieldsynopsis> - </classsynopsis> - <para> - <function>mysqli_num_fields</function> returns the number of fields from specified result set. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para>The number of fields from a result set</para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_fetch_field</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<refentry id="function.mysqli-num-fields"> + <refnamediv> + <refname>mysqli_num_fields</refname> + <refname>result->field_count</refname> + <refpurpose>Get the number of fields in a result</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_num_fields</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <fieldsynopsis><type>int</type><varname>field_count</varname></fieldsynopsis> + </classsynopsis> + <para> + <function>mysqli_num_fields</function> returns the number of fields from specified result set. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para>The number of fields from a result set</para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_fetch_field</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -64,11 +62,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -94,16 +92,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Result set has 5 fields. ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-num-rows.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-num-rows.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-num-rows.xml:1.10 phpdoc/en/reference/mysqli/functions/mysqli-num-rows.xml:1.11 --- phpdoc/en/reference/mysqli/functions/mysqli-num-rows.xml:1.10 Sat Jan 21 05:04:43 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-num-rows.xml Sat Jan 27 17:37:36 2007 @@ -1,61 +1,59 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> - <refentry id="function.mysqli-num-rows"> - <refnamediv> - <refname>mysqli_num_rows</refname> - <refpurpose> - Gets the number of rows in a result - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_num_rows</methodname> - <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli_result</classname></ooclass> - <fieldsynopsis><type>int</type><varname>num_rows</varname></fieldsynopsis> - </classsynopsis> - <para> - Returns the number of rows in the result set. - </para> - <para> - The use of <function>mysqli_num_rows</function> depends on whether you use - buffered or unbuffered result sets. - In case you use unbuffered resultsets <function>mysqli_num_rows</function> - will not correct the correct number of rows until all the rows in the result - have been retrieved. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns number of rows in the result set. - </para> - <note> - <para> - If the number of rows is greater than maximal int value, the number - will be returned as a string. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_affected_rows</function>, - <function>mysqli_store_result</function>, - <function>mysqli_use_result</function>&listendand; - <function>mysqli_query</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<refentry id="function.mysqli-num-rows"> + <refnamediv> + <refname>mysqli_num_rows</refname> + <refpurpose>Gets the number of rows in a result</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_num_rows</methodname> + <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli_result</classname></ooclass> + <fieldsynopsis><type>int</type><varname>num_rows</varname></fieldsynopsis> + </classsynopsis> + <para> + Returns the number of rows in the result set. + </para> + <para> + The use of <function>mysqli_num_rows</function> depends on whether you use + buffered or unbuffered result sets. + In case you use unbuffered resultsets <function>mysqli_num_rows</function> + will not correct the correct number of rows until all the rows in the result + have been retrieved. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns number of rows in the result set. + </para> + <note> + <para> + If the number of rows is greater than maximal int value, the number + will be returned as a string. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_affected_rows</function>, + <function>mysqli_store_result</function>, + <function>mysqli_use_result</function>&listendand; + <function>mysqli_query</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -81,11 +79,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -111,16 +109,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Result set has 239 rows. ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-options.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-options.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-options.xml:1.10 phpdoc/en/reference/mysqli/functions/mysqli-options.xml:1.11 --- phpdoc/en/reference/mysqli/functions/mysqli-options.xml:1.10 Mon Nov 7 00:30:38 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-options.xml Sat Jan 27 17:37:36 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <refentry id="function.mysqli-options"> <refnamediv> <refname>mysqli_options</refname> @@ -8,40 +8,40 @@ </refnamediv> <refsect1> <title>Description</title> - <para>Procedural style:</para> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_options</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>int</type><parameter>option</parameter></methodparam> + <methodparam><type>mixed</type><parameter>value</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method)</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> <methodsynopsis> - <type>bool</type><methodname>mysqli_options</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <type>bool</type><methodname>options</methodname> <methodparam><type>int</type><parameter>option</parameter></methodparam> <methodparam><type>mixed</type><parameter>value</parameter></methodparam> </methodsynopsis> - <para>Object oriented style (method)</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>options</methodname> - <methodparam><type>int</type><parameter>option</parameter></methodparam> - <methodparam><type>mixed</type><parameter>value</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - <function>mysqli_options</function> can be used to set extra connect options - and affect behavior for a connection. - </para> - <para> - This function may be called multiple times to set several options. - </para> - <para> - <function>mysqli_options</function> should be called after <function>mysqli_init</function> - and before <function>mysqli_real_connect</function>. - </para> - <para> - The parameter <parameter>option</parameter> is the option that you want to set, - the <parameter>value</parameter> is the value for the option. - The parameter <parameter>option</parameter> can be one of the following values: - <table> - <title>Valid options</title> - <tgroup cols='2'> + </classsynopsis> + <para> + <function>mysqli_options</function> can be used to set extra connect options + and affect behavior for a connection. + </para> + <para> + This function may be called multiple times to set several options. + </para> + <para> + <function>mysqli_options</function> should be called after <function>mysqli_init</function> + and before <function>mysqli_real_connect</function>. + </para> + <para> + The parameter <parameter>option</parameter> is the option that you want to set, + the <parameter>value</parameter> is the value for the option. + The parameter <parameter>option</parameter> can be one of the following values: + <table> + <title>Valid options</title> + <tgroup cols='2'> <thead> <row> <entry>Name</entry> @@ -75,9 +75,9 @@ </entry> </row> </tbody> - </tgroup> - </table> - </para> + </tgroup> + </table> + </para> </refsect1> <refsect1> &reftitle.returnvalues; http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-param-count.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-param-count.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-param-count.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-param-count.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-param-count.xml:1.8 Sun Oct 31 16:05:12 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-param-count.xml Sat Jan 27 17:37:36 2007 @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-param-count"> - <refnamediv> - <refname>mysqli_param_count</refname> - <refpurpose>Alias for <function>mysqli_stmt_param_count</function></refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para> - This function is an alias of <function>mysqli_stmt_param_count</function>. - For a detailled descripton see description of - <function>mysqli_stmt_param_count</function>. - </para> - <note> - <para> - <function>mysqli_param_count</function> is deprecated and will be removed. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_param_count</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-param-count"> + <refnamediv> + <refname>mysqli_param_count</refname> + <refpurpose>Alias for <function>mysqli_stmt_param_count</function></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + This function is an alias of <function>mysqli_stmt_param_count</function>. + For a detailled descripton see description of + <function>mysqli_stmt_param_count</function>. + </para> + <note> + <para> + <function>mysqli_param_count</function> is deprecated and will be removed. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_param_count</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-ping.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-ping.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-ping.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-ping.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-ping.xml:1.8 Fri Nov 12 14:01:03 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-ping.xml Sat Jan 27 17:37:36 2007 @@ -1,48 +1,46 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-ping"> - <refnamediv> - <refname>mysqli_ping</refname> - <refname>mysqli->ping</refname> - <refpurpose> - Pings a server connection, or tries to reconnect if the connection has gone down - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_ping</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>ping</methodname> - <void/> - </methodsynopsis> - </classsynopsis> - <para> - Checks whether the connection to the server is working. If it has gone - down, and global option <literal>mysqli.reconnect</literal> is enabled - an automatic reconnection is attempted. - </para> - <para> - This function can be used by clients that remain idle for a long while, - to check whether the server has closed the connection and reconnect if - necessary. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para>&return.success;</para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-ping"> + <refnamediv> + <refname>mysqli_ping</refname> + <refname>mysqli->ping</refname> + <refpurpose>Pings a server connection, or tries to reconnect if the connection has gone down</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_ping</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>ping</methodname> + <void/> + </methodsynopsis> + </classsynopsis> + <para> + Checks whether the connection to the server is working. If it has gone + down, and global option <literal>mysqli.reconnect</literal> is enabled + an automatic reconnection is attempted. + </para> + <para> + This function can be used by clients that remain idle for a long while, + to check whether the server has closed the connection and reconnect if + necessary. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para>&return.success;</para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -64,11 +62,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -90,16 +88,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Our connection is ok! ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-prepare.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-prepare.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-prepare.xml:1.11 phpdoc/en/reference/mysqli/functions/mysqli-prepare.xml:1.12 --- phpdoc/en/reference/mysqli/functions/mysqli-prepare.xml:1.11 Fri Jun 24 13:46:14 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-prepare.xml Sat Jan 27 17:37:36 2007 @@ -1,91 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> - <refentry id="function.mysqli-prepare"> - <refnamediv> - <refname>mysqli_prepare</refname> - <refname>mysqli->prepare</refname> - <refpurpose> - Prepare a SQL statement for execution - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedure style:</para> - <methodsynopsis> - <type>mysqli_stmt</type><methodname>mysqli_prepare</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method)</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>mysqli_stmt</type><methodname>prepare</methodname> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - <function>mysqli_prepare</function> prepares the SQL query pointed to by the - null-terminated string query, and returns a statement handle to be used for - further operations on the statement. The query must consist of a single SQL statement. - </para> - <note> - <para> - You should not add a terminating semicolon or <literal>\g</literal> - to the statement. - </para> - </note> - <para> - The parameter <parameter>query</parameter> can include one or more parameter markers - in the SQL statement by embedding question mark (<literal>?</literal>) characters - at the appropriate positions. - </para> - <note> - <para> - The markers are legal only in certain places in SQL statements. - For example, they are allowed in the VALUES() list of an INSERT statement - (to specify column values for a row), or in a comparison with a column in - a WHERE clause to specify a comparison value. - </para> - <para> - However, they are not allowed for identifiers (such as table or column names), - in the select list that names the columns to be returned by a SELECT statement, - or to specify both operands of a binary operator such as the <literal>=</literal> - equal sign. The latter restriction is necessary because it would be impossible - to determine the parameter type. It's not allowed to compare marker - with <literal>NULL</literal> by <literal>? IS NULL</literal> too. - In general, parameters are legal only in Data - Manipulation Languange (DML) statements, and not in Data Defination Language - (DDL) statements. - </para> - </note> - <para> - The parameter markers must be bound to application variables using - <function>mysqli_stmt_bind_param</function> and/or <function>mysqli_stmt_bind_result</function> - before executing the statement or fetching rows. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - <function>mysqli_prepare</function> returns a statement object or &false; if an error occured. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_execute</function>, - <function>mysqli_stmt_fetch</function>, - <function>mysqli_stmt_bind_param</function>, - <function>mysqli_stmt_bind_result</function>&listendand; - <function>mysqli_stmt_close</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.12 $ --> +<refentry id="function.mysqli-prepare"> + <refnamediv> + <refname>mysqli_prepare</refname> + <refname>mysqli->prepare</refname> + <refpurpose>Prepare a SQL statement for execution</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedure style:</para> + <methodsynopsis> + <type>mysqli_stmt</type><methodname>mysqli_prepare</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method)</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>mysqli_stmt</type><methodname>prepare</methodname> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + <function>mysqli_prepare</function> prepares the SQL query pointed to by the + null-terminated string query, and returns a statement handle to be used for + further operations on the statement. The query must consist of a single SQL statement. + </para> + <note> + <para> + You should not add a terminating semicolon or <literal>\g</literal> + to the statement. + </para> + </note> + <para> + The parameter <parameter>query</parameter> can include one or more parameter markers + in the SQL statement by embedding question mark (<literal>?</literal>) characters + at the appropriate positions. + </para> + <note> + <para> + The markers are legal only in certain places in SQL statements. + For example, they are allowed in the VALUES() list of an INSERT statement + (to specify column values for a row), or in a comparison with a column in + a WHERE clause to specify a comparison value. + </para> + <para> + However, they are not allowed for identifiers (such as table or column names), + in the select list that names the columns to be returned by a SELECT statement, + or to specify both operands of a binary operator such as the <literal>=</literal> + equal sign. The latter restriction is necessary because it would be impossible + to determine the parameter type. It's not allowed to compare marker + with <literal>NULL</literal> by <literal>? IS NULL</literal> too. + In general, parameters are legal only in Data + Manipulation Languange (DML) statements, and not in Data Defination Language + (DDL) statements. + </para> + </note> + <para> + The parameter markers must be bound to application variables using + <function>mysqli_stmt_bind_param</function> and/or <function>mysqli_stmt_bind_result</function> + before executing the statement or fetching rows. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + <function>mysqli_prepare</function> returns a statement object or &false; if an error occured. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_execute</function>, + <function>mysqli_stmt_fetch</function>, + <function>mysqli_stmt_bind_param</function>, + <function>mysqli_stmt_bind_result</function>&listendand; + <function>mysqli_stmt_close</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -117,17 +115,17 @@ /* close statement */ $stmt->close(); -} +} /* close connection */ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -159,22 +157,22 @@ /* close statement */ mysqli_stmt_close($stmt); -} +} /* close connection */ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Amersfoort is in district Utrecht ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-query.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-query.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-query.xml:1.9 phpdoc/en/reference/mysqli/functions/mysqli-query.xml:1.10 --- phpdoc/en/reference/mysqli/functions/mysqli-query.xml:1.9 Mon Apr 4 17:47:28 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-query.xml Sat Jan 27 17:37:36 2007 @@ -1,73 +1,73 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> - <refentry id="function.mysqli-query"> - <refnamediv> - <refname>mysqli_query</refname> - <refname>mysqli->query</refname> - <refpurpose>Performs a query on the database</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>mixed</type><methodname>mysqli_query</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - <methodparam choice='opt'><type>int</type><parameter>resultmode</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>mixed</type><methodname>query</methodname> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - <methodparam choice='opt'><type>int</type><parameter>resultmode</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - The <function>mysqli_query</function> function is used to simplify the - act of performing a query against the database represented by the - <parameter>link</parameter> parameter. - </para> - <para> - Functionally, using this - function is identical to calling <function>mysqli_real_query</function> - followed either by <function>mysqli_use_result</function> or - <function>mysqli_store_result</function> where <parameter>query</parameter> - is the query string itself and <parameter>resultmode</parameter> is - either the constant <literal>MYSQLI_USE_RESULT</literal> or - <literal>MYSQLI_STORE_RESULT</literal> depending - on the desired behavior. By default, if the - <parameter>resultmode</parameter> is not provided - <literal>MYSQLI_STORE_RESULT</literal> is used. - </para> - <para> - If you execute <function>mysqli_query</function> with <parameter>resultmode</parameter> - <literal>MYSQLI_USE_RESULT</literal> all subsequent calls will return error - <literal>Commands out of sync</literal> unless you call <function>mysqli_free_result</function>. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; For <literal>SELECT, SHOW, DESCRIBE</literal> or - <literal>EXPLAIN</literal> <function>mysqli_query</function> will return - a result object. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_real_query</function>, - <function>mysqli_multi_query</function>&listendand; - <function>mysqli_free_result</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id="function.mysqli-query"> + <refnamediv> + <refname>mysqli_query</refname> + <refname>mysqli->query</refname> + <refpurpose>Performs a query on the database</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>mixed</type><methodname>mysqli_query</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>resultmode</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>mixed</type><methodname>query</methodname> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>resultmode</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + The <function>mysqli_query</function> function is used to simplify the + act of performing a query against the database represented by the + <parameter>link</parameter> parameter. + </para> + <para> + Functionally, using this + function is identical to calling <function>mysqli_real_query</function> + followed either by <function>mysqli_use_result</function> or + <function>mysqli_store_result</function> where <parameter>query</parameter> + is the query string itself and <parameter>resultmode</parameter> is + either the constant <literal>MYSQLI_USE_RESULT</literal> or + <literal>MYSQLI_STORE_RESULT</literal> depending + on the desired behavior. By default, if the + <parameter>resultmode</parameter> is not provided + <literal>MYSQLI_STORE_RESULT</literal> is used. + </para> + <para> + If you execute <function>mysqli_query</function> with <parameter>resultmode</parameter> + <literal>MYSQLI_USE_RESULT</literal> all subsequent calls will return error + <literal>Commands out of sync</literal> unless you call <function>mysqli_free_result</function>. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; For <literal>SELECT, SHOW, DESCRIBE</literal> or + <literal>EXPLAIN</literal> <function>mysqli_query</function> will return + a result object. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_real_query</function>, + <function>mysqli_multi_query</function>&listendand; + <function>mysqli_free_result</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -95,7 +95,7 @@ if ($result = $mysqli->query("SELECT * FROM City", MYSQLI_USE_RESULT)) { /* Note, that we can't execute any functions which interact with the - server until result set was closed. All calls will return an + server until result set was closed. All calls will return an 'out of sync' error */ if (!$mysqli->query("SET @a:='this will not work'")) { printf("Error: %s\n", $mysqli->error); @@ -106,11 +106,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -138,7 +138,7 @@ if ($result = mysqli_query($link, "SELECT * FROM City", MYSQLI_USE_RESULT)) { /* Note, that we can't execute any functions which interact with the - server until result set was closed. All calls will return an + server until result set was closed. All calls will return an 'out of sync' error */ if (!mysqli_query($link, "SET @a:='this will not work'")) { printf("Error: %s\n", mysqli_error($link)); @@ -149,18 +149,18 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Table myCity successfully created. Select returned 10 rows. Error: Commands out of sync; You can't run this command now ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-real-connect.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-real-connect.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-real-connect.xml:1.10 phpdoc/en/reference/mysqli/functions/mysqli-real-connect.xml:1.11 --- phpdoc/en/reference/mysqli/functions/mysqli-real-connect.xml:1.10 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-real-connect.xml Sat Jan 27 17:37:36 2007 @@ -1,128 +1,128 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> - <refentry id="function.mysqli-real-connect"> - <refnamediv> - <refname>mysqli_real_connect</refname> - <refname>mysqli->real_connect</refname> - <refpurpose>Opens a connection to a mysql server</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_real_connect</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>hostname</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>username</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>passwd</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>dbname</parameter></methodparam> - <methodparam choice='opt'><type>int</type><parameter>port</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>socket</parameter></methodparam> - <methodparam choice='opt'><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method)</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>real_connect</methodname> - <methodparam choice='opt'><type>string</type><parameter>hostname</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>username</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>passwd</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>dbname</parameter></methodparam> - <methodparam choice='opt'><type>int</type><parameter>port</parameter></methodparam> - <methodparam choice='opt'><type>string</type><parameter>socket</parameter></methodparam> - <methodparam choice='opt'><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> - </classsynopsis> +<!-- $Revision: 1.11 $ --> +<refentry id="function.mysqli-real-connect"> + <refnamediv> + <refname>mysqli_real_connect</refname> + <refname>mysqli->real_connect</refname> + <refpurpose>Opens a connection to a mysql server</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_real_connect</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>hostname</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>username</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>passwd</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>dbname</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>port</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>socket</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>flags</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method)</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>real_connect</methodname> + <methodparam choice='opt'><type>string</type><parameter>hostname</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>username</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>passwd</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>dbname</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>port</parameter></methodparam> + <methodparam choice='opt'><type>string</type><parameter>socket</parameter></methodparam> + <methodparam choice='opt'><type>int</type><parameter>flags</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + <function>mysqli_real_connect</function> attempts to establish a + connection to a MySQL database engine running on + <parameter>hostname</parameter>. + </para> + <para> + This function differs from <function>mysqli_connect</function>: + </para> + <itemizedlist> + <listitem> <para> - <function>mysqli_real_connect</function> attempts to establish a - connection to a MySQL database engine running on - <parameter>hostname</parameter>. - </para> + <function>mysqli_real_connect</function> needs a valid object which has + to be created by function <function>mysqli_init</function> + </para> + </listitem> + <listitem> <para> - This function differs from <function>mysqli_connect</function>: + With function <function>mysqli_options</function> you can set various options for connection. </para> - <itemizedlist> - <listitem> - <para> - <function>mysqli_real_connect</function> needs a valid object which has - to be created by function <function>mysqli_init</function> - </para> - </listitem> - <listitem> - <para> - With function <function>mysqli_options</function> you can set various options for connection. - </para> - </listitem> - <listitem> - <para> - With the parameter <parameter>flags</parameter> you can set different connection options: - </para> - <table> - <title>Supported flags</title> - <tgroup cols='2'> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>MYSQLI_CLIENT_COMPRESS</literal></entry> - <entry>Use compression protocol</entry> - </row> - <row> - <entry><literal>MYSQLI_CLIENT_FOUND_ROWS</literal></entry> - <entry>return number of matched rows, not the number of affected rows</entry> - </row> - <row> - <entry><literal>MYSQLI_CLIENT_IGNORE_SPACE</literal></entry> - <entry>Allow spaces after function names. Makes all function names reserved words.</entry> - </row> - <row> - <entry><literal>MYSQLI_CLIENT_INTERACTIVE</literal></entry> - <entry> - Allow <literal>interactive_timeout</literal> seconds (instead of - <literal>wait_timeout</literal> seconds) of inactivity before closing the connection - </entry> - </row> - <row> - <entry><literal>MYSQLI_CLIENT_SSL</literal></entry> - <entry>Use SSL (encryption)</entry> - </row> - </tbody> - </tgroup> - </table> - <note> - <para> - For security reasons the <literal>MULTI_STATEMENT</literal> flag is not supported in - PHP. If you want to execute multiple queries use the - <function>mysqli_multi_query</function> function. - </para> - </note> - </listitem> - </itemizedlist> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para>&return.success;</para> - </refsect1> - <refsect1> - &reftitle.seealso; + </listitem> + <listitem> <para> - <function>mysqli_connect</function>, - <function>mysqli_init</function>, - <function>mysqli_options</function>, - <function>mysqli_ssl_set</function>&listendand; - <function>mysqli_close</function>. + With the parameter <parameter>flags</parameter> you can set different connection options: </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> + <table> + <title>Supported flags</title> + <tgroup cols='2'> + <thead> + <row> + <entry>Name</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>MYSQLI_CLIENT_COMPRESS</literal></entry> + <entry>Use compression protocol</entry> + </row> + <row> + <entry><literal>MYSQLI_CLIENT_FOUND_ROWS</literal></entry> + <entry>return number of matched rows, not the number of affected rows</entry> + </row> + <row> + <entry><literal>MYSQLI_CLIENT_IGNORE_SPACE</literal></entry> + <entry>Allow spaces after function names. Makes all function names reserved words.</entry> + </row> + <row> + <entry><literal>MYSQLI_CLIENT_INTERACTIVE</literal></entry> + <entry> + Allow <literal>interactive_timeout</literal> seconds (instead of + <literal>wait_timeout</literal> seconds) of inactivity before closing the connection + </entry> + </row> + <row> + <entry><literal>MYSQLI_CLIENT_SSL</literal></entry> + <entry>Use SSL (encryption)</entry> + </row> + </tbody> + </tgroup> + </table> + <note> + <para> + For security reasons the <literal>MULTI_STATEMENT</literal> flag is not supported in + PHP. If you want to execute multiple queries use the + <function>mysqli_multi_query</function> function. + </para> + </note> + </listitem> + </itemizedlist> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para>&return.success;</para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_connect</function>, + <function>mysqli_init</function>, + <function>mysqli_options</function>, + <function>mysqli_ssl_set</function>&listendand; + <function>mysqli_close</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php @@ -147,11 +147,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php @@ -176,17 +176,17 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Connection: Localhost via UNIX socket ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-real-escape-string.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-real-escape-string.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-real-escape-string.xml:1.12 phpdoc/en/reference/mysqli/functions/mysqli-real-escape-string.xml:1.13 --- phpdoc/en/reference/mysqli/functions/mysqli-real-escape-string.xml:1.12 Fri Jan 27 10:41:40 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-real-escape-string.xml Sat Jan 27 17:37:36 2007 @@ -1,42 +1,39 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> +<!-- $Revision: 1.13 $ --> <refentry id="function.mysqli-real-escape-string"> <refnamediv> <refname>mysqli_real_escape_string</refname> <refname>mysqli->real_escape_string</refname> - <refpurpose> - Escapes special characters in a string for use in a SQL statement, - taking into account the current charset of the connection - </refpurpose> + <refpurpose>Escapes special characters in a string for use in a SQL statement, taking into account the current charset of the connection</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <para>Procedural style:</para> + <para>Procedural style:</para> + <methodsynopsis> + <type>string</type><methodname>mysqli_real_escape_string</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>escapestr</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (both methods are equivalent):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> <methodsynopsis> - <type>string</type><methodname>mysqli_real_escape_string</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <type>string</type><methodname>escape_string</methodname> <methodparam><type>string</type><parameter>escapestr</parameter></methodparam> </methodsynopsis> - <para>Object oriented style (both methods are equivalent):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> <methodsynopsis> - <type>string</type><methodname>escape_string</methodname> - <methodparam><type>string</type><parameter>escapestr</parameter></methodparam> - </methodsynopsis> - <methodsynopsis> - <type>string</type><methodname>real_escape_string</methodname> - <methodparam><type>string</type><parameter>escapestr</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - This function is used to create a legal SQL string that you can use in a SQL statement. - The string <literal>escapestr</literal> is encoded to an escaped SQL string, taking into - account the current character set of the connection. - </para> - <para> - Characters encoded are <literal>NUL (ASCII 0), \n, \r, \, ', ", and Control-Z</literal>. - </para> + <type>string</type><methodname>real_escape_string</methodname> + <methodparam><type>string</type><parameter>escapestr</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + This function is used to create a legal SQL string that you can use in a SQL statement. + The string <literal>escapestr</literal> is encoded to an escaped SQL string, taking into + account the current character set of the connection. + </para> + <para> + Characters encoded are <literal>NUL (ASCII 0), \n, \r, \, ', ", and Control-Z</literal>. + </para> </refsect1> <refsect1> &reftitle.returnvalues; @@ -79,7 +76,7 @@ /* this query with escaped $city will work */ if ($mysqli->query("INSERT into myCity (Name) VALUES ('$city')")) { printf("%d Row inserted.\n", $mysqli->affected_rows); -} +} $mysqli->close(); ?> @@ -113,7 +110,7 @@ /* this query with escaped $city will work */ if (mysqli_query($link, "INSERT into myCity (Name) VALUES ('$city')")) { printf("%d Row inserted.\n", mysqli_affected_rows($link)); -} +} mysqli_close($link); ?> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-real-query.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-real-query.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-real-query.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-real-query.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-real-query.xml:1.7 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-real-query.xml Sat Jan 27 17:37:36 2007 @@ -1,56 +1,56 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-real-query"> - <refnamediv> - <refname>mysqli_real_query</refname> - <refname>mysqli->real_query</refname> - <refpurpose>Execute an SQL query</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_real_query</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>real_query</methodname> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - The <function>mysqli_real_query</function> function is used to execute - only a query against the database represented by the <parameter>link</parameter> - whose result can then be retrieved or stored using the - <function>mysqli_store_result</function> or <function>mysqli_use_result</function> - functions. - </para> - <note> - <para> - In order to determine if a given query should return a result set or not, - see <function>mysqli_field_count</function>. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_query</function>, - <function>mysqli_store_result</function>&listendand; - <function>mysqli_use_result</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-real-query"> + <refnamediv> + <refname>mysqli_real_query</refname> + <refname>mysqli->real_query</refname> + <refpurpose>Execute an SQL query</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_real_query</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>real_query</methodname> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + The <function>mysqli_real_query</function> function is used to execute + only a query against the database represented by the <parameter>link</parameter> + whose result can then be retrieved or stored using the + <function>mysqli_store_result</function> or <function>mysqli_use_result</function> + functions. + </para> + <note> + <para> + In order to determine if a given query should return a result set or not, + see <function>mysqli_field_count</function>. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_query</function>, + <function>mysqli_store_result</function>&listendand; + <function>mysqli_use_result</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-report.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-report.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-report.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-report.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-report.xml:1.7 Thu Mar 30 11:25:34 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-report.xml Sat Jan 27 17:37:36 2007 @@ -1,73 +1,73 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-report"> - <refnamediv> - <refname>mysqli_report</refname> - <refpurpose>Enables or disables internal report functions</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_report</methodname> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> - <para> - <function>mysqli_report</function> is a powerful function to improve your queries - and code during development and testing phase. Depending on the flags it reports - errors from mysqli function calls or queries which don't use an index (or use a bad - index). - </para> - <table> - <title>Supported flags</title> - <tgroup cols='2'> - <thead> - <row> - <entry>Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>MYSQLI_REPORT_OFF</literal></entry> - <entry>Turns reporting off</entry> - </row> - <row> - <entry><literal>MYSQLI_REPORT_ERROR</literal></entry> - <entry>Report errors from mysqli function calls</entry> - </row> - <row> - <entry><literal>MYSQLI_REPORT_STRICT</literal></entry> - <entry>Report warnings from mysqli function calls</entry> - </row> - <row> - <entry><literal>MYSQLI_REPORT_INDEX</literal></entry> - <entry>Report if no index or bad index was used in a query</entry> - </row> - <row> - <entry><literal>MYSQLI_REPORT_ALL</literal></entry> - <entry>Set all options (report all)</entry> - </row> - </tbody> - </tgroup> - </table> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para>&return.success;</para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_debug</function>&listendand; - <function>mysqli_dump_debug_info</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <para> - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-report"> + <refnamediv> + <refname>mysqli_report</refname> + <refpurpose>Enables or disables internal report functions</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_report</methodname> + <methodparam><type>int</type><parameter>flags</parameter></methodparam> + </methodsynopsis> + <para> + <function>mysqli_report</function> is a powerful function to improve your queries + and code during development and testing phase. Depending on the flags it reports + errors from mysqli function calls or queries which don't use an index (or use a bad + index). + </para> + <table> + <title>Supported flags</title> + <tgroup cols='2'> + <thead> + <row> + <entry>Name</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>MYSQLI_REPORT_OFF</literal></entry> + <entry>Turns reporting off</entry> + </row> + <row> + <entry><literal>MYSQLI_REPORT_ERROR</literal></entry> + <entry>Report errors from mysqli function calls</entry> + </row> + <row> + <entry><literal>MYSQLI_REPORT_STRICT</literal></entry> + <entry>Report warnings from mysqli function calls</entry> + </row> + <row> + <entry><literal>MYSQLI_REPORT_INDEX</literal></entry> + <entry>Report if no index or bad index was used in a query</entry> + </row> + <row> + <entry><literal>MYSQLI_REPORT_ALL</literal></entry> + <entry>Set all options (report all)</entry> + </row> + </tbody> + </tgroup> + </table> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para>&return.success;</para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_debug</function>&listendand; + <function>mysqli_dump_debug_info</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <para> + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php /* activate reporting */ @@ -91,11 +91,11 @@ $mysqli->close(); ?> ]]> - </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/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-rollback.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-rollback.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-rollback.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-rollback.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-rollback.xml:1.8 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-rollback.xml Sat Jan 27 17:37:36 2007 @@ -1,47 +1,47 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-rollback"> - <refnamediv> - <refname>mysqli_rollback</refname> - <refname>mysqli->rollback</refname> - <refpurpose>Rolls back current transaction</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_rollback</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>rollback</methodname> - <void/> - </methodsynopsis> - </classsynopsis> - <para> - Rollbacks the current transaction for the database specified by the - <parameter>link</parameter> parameter. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_commit</function>&listendand; - <function>mysqli_autocommit</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-rollback"> + <refnamediv> + <refname>mysqli_rollback</refname> + <refname>mysqli->rollback</refname> + <refpurpose>Rolls back current transaction</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_rollback</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>rollback</methodname> + <void/> + </methodsynopsis> + </classsynopsis> + <para> + Rollbacks the current transaction for the database specified by the + <parameter>link</parameter> parameter. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_commit</function>&listendand; + <function>mysqli_autocommit</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -88,11 +88,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -139,17 +139,17 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ 0 rows in table myCity. 50 rows in table myCity (after rollback). ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-rpl-parse-enabled.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-rpl-parse-enabled.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-rpl-parse-enabled.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-rpl-parse-enabled.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-rpl-parse-enabled.xml:1.8 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-rpl-parse-enabled.xml Sat Jan 27 17:37:36 2007 @@ -1,21 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-rpl-parse-enabled"> - <refnamediv> - <refname>mysqli_rpl_parse_enabled</refname> - <refpurpose>Check if RPL parse is enabled</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>mysqli_rpl_parse_enabled</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-rpl-parse-enabled"> + <refnamediv> + <refname>mysqli_rpl_parse_enabled</refname> + <refpurpose>Check if RPL parse is enabled</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>mysqli_rpl_parse_enabled</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-rpl-probe.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-rpl-probe.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-rpl-probe.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-rpl-probe.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-rpl-probe.xml:1.8 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-rpl-probe.xml Sat Jan 27 17:37:36 2007 @@ -1,21 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-rpl-probe"> - <refnamediv> - <refname>mysqli_rpl_probe</refname> - <refpurpose>RPL probe</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_rpl_probe</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-rpl-probe"> + <refnamediv> + <refname>mysqli_rpl_probe</refname> + <refpurpose>RPL probe</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_rpl_probe</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-rpl-query-type.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-rpl-query-type.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-rpl-query-type.xml:1.9 phpdoc/en/reference/mysqli/functions/mysqli-rpl-query-type.xml:1.10 --- phpdoc/en/reference/mysqli/functions/mysqli-rpl-query-type.xml:1.9 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-rpl-query-type.xml Sat Jan 27 17:37:36 2007 @@ -1,42 +1,42 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> - <refentry id="function.mysqli-rpl-query-type"> - <refnamediv> - <refname>mysqli_rpl_query_type</refname> - <refname>mysqli->rpl_query_type</refname> - <refpurpose>Returns RPL query type</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_rpl_query_type</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method)</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>int</type><methodname>rpl_query_type</methodname> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - </classsynopsis> +<!-- $Revision: 1.10 $ --> +<refentry id="function.mysqli-rpl-query-type"> + <refnamediv> + <refname>mysqli_rpl_query_type</refname> + <refname>mysqli->rpl_query_type</refname> + <refpurpose>Returns RPL query type</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_rpl_query_type</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method)</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>int</type><methodname>rpl_query_type</methodname> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + </classsynopsis> - <para> - Returns <constant>MYSQLI_RPL_MASTER</constant>, - <constant>MYSQLI_RPL_SLAVE</constant> or - <constant>MYSQLI_RPL_ADMIN</constant> depending on a query type. - <literal>INSERT</literal>, <literal>UPDATE</literal> and similar are - <emphasis>master</emphasis> queries, <literal>SELECT</literal> is - <emphasis>slave</emphasis>, and <literal>FLUSH</literal>, - <literal>REPAIR</literal> and similar are <emphasis>admin</emphasis>. - </para> + <para> + Returns <constant>MYSQLI_RPL_MASTER</constant>, + <constant>MYSQLI_RPL_SLAVE</constant> or + <constant>MYSQLI_RPL_ADMIN</constant> depending on a query type. + <literal>INSERT</literal>, <literal>UPDATE</literal> and similar are + <emphasis>master</emphasis> queries, <literal>SELECT</literal> is + <emphasis>slave</emphasis>, and <literal>FLUSH</literal>, + <literal>REPAIR</literal> and similar are <emphasis>admin</emphasis>. + </para> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-select-db.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-select-db.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-select-db.xml:1.9 phpdoc/en/reference/mysqli/functions/mysqli-select-db.xml:1.10 --- phpdoc/en/reference/mysqli/functions/mysqli-select-db.xml:1.9 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-select-db.xml Sat Jan 27 17:37:36 2007 @@ -1,49 +1,49 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> - <refentry id="function.mysqli-select-db"> - <refnamediv> - <refname>mysqli_select_db</refname> - <refname>mysqli->select_db</refname> - <refpurpose>Selects the default database for database queries</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_select_db</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>string</type><parameter>dbname</parameter></methodparam> - </methodsynopsis> - <para> - The <function>mysqli_select_db</function> function selects the default - database (specified by the <parameter>dbname</parameter> parameter) to be - used when performing queries against the database connection - represented by the <parameter>link</parameter> parameter. - </para> - <note> - <para> - This function should only be used to change the default database for the connection. - You can select the default database with 4th parameter in <function>mysqli_connect</function>. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_connect</function>&listendand; - <function>mysqli_real_connect</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id="function.mysqli-select-db"> + <refnamediv> + <refname>mysqli_select_db</refname> + <refname>mysqli->select_db</refname> + <refpurpose>Selects the default database for database queries</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_select_db</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>dbname</parameter></methodparam> + </methodsynopsis> + <para> + The <function>mysqli_select_db</function> function selects the default + database (specified by the <parameter>dbname</parameter> parameter) to be + used when performing queries against the database connection + represented by the <parameter>link</parameter> parameter. + </para> + <note> + <para> + This function should only be used to change the default database for the connection. + You can select the default database with 4th parameter in <function>mysqli_connect</function>. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_connect</function>&listendand; + <function>mysqli_real_connect</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "test"); @@ -74,11 +74,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "test"); @@ -109,17 +109,17 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Default database is test. Default database is world. ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-send-long-data.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-send-long-data.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-send-long-data.xml:1.6 phpdoc/en/reference/mysqli/functions/mysqli-send-long-data.xml:1.7 --- phpdoc/en/reference/mysqli/functions/mysqli-send-long-data.xml:1.6 Sun Oct 31 16:05:12 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-send-long-data.xml Sat Jan 27 17:37:36 2007 @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.mysqli-send-long-data"> - <refnamediv> - <refname>mysqli_send_long_data</refname> - <refpurpose>Alias for <function>mysqli_stmt_send_long_data</function></refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para> - This function is an alias of <function>mysqli_stmt_send_long_data</function>. - For a detailled descripton see description of - <function>mysqli_stmt_send_long_data</function>. - </para> - <note> - <para> - <function>mysqli_send_long_data</function> is deprecated and will be removed. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_send_long_data</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.7 $ --> +<refentry id="function.mysqli-send-long-data"> + <refnamediv> + <refname>mysqli_send_long_data</refname> + <refpurpose>Alias for <function>mysqli_stmt_send_long_data</function></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + This function is an alias of <function>mysqli_stmt_send_long_data</function>. + For a detailled descripton see description of + <function>mysqli_stmt_send_long_data</function>. + </para> + <note> + <para> + <function>mysqli_send_long_data</function> is deprecated and will be removed. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_send_long_data</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-send-query.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-send-query.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-send-query.xml:1.6 phpdoc/en/reference/mysqli/functions/mysqli-send-query.xml:1.7 --- phpdoc/en/reference/mysqli/functions/mysqli-send-query.xml:1.6 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-send-query.xml Sat Jan 27 17:37:36 2007 @@ -1,32 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.mysqli-send-query"> - <refnamediv> - <refname>mysqli_send_query</refname> - <refname>mysqli->send_query</refname> - <refpurpose>Send the query and return</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_send_query</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method)</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>send_query</methodname> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - </classsynopsis> +<!-- $Revision: 1.7 $ --> +<refentry id="function.mysqli-send-query"> + <refnamediv> + <refname>mysqli_send_query</refname> + <refname>mysqli->send_query</refname> + <refpurpose>Send the query and return</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_send_query</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method)</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>send_query</methodname> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + </classsynopsis> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-server-end.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-server-end.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-server-end.xml:1.4 phpdoc/en/reference/mysqli/functions/mysqli-server-end.xml:1.5 --- phpdoc/en/reference/mysqli/functions/mysqli-server-end.xml:1.4 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-server-end.xml Sat Jan 27 17:37:36 2007 @@ -1,21 +1,21 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.mysqli-server-end"> - <refnamediv> - <refname>mysqli_server_end</refname> - <refpurpose>Shut down the embedded server</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>mysqli_server_end</methodname> - <void/> - </methodsynopsis> +<!-- $Revision: 1.5 $ --> +<refentry id="function.mysqli-server-end"> + <refnamediv> + <refname>mysqli_server_end</refname> + <refpurpose>Shut down the embedded server</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>void</type><methodname>mysqli_server_end</methodname> + <void/> + </methodsynopsis> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-server-init.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-server-init.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-server-init.xml:1.5 phpdoc/en/reference/mysqli/functions/mysqli-server-init.xml:1.6 --- phpdoc/en/reference/mysqli/functions/mysqli-server-init.xml:1.5 Tue Jul 19 14:28:39 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-server-init.xml Sat Jan 27 17:37:36 2007 @@ -1,22 +1,22 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> - <refentry id="function.mysqli-server-init"> - <refnamediv> - <refname>mysqli_server_init</refname> - <refpurpose>Initialize embedded server</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_server_init</methodname> - <methodparam choice="opt"><type>array</type><parameter>server</parameter></methodparam> - <methodparam choice="opt"><type>array</type><parameter>groups</parameter></methodparam> - </methodsynopsis> +<!-- $Revision: 1.6 $ --> +<refentry id="function.mysqli-server-init"> + <refnamediv> + <refname>mysqli_server_init</refname> + <refpurpose>Initialize embedded server</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_server_init</methodname> + <methodparam choice="opt"><type>array</type><parameter>server</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>groups</parameter></methodparam> + </methodsynopsis> - &warn.undocumented.func; + &warn.undocumented.func; - </refsect1> - </refentry> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-set-charset.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-set-charset.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-set-charset.xml:1.4 phpdoc/en/reference/mysqli/functions/mysqli-set-charset.xml:1.5 --- phpdoc/en/reference/mysqli/functions/mysqli-set-charset.xml:1.4 Mon Apr 3 15:44:29 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-set-charset.xml Sat Jan 27 17:37:36 2007 @@ -1,50 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.mysqli-set-charset"> - <refnamediv> - <refname>mysqli_set_charset</refname> - <refname>mysqli->set_charset</refname> - <refpurpose>Sets the default client character set</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>mysqli_set_charset</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>string</type><parameter>charset</parameter></methodparam> - </methodsynopsis> - <para> - The <function>mysqli_set_charset</function> function sets the default - character set (specified by the <parameter>charset</parameter> parameter) to be - used when sending data from and to the database server - represented by the <parameter>link</parameter> parameter. - </para> - <note> - <para> - To use this function on a Windows platform you need MySQL client library version 4.1.11 - or above (for MySQL 5.0 you need 5.0.6 or above). It can be downloaded at - <ulink url="&url.mysql.download.lib;">&url.mysql.download.lib;</ulink>. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_character_set_name</function>&listendand; - <function>mysqli_real_escape_string</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<refentry id="function.mysqli-set-charset"> + <refnamediv> + <refname>mysqli_set_charset</refname> + <refname>mysqli->set_charset</refname> + <refpurpose>Sets the default client character set</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>mysqli_set_charset</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>charset</parameter></methodparam> + </methodsynopsis> + <para> + The <function>mysqli_set_charset</function> function sets the default + character set (specified by the <parameter>charset</parameter> parameter) to be + used when sending data from and to the database server + represented by the <parameter>link</parameter> parameter. + </para> + <note> + <para> + To use this function on a Windows platform you need MySQL client library version 4.1.11 + or above (for MySQL 5.0 you need 5.0.6 or above). It can be downloaded at + <ulink url="&url.mysql.download.lib;">&url.mysql.download.lib;</ulink>. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_character_set_name</function>&listendand; + <function>mysqli_real_escape_string</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "test"); @@ -65,11 +65,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect('localhost', 'my_user', 'my_password', 'test'); @@ -90,16 +90,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Current character set: utf8 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-set-opt.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-set-opt.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-set-opt.xml:1.1 phpdoc/en/reference/mysqli/functions/mysqli-set-opt.xml:1.2 --- phpdoc/en/reference/mysqli/functions/mysqli-set-opt.xml:1.1 Sun Feb 8 13:14:42 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-set-opt.xml Sat Jan 27 17:37:36 2007 @@ -1,17 +1,17 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> - <refentry id="function.mysqli-set-opt"> - <refnamediv> - <refname>mysqli_set_opt</refname> - <refpurpose>Alias of <function>mysqli_options</function></refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para> - This function is an alias of <function>mysqli_options</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.2 $ --> +<refentry id="function.mysqli-set-opt"> + <refnamediv> + <refname>mysqli_set_opt</refname> + <refpurpose>Alias of <function>mysqli_options</function></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para> + This function is an alias of <function>mysqli_options</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-sqlstate.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-sqlstate.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-sqlstate.xml:1.6 phpdoc/en/reference/mysqli/functions/mysqli-sqlstate.xml:1.7 --- phpdoc/en/reference/mysqli/functions/mysqli-sqlstate.xml:1.6 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-sqlstate.xml Sat Jan 27 17:37:36 2007 @@ -1,55 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.mysqli-sqlstate"> - <refnamediv> - <refname>mysqli_sqlstate</refname> - <refname>mysqli->sqlstate</refname> - <refpurpose>Returns the SQLSTATE error from previous MySQL operation</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>string</type><methodname>mysqli_sqlstate</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <fieldsynopsis><type>string</type><varname>sqlstate</varname></fieldsynopsis> - </classsynopsis> - <para> - Returns a string containing the SQLSTATE error code for the last error. - The error code consists of five characters. <literal>'00000'</literal> means no error. - The values are specified by ANSI SQL and ODBC. For a list of possible values, see - <ulink url="&url.mysql.docs.error;">&url.mysql.docs.error;</ulink>. - </para> - <note> - <para> - Note that not all MySQL errors are yet mapped to SQLSTATE's. - The value <literal>HY000</literal> (general error) is used for unmapped errors. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns a string containing the SQLSTATE error code for the last error. - The error code consists of five characters. <literal>'00000'</literal> means no error. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_errno</function>&listendand; - <function>mysqli_error</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<refentry id="function.mysqli-sqlstate"> + <refnamediv> + <refname>mysqli_sqlstate</refname> + <refname>mysqli->sqlstate</refname> + <refpurpose>Returns the SQLSTATE error from previous MySQL operation</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>string</type><methodname>mysqli_sqlstate</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>string</type><varname>sqlstate</varname></fieldsynopsis> + </classsynopsis> + <para> + Returns a string containing the SQLSTATE error code for the last error. + The error code consists of five characters. <literal>'00000'</literal> means no error. + The values are specified by ANSI SQL and ODBC. For a list of possible values, see + <ulink url="&url.mysql.docs.error;">&url.mysql.docs.error;</ulink>. + </para> + <note> + <para> + Note that not all MySQL errors are yet mapped to SQLSTATE's. + The value <literal>HY000</literal> (general error) is used for unmapped errors. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns a string containing the SQLSTATE error code for the last error. + The error code consists of five characters. <literal>'00000'</literal> means no error. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_errno</function>&listendand; + <function>mysqli_error</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -68,11 +68,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -91,16 +91,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Error - SQLSTATE 42S01. ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-ssl-set.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-ssl-set.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-ssl-set.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-ssl-set.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-ssl-set.xml:1.7 Fri Nov 19 11:09:56 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-ssl-set.xml Sat Jan 27 17:37:36 2007 @@ -1,68 +1,68 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-ssl-set"> - <refnamediv> - <refname>mysqli_ssl_set</refname> - <refname>mysqli->ssl_set</refname> - <refpurpose>Used for establishing secure connections using SSL</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_ssl_set</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>string</type><parameter>cert</parameter></methodparam> - <methodparam><type>string</type><parameter>ca</parameter></methodparam> - <methodparam><type>string</type><parameter>capath</parameter></methodparam> - <methodparam><type>string</type><parameter>cipher</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>ssl_set</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>string</type><parameter>cert</parameter></methodparam> - <methodparam><type>string</type><parameter>ca</parameter></methodparam> - <methodparam><type>string</type><parameter>capath</parameter></methodparam> - <methodparam><type>string</type><parameter>cipher</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - The function <function>mysqli_ssl_set</function> is used for establishing - secure connections using SSL. It must be called before - <function>mysqli_real_connect</function>. This function does nothing - unless OpenSSL support is enabled. - </para> - <para> - <parameter>key</parameter> is the pathname to the key file. - <parameter>cert</parameter> is the pathname to the certificate file. - <parameter>ca</parameter> is the pathname to the certificate authority file. - <parameter>capath</parameter> is the pathname to a directory that contains - trusted SSL CA certificates in pem format. - <parameter>cipher</parameter> is a list of allowable ciphers to use for - SSL encryption. - Any unused SSL parameters may be given as &null; - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - This function always returns &true; value. If SSL setup is - incorrect <function>mysqli_real_connect</function> will return an error - when you attempt to connect. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_options</function>&listendand; - <function>mysqli_real_connect</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-ssl-set"> + <refnamediv> + <refname>mysqli_ssl_set</refname> + <refname>mysqli->ssl_set</refname> + <refpurpose>Used for establishing secure connections using SSL</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_ssl_set</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>string</type><parameter>cert</parameter></methodparam> + <methodparam><type>string</type><parameter>ca</parameter></methodparam> + <methodparam><type>string</type><parameter>capath</parameter></methodparam> + <methodparam><type>string</type><parameter>cipher</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>ssl_set</methodname> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>string</type><parameter>cert</parameter></methodparam> + <methodparam><type>string</type><parameter>ca</parameter></methodparam> + <methodparam><type>string</type><parameter>capath</parameter></methodparam> + <methodparam><type>string</type><parameter>cipher</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + The function <function>mysqli_ssl_set</function> is used for establishing + secure connections using SSL. It must be called before + <function>mysqli_real_connect</function>. This function does nothing + unless OpenSSL support is enabled. + </para> + <para> + <parameter>key</parameter> is the pathname to the key file. + <parameter>cert</parameter> is the pathname to the certificate file. + <parameter>ca</parameter> is the pathname to the certificate authority file. + <parameter>capath</parameter> is the pathname to a directory that contains + trusted SSL CA certificates in pem format. + <parameter>cipher</parameter> is a list of allowable ciphers to use for + SSL encryption. + Any unused SSL parameters may be given as &null; + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + This function always returns &true; value. If SSL setup is + incorrect <function>mysqli_real_connect</function> will return an error + when you attempt to connect. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_options</function>&listendand; + <function>mysqli_real_connect</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stat.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stat.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stat.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-stat.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-stat.xml:1.8 Thu Jun 23 16:53:26 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-stat.xml Sat Jan 27 17:37:36 2007 @@ -1,50 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-stat"> - <refnamediv> - <refname>mysqli_stat</refname> - <refname>mysqli->stat</refname> - <refpurpose>Gets the current system status</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>string</type><methodname>mysqli_stat</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>string</type><methodname>stat</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - <function>mysqli_stat</function> returns a string containing - information similar to that provided by the 'mysqladmin status' command. - This includes uptime in seconds and the number of running threads, - questions, reloads, and open tables. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - A string describing the server status. &false; if an error occurred. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_get_server_info</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-stat"> + <refnamediv> + <refname>mysqli_stat</refname> + <refname>mysqli->stat</refname> + <refpurpose>Gets the current system status</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>string</type><methodname>mysqli_stat</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>string</type><methodname>stat</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + <function>mysqli_stat</function> returns a string containing + information similar to that provided by the 'mysqladmin status' command. + This includes uptime in seconds and the number of running threads, + questions, reloads, and open tables. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + A string describing the server status. &false; if an error occurred. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_get_server_info</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -60,11 +60,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -80,18 +80,18 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ System status: Uptime: 272 Threads: 1 Questions: 5340 Slow queries: 0 Opens: 13 Flush tables: 1 Open tables: 0 Queries per second avg: 19.632 Memory in use: 8496K Max memory used: 8560K ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-affected-rows.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-affected-rows.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-affected-rows.xml:1.9 phpdoc/en/reference/mysqli/functions/mysqli-stmt-affected-rows.xml:1.10 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-affected-rows.xml:1.9 Thu Jun 23 16:53:26 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-affected-rows.xml Sat Jan 27 17:37:36 2007 @@ -1,62 +1,62 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> - <refentry id="function.mysqli-stmt-affected-rows"> - <refnamediv> - <refname>mysqli_stmt_affected_rows</refname> - <refname>mysqli_stmt->affected_rows</refname> - <refpurpose>Returns the total number of rows changed, deleted, or - inserted by the last executed statement - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style :</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_stmt_affected_rows</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <fieldsynopsis><type>int</type><varname>affected_rows</varname></fieldsynopsis> - </classsynopsis> - <para> - <function>mysqli_stmt_affected_rows</function> returns the number of rows affected - by INSERT, UPDATE, or DELETE query. If the last query was invalid, this function will return -1. - </para> - <para> - The <function>mysqli_stmt_affected_rows</function> function only works with queries - which update a table. In order to return the number of rows from a SELECT query, use - the <function>mysqli_stmt_num_rows</function> function instead. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - An integer greater than zero indicates the number of rows affected or retrieved. - Zero indicates that no records where updated for an UPDATE/DELETE statement, no - rows matched the WHERE clause in the query or that no query has yet been executed. - -1 indicates that the query has returned an error. - </para> - <note> - <para> - If the number of affected rows is greater than maximal PHP int value, the number of - affected rows will be returned as a string value. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_num_rows</function>&listendand; - <function>mysqli_prepare</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.10 $ --> +<refentry id="function.mysqli-stmt-affected-rows"> + <refnamediv> + <refname>mysqli_stmt_affected_rows</refname> + <refname>mysqli_stmt->affected_rows</refname> + <refpurpose>Returns the total number of rows changed, deleted, or + inserted by the last executed statement + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style :</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_stmt_affected_rows</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> + <fieldsynopsis><type>int</type><varname>affected_rows</varname></fieldsynopsis> + </classsynopsis> + <para> + <function>mysqli_stmt_affected_rows</function> returns the number of rows affected + by INSERT, UPDATE, or DELETE query. If the last query was invalid, this function will return -1. + </para> + <para> + The <function>mysqli_stmt_affected_rows</function> function only works with queries + which update a table. In order to return the number of rows from a SELECT query, use + the <function>mysqli_stmt_num_rows</function> function instead. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + An integer greater than zero indicates the number of rows affected or retrieved. + Zero indicates that no records where updated for an UPDATE/DELETE statement, no + rows matched the WHERE clause in the query or that no query has yet been executed. + -1 indicates that the query has returned an error. + </para> + <note> + <para> + If the number of affected rows is greater than maximal PHP int value, the number of + affected rows will be returned as a string value. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_num_rows</function>&listendand; + <function>mysqli_prepare</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -78,7 +78,7 @@ /* Bind variable for placeholder */ $code = 'A%'; $stmt->bind_param("s", $code); - + /* execute statement */ $stmt->execute(); @@ -92,11 +92,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -118,7 +118,7 @@ /* Bind variable for placeholder */ $code = 'A%'; mysqli_stmt_bind_param($stmt, "s", $code); - + /* execute statement */ mysqli_stmt_execute($stmt); @@ -132,16 +132,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ rows inserted: 17 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-param.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-param.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-param.xml:1.13 phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-param.xml:1.14 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-param.xml:1.13 Fri May 26 22:12:39 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-param.xml Sat Jan 27 17:37:36 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <refentry id="function.mysqli-stmt-bind-param"> <refnamediv> <refname>mysqli_stmt_bind_param</refname> @@ -29,7 +29,7 @@ <para> <function>mysqli_stmt_bind_param</function> is used to bind variables for the parameter markers in the SQL statement that was passed to - <function>mysqli_prepare</function>. + <function>mysqli_prepare</function>. The string <parameter>types</parameter> contains one or more characters which specify the types for the corresponding bind variables <table> @@ -65,7 +65,7 @@ <note> <para> If data size of a variable exceeds max. allowed packet size - (max_allowed_packet), you have to specify <literal>b</literal> in + (max_allowed_packet), you have to specify <literal>b</literal> in <parameter>types</parameter> and use <function>mysqli_stmt_send_long_data</function> to send the data in packets. </para> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-result.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-result.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-result.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-result.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-result.xml:1.8 Sun Jul 30 11:32:46 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-bind-result.xml Sat Jan 27 17:37:36 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <refentry id="function.mysqli-stmt-bind-result"> <refnamediv> <refname>mysqli_stmt_bind_result</refname> @@ -8,39 +8,39 @@ </refnamediv> <refsect1> <title>Description</title> - <para>Procedural style:</para> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_stmt_bind_result</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + <methodparam><type>mixed</type><parameter role="reference">var1</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter role="reference">...</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> <methodsynopsis> - <type>bool</type><methodname>mysqli_stmt_bind_result</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + <type>bool</type><methodname>bind_result</methodname> <methodparam><type>mixed</type><parameter role="reference">var1</parameter></methodparam> <methodparam choice="opt"><type>mixed</type><parameter role="reference">...</parameter></methodparam> </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>bind_result</methodname> - <methodparam><type>mixed</type><parameter role="reference">var1</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter role="reference">...</parameter></methodparam> - </methodsynopsis> - </classsynopsis> + </classsynopsis> + <para> + <function>mysqli_stmt_bind_result</function> is used to associate (bind) columns in the result + set to variables. When <function>mysqli_stmt_fetch</function> is called to fetch data, the MySQL + client/server protocol places the data for the bound columns into the specified variables + <parameter>var1, ...</parameter>. + </para> + <note> + <para> + Note that all columns must be bound after <function>mysqli_stmt_execute</function> and prior to calling + <function>mysqli_stmt_fetch</function>. + Depending on column types bound variables can silently change to the corresponding PHP type. + </para> <para> - <function>mysqli_stmt_bind_result</function> is used to associate (bind) columns in the result - set to variables. When <function>mysqli_stmt_fetch</function> is called to fetch data, the MySQL - client/server protocol places the data for the bound columns into the specified variables - <parameter>var1, ...</parameter>. + A column can be bound or rebound at any time, even after a result set has been partially retrieved. + The new binding takes effect the next time <function>mysqli_stmt_fetch</function> is called. </para> - <note> - <para> - Note that all columns must be bound after <function>mysqli_stmt_execute</function> and prior to calling - <function>mysqli_stmt_fetch</function>. - Depending on column types bound variables can silently change to the corresponding PHP type. - </para> - <para> - A column can be bound or rebound at any time, even after a result set has been partially retrieved. - The new binding takes effect the next time <function>mysqli_stmt_fetch</function> is called. - </para> - </note> + </note> </refsect1> <refsect1> &reftitle.returnvalues; http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-close.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-close.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-close.xml:1.9 phpdoc/en/reference/mysqli/functions/mysqli-stmt-close.xml:1.10 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-close.xml:1.9 Thu Dec 16 08:47:55 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-close.xml Sat Jan 27 17:37:36 2007 @@ -1,44 +1,44 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> - <refentry id="function.mysqli-stmt-close"> - <refnamediv> - <refname>mysqli_stmt_close</refname> - <refname>mysqli_stmt->close</refname> - <refpurpose>Closes a prepared statement</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_stmt_close</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>close</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - Closes a prepared statement. <function>mysqli_stmt_close</function> also deallocates the - statement handle pointed to by <parameter>stmt</parameter>. - If the current statement has pending or unread results, this function cancels them so that - the next query can be executed. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para>&return.success;</para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_prepare</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.10 $ --> +<refentry id="function.mysqli-stmt-close"> + <refnamediv> + <refname>mysqli_stmt_close</refname> + <refname>mysqli_stmt->close</refname> + <refpurpose>Closes a prepared statement</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_stmt_close</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>close</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Closes a prepared statement. <function>mysqli_stmt_close</function> also deallocates the + statement handle pointed to by <parameter>stmt</parameter>. + If the current statement has pending or unread results, this function cancels them so that + the next query can be executed. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para>&return.success;</para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_prepare</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-data-seek.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-data-seek.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-data-seek.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-stmt-data-seek.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-data-seek.xml:1.7 Fri Jun 24 13:46:14 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-data-seek.xml Sat Jan 27 17:37:36 2007 @@ -1,57 +1,57 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-stmt-data-seek"> - <refnamediv> - <refname>mysqli_stmt_data_seek</refname> - <refname>stmt->data_seek</refname> - <refpurpose>Seeks to an arbitray row in statement result set</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>void</type><methodname>mysqli_stmt_data_seek</methodname> - <methodparam><type>mysqli_stmt</type><parameter>statement</parameter></methodparam> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <methodsynopsis> - <type>void</type><methodname>data_seek</methodname> - <methodparam><type>int</type><parameter>offset</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - The <function>mysqli_stmt_data_seek</function> function seeks to an arbitrary result pointer - specified by the <parameter>offset</parameter> in the statement result set represented by - <parameter>statement</parameter>. The <parameter>offset</parameter> parameter must be between - zero and the total number of rows minus one (0..<function>mysqli_stmt_num_rows</function> - 1). - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns &null; on success or &false; on failure. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_prepare</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-stmt-data-seek"> + <refnamediv> + <refname>mysqli_stmt_data_seek</refname> + <refname>stmt->data_seek</refname> + <refpurpose>Seeks to an arbitray row in statement result set</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>void</type><methodname>mysqli_stmt_data_seek</methodname> + <methodparam><type>mysqli_stmt</type><parameter>statement</parameter></methodparam> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> + <methodsynopsis> + <type>void</type><methodname>data_seek</methodname> + <methodparam><type>int</type><parameter>offset</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + The <function>mysqli_stmt_data_seek</function> function seeks to an arbitrary result pointer + specified by the <parameter>offset</parameter> in the statement result set represented by + <parameter>statement</parameter>. The <parameter>offset</parameter> parameter must be between + zero and the total number of rows minus one (0..<function>mysqli_stmt_num_rows</function> - 1). + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns &null; on success or &false; on failure. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_prepare</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -85,17 +85,17 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -129,16 +129,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ City: Benin City Countrycode: NGA ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-errno.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-errno.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-errno.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-stmt-errno.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-errno.xml:1.7 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-errno.xml Sat Jan 27 17:37:36 2007 @@ -1,60 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-stmt-errno"> - <refnamediv> - <refname>mysqli_stmt_errno</refname> - <refname>mysqli_stmt->errno</refname> - <refpurpose>Returns the error code for the most recent statement call</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style :</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_stmt_errno</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <fieldsynopsis><type>int</type><varname>errno</varname></fieldsynopsis> - </classsynopsis> - <para> - For the statement specified by <literal>stmt</literal>, <function>mysqli_stmt_errno</function> - returns the error code for the most recently invoked statement function that can succeed or fail. - </para> - <note> - <para> - Client error message numbers are listed in the MySQL <filename>errmsg.h</filename> header file, - server error message numbers are listed in <filename>mysqld_error.h</filename>. - In the MySQL source distribution you can find a complete list of error messages and error numbers - in the file <filename>Docs/mysqld_error.txt</filename>. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - An error code value. Zero means no error occurred. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_error</function>&listendand; - <function>mysqli_stmt_sqlstate</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-stmt-errno"> + <refnamediv> + <refname>mysqli_stmt_errno</refname> + <refname>mysqli_stmt->errno</refname> + <refpurpose>Returns the error code for the most recent statement call</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style :</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_stmt_errno</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> + <fieldsynopsis><type>int</type><varname>errno</varname></fieldsynopsis> + </classsynopsis> + <para> + For the statement specified by <literal>stmt</literal>, <function>mysqli_stmt_errno</function> + returns the error code for the most recently invoked statement function that can succeed or fail. + </para> + <note> + <para> + Client error message numbers are listed in the MySQL <filename>errmsg.h</filename> header file, + server error message numbers are listed in <filename>mysqld_error.h</filename>. + In the MySQL source distribution you can find a complete list of error messages and error numbers + in the file <filename>Docs/mysqld_error.txt</filename>. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + An error code value. Zero means no error occurred. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_error</function>&listendand; + <function>mysqli_stmt_sqlstate</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -83,17 +83,17 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -122,16 +122,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Error: 1146. ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-error.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-error.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-error.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-stmt-error.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-error.xml:1.8 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-error.xml Sat Jan 27 17:37:36 2007 @@ -1,53 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-stmt-error"> - <refnamediv> - <refname>mysqli_stmt_error</refname> - <refname>mysqli_stmt->error</refname> - <refpurpose>Returns a string description for last statement error</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>string</type><methodname>mysqli_stmt_error</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <fieldsynopsis><type>string</type><varname>error</varname></fieldsynopsis> - </classsynopsis> - <para> - For the statement specified by <literal>stmt</literal>, <function>mysqli_stmt_error</function> - returns a containing the error message for the most recently invoked statement function that - can succeed or fail. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - A string that describes the error. An empty string if no error occurred. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_errno</function>&listendand; - <function>mysqli_stmt_sqlstate</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-stmt-error"> + <refnamediv> + <refname>mysqli_stmt_error</refname> + <refname>mysqli_stmt->error</refname> + <refpurpose>Returns a string description for last statement error</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>string</type><methodname>mysqli_stmt_error</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> + <fieldsynopsis><type>string</type><varname>error</varname></fieldsynopsis> + </classsynopsis> + <para> + For the statement specified by <literal>stmt</literal>, <function>mysqli_stmt_error</function> + returns a containing the error message for the most recently invoked statement function that + can succeed or fail. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + A string that describes the error. An empty string if no error occurred. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_errno</function>&listendand; + <function>mysqli_stmt_sqlstate</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -76,17 +76,17 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -115,16 +115,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Error: Table 'world.myCountry' doesn't exist. ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-execute.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-execute.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-execute.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-stmt-execute.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-execute.xml:1.8 Tue Apr 26 14:33:30 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-execute.xml Sat Jan 27 17:37:36 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <refentry id="function.mysqli-stmt-execute"> <refnamediv> <refname>mysqli_stmt_execute</refname> @@ -8,19 +8,19 @@ </refnamediv> <refsect1> <title>Description</title> - <para>Procedural style:</para> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_stmt_execute</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> <methodsynopsis> - <type>bool</type><methodname>mysqli_stmt_execute</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + <type>bool</type><methodname>execute</methodname> + <void /> </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>execute</methodname> - <void /> - </methodsynopsis> - </classsynopsis> + </classsynopsis> <para> The <function>mysqli_stmt_execute</function> function executes a query that has been previously prepared using the <function>mysqli_prepare</function> function represented by the @@ -60,15 +60,15 @@ <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); - + /* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } - + $mysqli->query("CREATE TABLE myCity LIKE City"); - + /* Prepare an insert statement */ $query = "INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)"; $stmt = $mysqli->prepare($query); @@ -78,14 +78,14 @@ $val1 = 'Stuttgart'; $val2 = 'DEU'; $val3 = 'Baden-Wuerttemberg'; - + /* Execute the statement */ $stmt->execute(); $val1 = 'Bordeaux'; $val2 = 'FRA'; $val3 = 'Aquitaine'; - + /* Execute the statement */ $stmt->execute(); @@ -105,8 +105,8 @@ /* remove table */ $mysqli->query("DROP TABLE myCity"); -/* close connection */ -$mysqli->close(); +/* close connection */ +$mysqli->close(); ?> ]]> </programlisting> @@ -117,15 +117,15 @@ <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); - + /* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } - + mysqli_query($link, "CREATE TABLE myCity LIKE City"); - + /* Prepare an insert statement */ $query = "INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)"; $stmt = mysqli_prepare($link, $query); @@ -135,14 +135,14 @@ $val1 = 'Stuttgart'; $val2 = 'DEU'; $val3 = 'Baden-Wuerttemberg'; - + /* Execute the statement */ mysqli_stmt_execute($stmt); $val1 = 'Bordeaux'; $val2 = 'FRA'; $val3 = 'Aquitaine'; - + /* Execute the statement */ mysqli_stmt_execute($stmt); @@ -162,8 +162,8 @@ /* remove table */ mysqli_query($link, "DROP TABLE myCity"); -/* close connection */ -mysqli_close($link); +/* close connection */ +mysqli_close($link); ?> ]]> </programlisting> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-fetch.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-fetch.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-fetch.xml:1.10 phpdoc/en/reference/mysqli/functions/mysqli-stmt-fetch.xml:1.11 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-fetch.xml:1.10 Thu Jun 23 16:53:26 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-fetch.xml Sat Jan 27 17:37:36 2007 @@ -1,12 +1,10 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <refentry id="function.mysqli-stmt-fetch"> <refnamediv> <refname>mysqli_stmt_fetch</refname> <refname>stmt->fetch</refname> - <refpurpose> - Fetch results from a prepared statement into the bound variables - </refpurpose> + <refpurpose>Fetch results from a prepared statement into the bound variables</refpurpose> </refnamediv> <refsect1> <title>Description</title> @@ -22,16 +20,16 @@ <type>bool</type><methodname>fetch</methodname> <void /> </methodsynopsis> - </classsynopsis> + </classsynopsis> <para> <function>mysqli_stmt_fetch</function> fetch the result from a prepared - statement into the variables bound by + statement into the variables bound by <function>mysqli_stmt_bind_result</function>. </para> <note> <para> - Note that all columns must be bound by the application before calling - <function>mysqli_stmt_fetch</function>. + Note that all columns must be bound by the application before calling + <function>mysqli_stmt_fetch</function>. </para> </note> </refsect1> @@ -86,7 +84,7 @@ printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } - + $query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 150,5"; if ($stmt = $mysqli->prepare($query)) { http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-free-result.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-free-result.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-free-result.xml:1.4 phpdoc/en/reference/mysqli/functions/mysqli-stmt-free-result.xml:1.5 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-free-result.xml:1.4 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-free-result.xml Sat Jan 27 17:37:36 2007 @@ -1,47 +1,47 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.mysqli-stmt-free-result"> - <refnamediv> - <refname>mysqli_stmt_free_result</refname> - <refname>stmt->free_result</refname> - <refpurpose>Frees stored result memory for the given statement handle</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>void</type><methodname>mysqli_stmt_free_result</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <methodsynopsis> - <type>void</type><methodname>free_result</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - The <function>mysqli_stmt_free_result</function> function frees the result memory - associated with the statement represented by the - <parameter>stmt</parameter> parameter, which was allocated by - <function>mysqli_stmt_store_result</function>. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - This function doesn't return any value. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_store_result</function>. - </para> - </refsect1> - - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.mysqli-stmt-free-result"> + <refnamediv> + <refname>mysqli_stmt_free_result</refname> + <refname>stmt->free_result</refname> + <refpurpose>Frees stored result memory for the given statement handle</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>void</type><methodname>mysqli_stmt_free_result</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> + <methodsynopsis> + <type>void</type><methodname>free_result</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + The <function>mysqli_stmt_free_result</function> function frees the result memory + associated with the statement represented by the + <parameter>stmt</parameter> parameter, which was allocated by + <function>mysqli_stmt_store_result</function>. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + This function doesn't return any value. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_store_result</function>. + </para> + </refsect1> + +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-init.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-init.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-init.xml:1.6 phpdoc/en/reference/mysqli/functions/mysqli-stmt-init.xml:1.7 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-init.xml:1.6 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-init.xml Sat Jan 27 17:37:36 2007 @@ -1,52 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.mysqli-stmt-init"> - <refnamediv> - <refname>mysqli_stmt_init</refname> - <refname>mysqli->stmt_init</refname> - <refpurpose> - Initializes a statement and returns an object for use with mysqli_stmt_prepare - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style :</para> - <methodsynopsis> - <type>mysqli_stmt</type><methodname>mysqli_stmt_init</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>mysqli_stmt</type><methodname>stmt_init</methodname> - <void/> - </methodsynopsis> - </classsynopsis> +<!-- $Revision: 1.7 $ --> +<refentry id="function.mysqli-stmt-init"> + <refnamediv> + <refname>mysqli_stmt_init</refname> + <refname>mysqli->stmt_init</refname> + <refpurpose>Initializes a statement and returns an object for use with mysqli_stmt_prepare</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style :</para> + <methodsynopsis> + <type>mysqli_stmt</type><methodname>mysqli_stmt_init</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>mysqli_stmt</type><methodname>stmt_init</methodname> + <void/> + </methodsynopsis> + </classsynopsis> + <para> + Allocates and initializes a statement object suitable for + <function>mysqli_stmt_prepare</function>. + </para> + <note> <para> - Allocates and initializes a statement object suitable for - <function>mysqli_stmt_prepare</function>. + Any subsequent calls to any mysqli_stmt function + will fail until <function>mysqli_stmt_prepare</function> was called. </para> - <note> - <para> - Any subsequent calls to any mysqli_stmt function - will fail until <function>mysqli_stmt_prepare</function> was called. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns an object. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_prepare</function>. - </para> - </refsect1> - </refentry> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns an object. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_prepare</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-num-rows.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-num-rows.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-num-rows.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-stmt-num-rows.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-num-rows.xml:1.8 Thu Jun 23 16:53:26 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-num-rows.xml Sat Jan 27 17:37:36 2007 @@ -1,60 +1,60 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-stmt-num-rows"> - <refnamediv> - <refname>mysqli_stmt_num_rows</refname> - <refname>stmt->num_rows</refname> - <refpurpose>Return the number of rows in statements result set</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style :</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_stmt_num_rows</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <fieldsynopsis><type>int</type><varname>num_rows</varname></fieldsynopsis> - </classsynopsis> - <para> - Returns the number of rows in the result set. - The use of <function>mysqli_stmt_num_rows</function> - depends on whether or not you used - <function>mysqli_stmt_store_result</function> to buffer the entire result - set in the statement handle. - </para> - <para> - If you use <function>mysqli_stmt_store_result</function>, - <function>mysqli_stmt_num_rows</function> may be called immediately. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - An integer representing the number of rows in result set. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_affected_rows</function>, - <function>mysqli_prepare</function>&listendand; - <function>mysqli_stmt_store_result</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-stmt-num-rows"> + <refnamediv> + <refname>mysqli_stmt_num_rows</refname> + <refname>stmt->num_rows</refname> + <refpurpose>Return the number of rows in statements result set</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style :</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_stmt_num_rows</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> + <fieldsynopsis><type>int</type><varname>num_rows</varname></fieldsynopsis> + </classsynopsis> + <para> + Returns the number of rows in the result set. + The use of <function>mysqli_stmt_num_rows</function> + depends on whether or not you used + <function>mysqli_stmt_store_result</function> to buffer the entire result + set in the statement handle. + </para> + <para> + If you use <function>mysqli_stmt_store_result</function>, + <function>mysqli_stmt_num_rows</function> may be called immediately. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + An integer representing the number of rows in result set. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_affected_rows</function>, + <function>mysqli_prepare</function>&listendand; + <function>mysqli_stmt_store_result</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -79,17 +79,17 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -114,16 +114,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Number of rows: 20. ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-param-count.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-param-count.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-param-count.xml:1.4 phpdoc/en/reference/mysqli/functions/mysqli-stmt-param-count.xml:1.5 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-param-count.xml:1.4 Tue Apr 26 14:33:31 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-param-count.xml Sat Jan 27 17:37:36 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <refentry id="function.mysqli-stmt-param-count"> <refnamediv> <refname>mysqli_stmt_param_count</refname> @@ -8,20 +8,20 @@ </refnamediv> <refsect1> <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_stmt_param_count</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <fieldsynopsis><type>int</type><varname>param_count</varname></fieldsynopsis> - </classsynopsis> - <para> - <function>mysqli_stmt_param_count</function> returns the number of parameter - markers present in the prepared statement. - </para> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_stmt_param_count</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> + <fieldsynopsis><type>int</type><varname>param_count</varname></fieldsynopsis> + </classsynopsis> + <para> + <function>mysqli_stmt_param_count</function> returns the number of parameter + markers present in the prepared statement. + </para> </refsect1> <refsect1> &reftitle.returnvalues; http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-prepare.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-prepare.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-prepare.xml:1.4 phpdoc/en/reference/mysqli/functions/mysqli-stmt-prepare.xml:1.5 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-prepare.xml:1.4 Thu Oct 5 13:45:36 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-prepare.xml Sat Jan 27 17:37:36 2007 @@ -1,91 +1,89 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.mysqli-stmt-prepare"> - <refnamediv> - <refname>mysqli_stmt_prepare</refname> - <refname>stmt->prepare</refname> - <refpurpose> - Prepare a SQL statement for execution - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedure style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_stmt_prepare</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method)</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <methodsynopsis> - <type>mixed</type><methodname>prepare</methodname> - <methodparam><type>string</type><parameter>query</parameter></methodparam> - </methodsynopsis> - </classsynopsis> - <para> - <function>mysqli_stmt_prepare</function> prepares the SQL query pointed to by the - null-terminated string query. The statement object has to be allocated by - <function>mysqli_stmt_init</function>. - The query must consist of a single SQL statement. - </para> - <note> - <para> - You should not add a terminating semicolon or <literal>\g</literal> - to the statement. - </para> - </note> - <para> - The parameter <parameter>query</parameter> can include one or more parameter markers - in the SQL statement by embedding question mark (<literal>?</literal>) characters - at the appropriate positions. - </para> - <note> - <para> - The markers are legal only in certain places in SQL statements. - For example, they are allowed in the VALUES() list of an INSERT statement - (to specify column values for a row), or in a comparison with a column in - a WHERE clause to specify a comparison value. - </para> - <para> - However, they are not allowed for identifiers (such as table or column names), - in the select list that names the columns to be returned by a SELECT statement), - or to specify both operands of a binary operator such as the <literal>=</literal> - equal sign. The latter restriction is necessary because it would be impossible - to determine the parameter type. In general, parameters are legal only in Data - Manipulation Languange (DML) statements, and not in Data Defination Language - (DDL) statements. - </para> - </note> - <para> - The parameter markers must be bound to application variables using - <function>mysqli_stmt_bind_param</function> and/or <function>mysqli_stmt_bind_result</function> - before executing the statement or fetching rows. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &return.success; - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_init</function>, - <function>mysqli_stmt_execute</function>, - <function>mysqli_stmt_fetch</function>, - <function>mysqli_stmt_bind_param</function>, - <function>mysqli_stmt_bind_result</function>&listendand; - <function>mysqli_stmt_close</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.5 $ --> +<refentry id="function.mysqli-stmt-prepare"> + <refnamediv> + <refname>mysqli_stmt_prepare</refname> + <refname>stmt->prepare</refname> + <refpurpose>Prepare a SQL statement for execution</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedure style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_stmt_prepare</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method)</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> + <methodsynopsis> + <type>mixed</type><methodname>prepare</methodname> + <methodparam><type>string</type><parameter>query</parameter></methodparam> + </methodsynopsis> + </classsynopsis> + <para> + <function>mysqli_stmt_prepare</function> prepares the SQL query pointed to by the + null-terminated string query. The statement object has to be allocated by + <function>mysqli_stmt_init</function>. + The query must consist of a single SQL statement. + </para> + <note> + <para> + You should not add a terminating semicolon or <literal>\g</literal> + to the statement. + </para> + </note> + <para> + The parameter <parameter>query</parameter> can include one or more parameter markers + in the SQL statement by embedding question mark (<literal>?</literal>) characters + at the appropriate positions. + </para> + <note> + <para> + The markers are legal only in certain places in SQL statements. + For example, they are allowed in the VALUES() list of an INSERT statement + (to specify column values for a row), or in a comparison with a column in + a WHERE clause to specify a comparison value. + </para> + <para> + However, they are not allowed for identifiers (such as table or column names), + in the select list that names the columns to be returned by a SELECT statement), + or to specify both operands of a binary operator such as the <literal>=</literal> + equal sign. The latter restriction is necessary because it would be impossible + to determine the parameter type. In general, parameters are legal only in Data + Manipulation Languange (DML) statements, and not in Data Defination Language + (DDL) statements. + </para> + </note> + <para> + The parameter markers must be bound to application variables using + <function>mysqli_stmt_bind_param</function> and/or <function>mysqli_stmt_bind_result</function> + before executing the statement or fetching rows. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_init</function>, + <function>mysqli_stmt_execute</function>, + <function>mysqli_stmt_fetch</function>, + <function>mysqli_stmt_bind_param</function>, + <function>mysqli_stmt_bind_result</function>&listendand; + <function>mysqli_stmt_close</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -118,17 +116,17 @@ /* close statement */ $stmt->close(); -} +} /* close connection */ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -161,22 +159,22 @@ /* close statement */ mysqli_stmt_close($stmt); -} +} /* close connection */ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Amersfoort is in district Utrecht ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-reset.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-reset.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-reset.xml:1.4 phpdoc/en/reference/mysqli/functions/mysqli-stmt-reset.xml:1.5 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-reset.xml:1.4 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-reset.xml Sat Jan 27 17:37:36 2007 @@ -1,48 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> - <refentry id="function.mysqli-stmt-reset"> - <refnamediv> - <refname>mysqli_stmt_reset</refname> - <refname>stmt->reset</refname> - <refpurpose>Resets a prepared statement</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_stmt_reset</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>reset</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - The <function>mysqli_stmt_reset</function> resets a prepared statement on client and server - to state after prepare. For now this is mainly used to reset data sent with - <function>mysqli_stmt_send_long_data</function>. - </para> - <note> - <para> - To prepare a statement with another query use function <function>mysqli_stmt_prepare</function>. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para>&return.success;</para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_prepare</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.5 $ --> +<refentry id="function.mysqli-stmt-reset"> + <refnamediv> + <refname>mysqli_stmt_reset</refname> + <refname>stmt->reset</refname> + <refpurpose>Resets a prepared statement</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_stmt_reset</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>reset</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + The <function>mysqli_stmt_reset</function> resets a prepared statement on client and server + to state after prepare. For now this is mainly used to reset data sent with + <function>mysqli_stmt_send_long_data</function>. + </para> + <note> + <para> + To prepare a statement with another query use function <function>mysqli_stmt_prepare</function>. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para>&return.success;</para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_prepare</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-result-metadata.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-result-metadata.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-result-metadata.xml:1.9 phpdoc/en/reference/mysqli/functions/mysqli-stmt-result-metadata.xml:1.10 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-result-metadata.xml:1.9 Fri Jun 24 13:46:14 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-result-metadata.xml Sat Jan 27 17:37:36 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <refentry id="function.mysqli-stmt-result-metadata"> <refnamediv> <refname>mysqli_stmt_result_metadata</refname> @@ -19,16 +19,16 @@ <type>mysqli_result</type><methodname>result_metadata</methodname> <void /> </methodsynopsis> - </classsynopsis> + </classsynopsis> <para> If a statement passed to <function>mysqli_prepare</function> is one that produces - a result set, <function>mysqli_stmt_result_metadata</function> returns the result object - that can be used to process the meta information such as total number of fields - and individual field information. + a result set, <function>mysqli_stmt_result_metadata</function> returns the result object + that can be used to process the meta information such as total number of fields + and individual field information. </para> <note> - <para>This result set pointer can be passed as an argument to any of the - field-based functions that process result set metadata, such as: + <para>This result set pointer can be passed as an argument to any of the + field-based functions that process result set metadata, such as: <itemizedlist> <listitem><para><function>mysqli_num_fields</function></para></listitem> <listitem><para><function>mysqli_fetch_field</function></para></listitem> @@ -42,15 +42,15 @@ </para> </note> <para> - The result set structure should be freed when you are done with it, + The result set structure should be freed when you are done with it, which you can do by passing it to <function>mysqli_free_result</function> </para> <note> <para> - The result set returned by <function>mysqli_stmt_result_metadata</function> contains only + The result set returned by <function>mysqli_stmt_result_metadata</function> contains only metadata. It does not contain any row results. The rows are obtained by using the statement handle with <function>mysqli_stmt_fetch</function>. - </para> + </para> </note> </refsect1> <refsect1> @@ -77,9 +77,9 @@ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "test"); -$mysqli->query("DROP TABLE IF EXISTS friends"); -$mysqli->query("CREATE TABLE friends (id int, name varchar(20))"); - +$mysqli->query("DROP TABLE IF EXISTS friends"); +$mysqli->query("CREATE TABLE friends (id int, name varchar(20))"); + $mysqli->query("INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"); $stmt = $mysqli->prepare("SELECT id, name FROM friends"); @@ -109,9 +109,9 @@ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "test"); -mysqli_query($link, "DROP TABLE IF EXISTS friends"); -mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))"); - +mysqli_query($link, "DROP TABLE IF EXISTS friends"); +mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))"); + mysqli_query($link, "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')"); $stmt = mysqli_prepare($link, "SELECT id, name FROM friends"); http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-send-long-data.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-send-long-data.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-send-long-data.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-stmt-send-long-data.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-send-long-data.xml:1.8 Mon Jan 30 21:32:11 2006 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-send-long-data.xml Sat Jan 27 17:37:36 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <refentry id="function.mysqli-stmt-send-long-data"> <refnamediv> <refname>mysqli_stmt_send_long_data</refname> @@ -26,13 +26,13 @@ </classsynopsis> <para> Allows to send parameter data to the server in pieces (or chunks), e.g. if the - size of a blob exceeds the size of <literal>max_allowed_packet</literal>. - This function can be called multiple times to send the parts of a character or - binary data value for a column, which must be one of the TEXT or BLOB datatypes. + size of a blob exceeds the size of <literal>max_allowed_packet</literal>. + This function can be called multiple times to send the parts of a character or + binary data value for a column, which must be one of the TEXT or BLOB datatypes. </para> <para> - <parameter>param_nr</parameter> indicates which parameter to associate the data with. - Parameters are numbered beginning with 0. + <parameter>param_nr</parameter> indicates which parameter to associate the data with. + Parameters are numbered beginning with 0. <parameter>data</parameter> is a string containing data to be sent. </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-sqlstate.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-sqlstate.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-sqlstate.xml:1.6 phpdoc/en/reference/mysqli/functions/mysqli-stmt-sqlstate.xml:1.7 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-sqlstate.xml:1.6 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-sqlstate.xml Sat Jan 27 17:37:36 2007 @@ -1,55 +1,55 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> - <refentry id="function.mysqli-stmt-sqlstate"> - <refnamediv> - <refname>mysqli_stmt_sqlstate</refname> - <refpurpose>Returns SQLSTATE error from previous statement operation</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>mysqli_stmt_sqlstate</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para> - Returns a string containing the SQLSTATE error code - for the most recently invoked prepared statement function that can succeed or fail. - The error code consists of five characters. <literal>'00000'</literal> means no error. - The values are specified by ANSI SQL and ODBC. For a list of possible values, see - <ulink url="&url.mysql.docs.error;">&url.mysql.docs.error;</ulink>. - </para> - <note> - <para> - Note that not all MySQL errors are yet mapped to SQLSTATE's. - The value <literal>HY000</literal> (general error) is used for unmapped errors. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns a string containing the SQLSTATE error code for the last error. - The error code consists of five characters. <literal>'00000'</literal> means no error. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_stmt_errno</function>&listendand; - <function>mysqli_stmt_error</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.7 $ --> +<refentry id="function.mysqli-stmt-sqlstate"> + <refnamediv> + <refname>mysqli_stmt_sqlstate</refname> + <refpurpose>Returns SQLSTATE error from previous statement operation</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>mysqli_stmt_sqlstate</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + </methodsynopsis> + <para> + Returns a string containing the SQLSTATE error code + for the most recently invoked prepared statement function that can succeed or fail. + The error code consists of five characters. <literal>'00000'</literal> means no error. + The values are specified by ANSI SQL and ODBC. For a list of possible values, see + <ulink url="&url.mysql.docs.error;">&url.mysql.docs.error;</ulink>. + </para> + <note> + <para> + Note that not all MySQL errors are yet mapped to SQLSTATE's. + The value <literal>HY000</literal> (general error) is used for unmapped errors. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns a string containing the SQLSTATE error code for the last error. + The error code consists of five characters. <literal>'00000'</literal> means no error. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_stmt_errno</function>&listendand; + <function>mysqli_stmt_error</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -78,17 +78,17 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -117,16 +117,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Error: 42S02. ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-stmt-store-result.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-stmt-store-result.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-stmt-store-result.xml:1.10 phpdoc/en/reference/mysqli/functions/mysqli-stmt-store-result.xml:1.11 --- phpdoc/en/reference/mysqli/functions/mysqli-stmt-store-result.xml:1.10 Tue Apr 5 14:01:04 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-stmt-store-result.xml Sat Jan 27 17:37:36 2007 @@ -1,64 +1,64 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> - <refentry id="function.mysqli-stmt-store-result"> - <refnamediv> - <refname>mysqli_stmt_store_result</refname> - <refname>mysqli_stmt->store_result</refname> - <refpurpose>Transfers a result set from a prepared statement</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_stmt_store_result</methodname> - <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli_stmt</classname></ooclass> - <methodsynopsis> - <type>bool</type><methodname>store_result</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - You must call <function>mysqli_stmt_store_result</function> for every query that - successfully produces a result set (<literal>SELECT, SHOW, DESCRIBE, EXPLAIN</literal>), - and only if you want to buffer the complete result set by the client, - so that the subsequent <function>mysqli_stmt_fetch</function> call returns buffered data. - </para> - <note> - <para> - It is unnecessary to call <function>mysqli_stmt_store_result</function> for other queries, - but if you do, it will not harm or cause any notable performance in all cases. - You can detect whether the query produced a result set by checking if - <function>mysqli_stmt_result_metadata</function> returns NULL. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para>&return.success;</para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_prepare</function>, - <function>mysqli_stmt_result_metadata</function>&listendand; - <function>mysqli_stmt_fetch</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.11 $ --> +<refentry id="function.mysqli-stmt-store-result"> + <refnamediv> + <refname>mysqli_stmt_store_result</refname> + <refname>mysqli_stmt->store_result</refname> + <refpurpose>Transfers a result set from a prepared statement</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_stmt_store_result</methodname> + <methodparam><type>mysqli_stmt</type><parameter>stmt</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli_stmt</classname></ooclass> + <methodsynopsis> + <type>bool</type><methodname>store_result</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + You must call <function>mysqli_stmt_store_result</function> for every query that + successfully produces a result set (<literal>SELECT, SHOW, DESCRIBE, EXPLAIN</literal>), + and only if you want to buffer the complete result set by the client, + so that the subsequent <function>mysqli_stmt_fetch</function> call returns buffered data. + </para> + <note> + <para> + It is unnecessary to call <function>mysqli_stmt_store_result</function> for other queries, + but if you do, it will not harm or cause any notable performance in all cases. + You can detect whether the query produced a result set by checking if + <function>mysqli_stmt_result_metadata</function> returns NULL. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para>&return.success;</para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_prepare</function>, + <function>mysqli_stmt_result_metadata</function>&listendand; + <function>mysqli_stmt_fetch</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -86,17 +86,17 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php /* Open a connection */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); -/* check connection */ +/* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); @@ -124,16 +124,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Number of rows: 20. ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-store-result.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-store-result.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-store-result.xml:1.10 phpdoc/en/reference/mysqli/functions/mysqli-store-result.xml:1.11 --- phpdoc/en/reference/mysqli/functions/mysqli-store-result.xml:1.10 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-store-result.xml Sat Jan 27 17:37:36 2007 @@ -1,76 +1,76 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> - <refentry id="function.mysqli-store-result"> - <refnamediv> - <refname>mysqli_store_result</refname> - <refname>mysqli->store_result</refname> - <refpurpose>Transfers a result set from the last query</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>mysqli_result</type><methodname>mysqli_store_result</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>mysqli_result</type><methodname>store_result</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - Transfers the result set from the last query on the database connection - represented by the <parameter>link</parameter> parameter to be used with - the <function>mysqli_data_seek</function> function. - </para> - <note> - <para> - Although it is always good practice to free the memory used by the result of - a query using the <function>mysqli_free_result</function> function, when - transfering large result sets using the <function>mysqli_store_result</function> - this becomes particularly important. - </para> - </note> - <note> - <para> - <function>mysqli_store_result</function> returns &false; in case the query - didn't return a result set (if the query was, for example an INSERT - statement). This function also returns &false; if the reading of the - result set failed. You can check if you have got an error by checking - if <function>mysqli_error</function> doesn't return an empty string, if - <function>mysqli_errno</function> returns a non zero value, or if - <function>mysqli_field_count</function> returns a non zero value. - Also possible reason for this function returning &false; after - successfull call to <function>mysqli_query</function> can be too large - result set (memory for it cannot be allocated). If - <function>mysqli_field_count</function> returns a non-zero value, the - statement should have produced a non-empty result set. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns a buffered result object or &false; if an error occurred. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_real_query</function>&listendand; - <function>mysqli_use_result</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <para> - See <function>mysqli_multi_query</function>. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.11 $ --> +<refentry id="function.mysqli-store-result"> + <refnamediv> + <refname>mysqli_store_result</refname> + <refname>mysqli->store_result</refname> + <refpurpose>Transfers a result set from the last query</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>mysqli_result</type><methodname>mysqli_store_result</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>mysqli_result</type><methodname>store_result</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + Transfers the result set from the last query on the database connection + represented by the <parameter>link</parameter> parameter to be used with + the <function>mysqli_data_seek</function> function. + </para> + <note> + <para> + Although it is always good practice to free the memory used by the result of + a query using the <function>mysqli_free_result</function> function, when + transfering large result sets using the <function>mysqli_store_result</function> + this becomes particularly important. + </para> + </note> + <note> + <para> + <function>mysqli_store_result</function> returns &false; in case the query + didn't return a result set (if the query was, for example an INSERT + statement). This function also returns &false; if the reading of the + result set failed. You can check if you have got an error by checking + if <function>mysqli_error</function> doesn't return an empty string, if + <function>mysqli_errno</function> returns a non zero value, or if + <function>mysqli_field_count</function> returns a non zero value. + Also possible reason for this function returning &false; after + successfull call to <function>mysqli_query</function> can be too large + result set (memory for it cannot be allocated). If + <function>mysqli_field_count</function> returns a non-zero value, the + statement should have produced a non-empty result set. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns a buffered result object or &false; if an error occurred. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_real_query</function>&listendand; + <function>mysqli_use_result</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <para> + See <function>mysqli_multi_query</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-thread-id.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-thread-id.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-thread-id.xml:1.8 phpdoc/en/reference/mysqli/functions/mysqli-thread-id.xml:1.9 --- phpdoc/en/reference/mysqli/functions/mysqli-thread-id.xml:1.8 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-thread-id.xml Sat Jan 27 17:37:36 2007 @@ -1,58 +1,58 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> - <refentry id="function.mysqli-thread-id"> - <refnamediv> - <refname>mysqli_thread_id</refname> - <refname>mysqli->thread_id</refname> - <refpurpose>Returns the thread ID for the current connection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_thread_id</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <fieldsynopsis><type>int</type><varname>thread_id</varname></fieldsynopsis> - </classsynopsis> - <para> - The <function>mysqli_thread_id</function> function returns the thread - ID for the current connection which can then be killed using the - <function>mysqli_kill</function> function. If the connection is lost - and you reconnect with <function>mysqli_ping</function>, the thread ID - will be other. Therefore you should get the thread ID only when you need it. - </para> - <note> - <para> - The thread ID is assigned on a connection-by-connection basis. Hence, - if the connection is broken and then re-established a new thread ID - will be assigned. - </para> - <para> - To kill a running query you can use the SQL command <literal>KILL QUERY processid</literal>. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - <function>mysqli_thread_id</function> returns the Thread ID for the current connection. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_kill</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.9 $ --> +<refentry id="function.mysqli-thread-id"> + <refnamediv> + <refname>mysqli_thread_id</refname> + <refname>mysqli->thread_id</refname> + <refpurpose>Returns the thread ID for the current connection</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_thread_id</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>int</type><varname>thread_id</varname></fieldsynopsis> + </classsynopsis> + <para> + The <function>mysqli_thread_id</function> function returns the thread + ID for the current connection which can then be killed using the + <function>mysqli_kill</function> function. If the connection is lost + and you reconnect with <function>mysqli_ping</function>, the thread ID + will be other. Therefore you should get the thread ID only when you need it. + </para> + <note> + <para> + The thread ID is assigned on a connection-by-connection basis. Hence, + if the connection is broken and then re-established a new thread ID + will be assigned. + </para> + <para> + To kill a running query you can use the SQL command <literal>KILL QUERY processid</literal>. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + <function>mysqli_thread_id</function> returns the Thread ID for the current connection. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_kill</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -79,11 +79,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -110,16 +110,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Error: MySQL server has gone away ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-thread-safe.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-thread-safe.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-thread-safe.xml:1.5 phpdoc/en/reference/mysqli/functions/mysqli-thread-safe.xml:1.6 --- phpdoc/en/reference/mysqli/functions/mysqli-thread-safe.xml:1.5 Sun Oct 31 16:05:14 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-thread-safe.xml Sat Jan 27 17:37:36 2007 @@ -1,29 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> - <refentry id="function.mysqli-thread-safe"> - <refnamediv> - <refname>mysqli_thread_safe</refname> - <refpurpose>Returns whether thread safety is given or not</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>bool</type><methodname>mysqli_thread_safe</methodname> - <void /> - </methodsynopsis> - <para> - <function>mysqli_thread_safe</function> indicates whether the - client library is compiled as thread-safe. - </para> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - &true; if the client library is thread-safe, otherwise &false;. - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<refentry id="function.mysqli-thread-safe"> + <refnamediv> + <refname>mysqli_thread_safe</refname> + <refpurpose>Returns whether thread safety is given or not</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>bool</type><methodname>mysqli_thread_safe</methodname> + <void /> + </methodsynopsis> + <para> + <function>mysqli_thread_safe</function> indicates whether the + client library is compiled as thread-safe. + </para> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + &true; if the client library is thread-safe, otherwise &false;. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-use-result.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-use-result.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-use-result.xml:1.12 phpdoc/en/reference/mysqli/functions/mysqli-use-result.xml:1.13 --- phpdoc/en/reference/mysqli/functions/mysqli-use-result.xml:1.12 Fri Jun 24 13:46:14 2005 +++ phpdoc/en/reference/mysqli/functions/mysqli-use-result.xml Sat Jan 27 17:37:36 2007 @@ -1,67 +1,67 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> - <refentry id="function.mysqli-use-result"> - <refnamediv> - <refname>mysqli_use_result</refname> - <refname>mysqli->use_result</refname> - <refpurpose>Initiate a result set retrieval</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>mysqli_result</type><methodname>mysqli_use_result</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (method):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <methodsynopsis> - <type>mysqli_result</type><methodname>use_result</methodname> - <void /> - </methodsynopsis> - </classsynopsis> - <para> - <function>mysqli_use_result</function> is used to initiate the retrieval - of a result set from the last query executed using the - <function>mysqli_real_query</function> function on the database connection - specified by the <parameter>link</parameter> parameter. Either this or the - <function>mysqli_store_result</function> function must be called before the - results of a query can be retrieved, and one or the other must be called - to prevent the next query on that database connection from failing. - </para> - <note> - <para> - The <function>mysqli_use_result</function> function does not transfer - the entire result set from the database and hence cannot be used functions - such as <function>mysqli_data_seek</function> to move to a particular - row within the set. To use this functionality, the result set must be - stored using <function>mysqli_store_result</function>. One should not - use <function>mysqli_use_result</function> if a lot of processing on - the client side is performed, since this will tie up the server and - prevent other threads from updating any tables from which the data is - being fetched. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Returns an unbuffered result object or &false; if an error occurred. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_real_query</function>&listendand; - <function>mysqli_store_result</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.13 $ --> +<refentry id="function.mysqli-use-result"> + <refnamediv> + <refname>mysqli_use_result</refname> + <refname>mysqli->use_result</refname> + <refpurpose>Initiate a result set retrieval</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>mysqli_result</type><methodname>mysqli_use_result</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (method):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <methodsynopsis> + <type>mysqli_result</type><methodname>use_result</methodname> + <void /> + </methodsynopsis> + </classsynopsis> + <para> + <function>mysqli_use_result</function> is used to initiate the retrieval + of a result set from the last query executed using the + <function>mysqli_real_query</function> function on the database connection + specified by the <parameter>link</parameter> parameter. Either this or the + <function>mysqli_store_result</function> function must be called before the + results of a query can be retrieved, and one or the other must be called + to prevent the next query on that database connection from failing. + </para> + <note> + <para> + The <function>mysqli_use_result</function> function does not transfer + the entire result set from the database and hence cannot be used functions + such as <function>mysqli_data_seek</function> to move to a particular + row within the set. To use this functionality, the result set must be + stored using <function>mysqli_store_result</function>. One should not + use <function>mysqli_use_result</function> if a lot of processing on + the client side is performed, since this will tie up the server and + prevent other threads from updating any tables from which the data is + being fetched. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Returns an unbuffered result object or &false; if an error occurred. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_real_query</function>&listendand; + <function>mysqli_store_result</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -96,11 +96,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -135,10 +135,10 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ my_user@localhost ----------------- @@ -148,9 +148,9 @@ Leiden Haarlemmermeer ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/mysqli/functions/mysqli-warning-count.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/mysqli/functions/mysqli-warning-count.xml diff -u phpdoc/en/reference/mysqli/functions/mysqli-warning-count.xml:1.7 phpdoc/en/reference/mysqli/functions/mysqli-warning-count.xml:1.8 --- phpdoc/en/reference/mysqli/functions/mysqli-warning-count.xml:1.7 Fri Nov 12 14:01:04 2004 +++ phpdoc/en/reference/mysqli/functions/mysqli-warning-count.xml Sat Jan 27 17:37:36 2007 @@ -1,54 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> - <refentry id="function.mysqli-warning-count"> - <refnamediv> - <refname>mysqli_warning_count</refname> - <refname>mysqli->warning_count</refname> - <refpurpose>Returns the number of warnings from the last query for the given link</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <para>Procedural style:</para> - <methodsynopsis> - <type>int</type><methodname>mysqli_warning_count</methodname> - <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> - </methodsynopsis> - <para>Object oriented style (property):</para> - <classsynopsis> - <ooclass><classname>mysqli</classname></ooclass> - <fieldsynopsis><type>int</type><varname>warning_count</varname></fieldsynopsis> - </classsynopsis> - <para> - <function>mysqli_warning_count</function> returns the number of warnings - from the last query in the connection represented by the - <parameter>link</parameter> parameter. - </para> - <note> - <para> - For retrieving warning messages you can use the SQL command - <literal>SHOW WARNINGS [limit row_count]</literal>. - </para> - </note> - </refsect1> - <refsect1> - &reftitle.returnvalues; - <para> - Number of warnings or zero if there are no warnings. - </para> - </refsect1> - <refsect1> - &reftitle.seealso; - <para> - <function>mysqli_errno</function>, - <function>mysqli_error</function>&listendand; - <function>mysqli_sqlstate</function>. - </para> - </refsect1> - <refsect1> - &reftitle.examples; - <example> - <title>Object oriented style</title> - <programlisting role="php"> +<!-- $Revision: 1.8 $ --> +<refentry id="function.mysqli-warning-count"> + <refnamediv> + <refname>mysqli_warning_count</refname> + <refname>mysqli->warning_count</refname> + <refpurpose>Returns the number of warnings from the last query for the given link</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <para>Procedural style:</para> + <methodsynopsis> + <type>int</type><methodname>mysqli_warning_count</methodname> + <methodparam><type>mysqli</type><parameter>link</parameter></methodparam> + </methodsynopsis> + <para>Object oriented style (property):</para> + <classsynopsis> + <ooclass><classname>mysqli</classname></ooclass> + <fieldsynopsis><type>int</type><varname>warning_count</varname></fieldsynopsis> + </classsynopsis> + <para> + <function>mysqli_warning_count</function> returns the number of warnings + from the last query in the connection represented by the + <parameter>link</parameter> parameter. + </para> + <note> + <para> + For retrieving warning messages you can use the SQL command + <literal>SHOW WARNINGS [limit row_count]</literal>. + </para> + </note> + </refsect1> + <refsect1> + &reftitle.returnvalues; + <para> + Number of warnings or zero if there are no warnings. + </para> + </refsect1> + <refsect1> + &reftitle.seealso; + <para> + <function>mysqli_errno</function>, + <function>mysqli_error</function>&listendand; + <function>mysqli_sqlstate</function>. + </para> + </refsect1> + <refsect1> + &reftitle.examples; + <example> + <title>Object oriented style</title> + <programlisting role="php"> <![CDATA[ <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); @@ -79,11 +79,11 @@ $mysqli->close(); ?> ]]> - </programlisting> - </example> - <example> - <title>Procedural style</title> - <programlisting role="php"> + </programlisting> + </example> + <example> + <title>Procedural style</title> + <programlisting role="php"> <![CDATA[ <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); @@ -114,16 +114,16 @@ mysqli_close($link); ?> ]]> - </programlisting> - </example> - &example.outputs; - <screen> + </programlisting> + </example> + &example.outputs; + <screen> <![CDATA[ Warning (1264): Data truncated for column 'Name' at row 1 ]]> - </screen> - </refsect1> - </refentry> + </screen> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: