mysql_free_result
(PHP 4, PHP 5)
mysql_free_result — 释放结果内存
说明
bool <strong>mysql_free_result</strong>
( resource <code>$result</code>
)
<p>
<strong>mysql_free_result()</strong> 将释放所有与结果标识符
<code>result</code> 所关联的内存。
</p>
<p>
<strong>mysql_free_result()</strong>
仅需要在考虑到返回很大的结果集时会占用多少内存时调用。在脚本结束后所有关联的内存都会被自动释放。
</p>
<p>
成功时返回 <strong><code>TRUE</code></strong>, 或者在失败时返回 <strong><code>FALSE</code></strong>。
</p>
<p>
为向下兼容仍然可以使用
<strong>mysql_freeresult()</strong>,但反对这样做。
</p>
参数
result
resource 型的结果集。此结果集来自对 mysql_query() 的调用。
返回值
成功时返回 TRUE
, 或者在失败时返回 FALSE
。
If a non-resource is used for the result
, an
error of level E_WARNING will be emitted. It's worth noting that
mysql_query() only returns a resource
for SELECT, SHOW, EXPLAIN, and DESCRIBE queries.
范例
Example #1 A mysql_free_result() example
<?php
$result = mysql_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
echo 'Could not run query: ' . mysql_error();
exit;
}
/* Use the result, assuming we're done with it afterwards */
$row = mysql_fetch_assoc($result);
/* Now we free up the result and continue on with our script */
mysql_free_result($result);
echo $row['id'];
echo $row['email'];
?>
注释
Note:
为了向下兼容,可以使用下列已废弃的别名: mysql_freeresult()
参见
mysql_query() - 发送一条 MySQL 查询 is_resource() - 检测变量是否为资源类型