mysql_free_result

(PHP 4, PHP 5)

mysql_free_result — 結果保持用メモリを開放する

警告

この拡張モジュールは PHP 5.5.0 で非推奨になり、PHP 7.0.0 で削除されました。 MySQLi あるいは PDO_MySQL を使うべきです。詳細な情報は MySQL: API の選択を参照ください。この関数の代替として、これらが使えます。

mysqli_free_result()
null を PDO オブジェクトに代入、あるいは PDOStatement::closeCursor()

説明

mysql_free_result(resource $result): bool

mysql_free_result() は、結果 ID result に関するすべてのメモリを開放します。

mysql_free_result() は、スクリプト実行のメモリの使用量が多すぎると懸念される場合にのみ必要になります。指定した結果 ID に関する全ての結果保持用メモリは、スクリプトの実行後に自動的に開放されます。

パラメータ

result: 評価された結果を示す resource。この結果は、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()

参考

mysql_query() - MySQL クエリを送信する
is_resource() - 変数がリソースかどうかを調べる