php-doc-en/reference/mssql/functions/mssql-next-result.xml
Kalle Sommer Nielsen 8270283d6b News
* Added missing <literal> on setup note
* Added a reference to PDO_DBLIB and PDO_ODBC on setup note
* Added a source comment on mssql_connect() explaining how to use a connect with a custom port
* Added undocumented ini setting mssql.charset (available as of PHP 5.1.2)
* Added missing parameter descriptions on mssql_guid_string
* Added missing examples for
 * mssql_data_seek (Ross)
 * mssql_execute
 * mssql_fetch_array
 * mssql_fetch_assoc
 * mssql_fetch_field
 * mssql_fetch_object
 * mssql_fetch_row (RMLR)
 * mssql_field_length
 * mssql_field_name
 * mssql_field_seek
 * mssql_field_type
 * mssql_free_result
 * mssql_free_statement
 * mssql_get_last_message
 * mssql_guid_string
 * mssql_init
 * mssql_min_error_severity
 * mssql_min_message_severity
 * mssql_num_fields
 * mssql_pconnect (RMLR)
 * mssql_result
* Added constant descriptions
* Documented the following functions
 * mssql_get_last_message
 * mssql_min_error_severity
 * mssql_min_message_severity
* Changed examples on the following
 * mssql_bind
 * mssql_fetch_batch
 * mssql_next_result
 * mssql_query
* Fixed example on mssql_rows_affected


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@267081 c90b9560-bf6c-de11-be94-00142212c4b1
2008-10-08 18:29:23 +00:00

107 lines
2.6 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<refentry xml:id="function.mssql-next-result" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mssql_next_result</refname>
<refpurpose>Move the internal result pointer to the next result</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>mssql_next_result</methodname>
<methodparam><type>resource</type><parameter>result_id</parameter></methodparam>
</methodsynopsis>
<para>
When sending more than one SQL statement to the server or
executing a stored procedure with multiple results, it will cause
the server to return multiple result sets. This function will
test for additional results available form the server. If an
additional result set exists it will free the existing result set
and prepare to fetch the rows from the new result set.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>result_id</parameter></term>
<listitem>
<para>
The result resource that is being evaluated. This result comes from a
call to <function>mssql_query</function>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns &true; if an additional result set was available or &false;
otherwise.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mssql_next_result</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
// Connect MSSQL
$link = mssql_connect('MANGO\SQLEXPRESS', 'sa', 'phpfi');
mssql_select_db('php', $link);
// Send a query to MSSQL
$sql = 'SELECT [name], [age] FROM [php].[dbo].[persons]';
$query = mssql_query($sql, $link);
// Iterate through returned records
do
{
while($row = mssql_fetch_row($query))
{
// Handle record ...
}
}
while(mssql_next_result($query));
// Clean up
mssql_free_result($query);
mssql_close($link);
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->