uTools-Manuals/docs/php/mssql_fetch_object.html
2019-04-08 23:22:26 +08:00

124 lines
7.6 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.mssql-fetch-object" class="refentry">
<div class="refnamediv">
<h1 class="refname">mssql_fetch_object</h1>
<p class="verinfo">(PHP 4, PHP 5, PECL odbtp &gt;= 1.1.1)</p><p class="refpurpose"><span class="refname">mssql_fetch_object</span> &mdash; <span class="dc-title">Fetch row as object</span></p>
</div>
<div id="function.mssql-fetch-object-refsynopsisdiv">
<div class="warning"><strong class="warning">Warning</strong>
<p class="para">
This function was <em class="emphasis">REMOVED</em> in PHP 7.0.0.
</p>
<p class="para">
Alternatives to this function include:
</p>
<ul class="simplelist">
<li class="member"><span class="function"><a href="pdostatement.fetchobject.html" class="function">PDOStatement::fetchObject()</a></span></li>
<li class="member"><span class="function"><a href="sqlsrv_fetch_object.html" class="function">sqlsrv_fetch_object()</a></span></li>
<li class="member"><span class="function"><a href="odbc_fetch_object.html" class="function">odbc_fetch_object()</a></span></li>
</ul>
</div>
</div>
<div class="refsect1 description" id="refsect1-function.mssql-fetch-object-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>mssql_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>mssql_fetch_object()</strong></span> is similar to
<span class="function"><a href="mssql_fetch_array.html" class="function">mssql_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="mssql_fetch_array.html" class="function">mssql_fetch_array()</a></span>, and almost as quick as
<span class="function"><a href="mssql_fetch_row.html" class="function">mssql_fetch_row()</a></span> (the difference is
insignificant).
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.mssql-fetch-object-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">result</code></dt>
<dd>
<p class="para">
The result resource that is being evaluated. This result comes from a
call to <span class="function"><a href="mssql_query.html" class="function">mssql_query()</a></span>.
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.mssql-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.mssql-fetch-object-examples">
<h3 class="title">范例</h3>
<p class="para">
<div class="example" id="example-1755">
<p><strong>Example #1 <span class="function"><strong>mssql_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 /></span><span style="color: #FF8000">//&nbsp;Send&nbsp;a&nbsp;select&nbsp;query&nbsp;to&nbsp;MSSQL<br /></span><span style="color: #0000BB">$query&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">mssql_query</span><span style="color: #007700">(</span><span style="color: #DD0000">'SELECT&nbsp;[username],&nbsp;[name]&nbsp;FROM&nbsp;[php].[dbo].[userlist]'</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;Check&nbsp;if&nbsp;there&nbsp;were&nbsp;any&nbsp;records<br /></span><span style="color: #007700">if&nbsp;(!</span><span style="color: #0000BB">mssql_num_rows</span><span style="color: #007700">(</span><span style="color: #0000BB">$query</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'No&nbsp;records&nbsp;found'</span><span style="color: #007700">;<br />}&nbsp;else&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #FF8000">//&nbsp;Print&nbsp;a&nbsp;nice&nbsp;list&nbsp;of&nbsp;users&nbsp;in&nbsp;the&nbsp;format&nbsp;of:<br />&nbsp;&nbsp;&nbsp;&nbsp;//&nbsp;*&nbsp;name&nbsp;(username)<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #007700">echo&nbsp;</span><span style="color: #DD0000">'&lt;ul&gt;'</span><span style="color: #007700">;<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;while&nbsp;(</span><span style="color: #0000BB">$row&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">mssql_fetch_object</span><span style="color: #007700">(</span><span style="color: #0000BB">$query</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'&lt;li&gt;'&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">'&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">username&nbsp;</span><span style="color: #007700">.&nbsp;</span><span style="color: #DD0000">')&lt;/li&gt;'</span><span style="color: #007700">;<br />&nbsp;&nbsp;&nbsp;&nbsp;}<br /><br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">'&lt;/ul&gt;'</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #FF8000">//&nbsp;Free&nbsp;the&nbsp;query&nbsp;result<br /></span><span style="color: #0000BB">mssql_free_result</span><span style="color: #007700">(</span><span style="color: #0000BB">$query</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 notes" id="refsect1-function.mssql-fetch-object-notes">
<h3 class="title">注释</h3>
<blockquote class="note"><p><strong class="note">Note</strong>: <span class="simpara">此函数返回的字段名<em class="emphasis">大小写敏感</em></span></p></blockquote>
<blockquote class="note"><p><strong class="note">Note</strong>: <span class="simpara">此函数将 NULL 字段设置为 PHP <strong><code>NULL</code></strong> 值。</span></p></blockquote>
</div>
<div class="refsect1 seealso" id="refsect1-function.mssql-fetch-object-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="mssql_fetch_array.html" class="function" rel="rdfs-seeAlso">mssql_fetch_array()</a> - Fetch a result row as an associative array, a numeric array, or both</span></li>
<li class="member"><span class="function"><a href="mssql_fetch_row.html" class="function" rel="rdfs-seeAlso">mssql_fetch_row()</a> - Get row as enumerated array</span></li>
</ul>
</p>
</div>
</div></div></div></body></html>