uTools-Manuals/docs/php/msql_fetch_object.html
2019-04-28 19:00:34 +08:00

120 lines
7.5 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Fetch row as object</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.msql-fetch-object" class="refentry">
<div class="refnamediv">
<h1 class="refname">msql_fetch_object</h1>
<p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">msql_fetch_object</span> &mdash; <span class="dc-title">Fetch row as object</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.msql-fetch-object-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>msql_fetch_object</strong></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$result</code></span>
) : <span class="type">object</span></div>
<p class="para rdfs-comment">
<span class="function"><strong>msql_fetch_object()</strong></span> is similar to
<span class="function"><a href="msql_fetch_array.html" class="function">msql_fetch_array()</a></span>, with one difference - an
object is returned, instead of an array. Indirectly, that means
that you can only access the data by the field names, and not by
their offsets (numbers are illegal property names).
</p>
<p class="para">
Speed-wise, the function is identical to
<span class="function"><a href="msql_fetch_array.html" class="function">msql_fetch_array()</a></span>, and almost as quick as
<span class="function"><a href="msql_fetch_row.html" class="function">msql_fetch_row()</a></span> (the difference is
insignificant).
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.msql-fetch-object-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">
result</code></dt>
<dd>
<p class="para"><span class="type"><a href="language.types.resource.html" class="type resource">resource</a></span>
型的结果集。此结果集来自对 <span class="function"><a href="msql_query.html" class="function">msql_query()</a></span>
的调用。</p></dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.msql-fetch-object-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
Returns an object with properties that correspond to the fetched
row, or <strong><code>FALSE</code></strong> if there are no more rows.
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.msql-fetch-object-examples">
<h3 class="title">范例</h3>
<p class="para">
<div class="example" id="example-1743">
<p><strong>Example #1 <span class="function"><strong>msql_fetch_object()</strong></span> example</strong></p>
<div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$con&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">msql_connect</span><span style="color: #007700">();<br />if&nbsp;(!</span><span style="color: #0000BB">$con</span><span style="color: #007700">)&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;die(</span><span style="color: #DD0000">'Server&nbsp;connection&nbsp;problem:&nbsp;'&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">msql_error</span><span style="color: #007700">());<br />}<br /><br />if&nbsp;(!</span><span style="color: #0000BB">msql_select_db</span><span style="color: #007700">(</span><span style="color: #DD0000">'test'</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$con</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;die(</span><span style="color: #DD0000">'Database&nbsp;connection&nbsp;problem:&nbsp;'&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">msql_error</span><span style="color: #007700">());<br />}<br /><br /></span><span style="color: #0000BB">$result&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">msql_query</span><span style="color: #007700">(</span><span style="color: #DD0000">'SELECT&nbsp;id,&nbsp;name&nbsp;FROM&nbsp;people'</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$con</span><span style="color: #007700">);<br />if&nbsp;(!</span><span style="color: #0000BB">$result</span><span style="color: #007700">)&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;die(</span><span style="color: #DD0000">'Query&nbsp;execution&nbsp;problem:&nbsp;'&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">msql_error</span><span style="color: #007700">());<br />}<br /><br />while&nbsp;(</span><span style="color: #0000BB">$row&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">msql_fetch_object</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">MSQL_ASSOC</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #0000BB">$row</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">id&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #DD0000">':&nbsp;'&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #0000BB">$row</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">name&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">msql_free_result</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 changelog" id="refsect1-function.msql-fetch-object-changelog">
<h3 class="title">更新日志</h3>
<p class="para">
<table class="doctable informaltable">
<thead>
<tr>
<th>版本</th>
<th>说明</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td>5.0.4 </td>
<td>
A bug was fixed when retrieving data from columns containing <strong><code>NULL</code></strong>
values. Such columns were not placed into the resulting array.
</td>
</tr>
</tbody>
</table>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.msql-fetch-object-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="msql_fetch_array.html" class="function" rel="rdfs-seeAlso">msql_fetch_array()</a> - Fetch row as array</span></li>
<li class="member"><span class="function"><a href="msql_fetch_row.html" class="function" rel="rdfs-seeAlso">msql_fetch_row()</a> - Get row as enumerated array</span></li>
<li class="member"><span class="function"><a href="msql_data_seek.html" class="function" rel="rdfs-seeAlso">msql_data_seek()</a> - Move internal row pointer</span></li>
<li class="member"><span class="function"><a href="msql_result.html" class="function" rel="rdfs-seeAlso">msql_result()</a> - Get result data</span></li>
</ul>
</p>
</div>
</div></div></div></body></html>