mysql_free_result
結果保持用メモリを開放する
警告
この拡張モジュールは PHP 5.5.0 で非推奨になり、PHP 7.0.0 で削除されました。
MySQLi あるいは
PDO_MySQL を使うべきです。詳細な情報は
MySQL: API の選択 を参照ください。
この関数の代替として、これらが使えます。
- mysqli_free_result
null を PDO オブジェクトに代入、あるいは PDOStatement::closeCursor
説明
bool mysql_free_result(resource $result)
mysql_free_result は、
スクリプト実行のメモリの使用量が多すぎると懸念される場合にのみ
必要になります。指定した結果 ID に関する全ての結果保持用メモリは、
スクリプトの実行後に自動的に開放されます。
パラメータ
-
result
-
評価された結果 リソース。この結果は、mysql_query のコールにより得られたものです。
戻り値
成功した場合に true を、失敗した場合に false を返します。
result がリソースではなかった場合、
E_WARNING レベルのエラーが発生します。
mysql_query が resource
を返すのは SELECT, SHOW, EXPLAIN, そして DESCRIBE
の場合だけであることに注意しましょう。
例
例1 mysql_free_result の例
<?php
$result = mysql_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
echo 'Could not run query: ' . mysql_error();
exit;
}
/* 結果を利用する。ここでは、その後結果を利用したものと仮定する */
$row = mysql_fetch_assoc($result);
/* 結果を開放し、さらにスクリプトの処理を進める */
mysql_free_result($result);
echo $row['id'];
echo $row['email'];
?>
注意
注意:
下位互換のために、次の非推奨別名を使用してもいいでしょう。
mysql_freeresult