トップページ　→関数リファレンス　→データベース関連　→ベンダー固有のモジュール　→MySQL　→MySQL (最初の API)

関数・クラス解説

mysql_free_result

version:PHP 4, PHP 5 (公式)

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

公式リファレンス

書式

mysql_free_result ( resource $result ) : bool

説明

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

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

パラメータ

result: 評価された結果リソース。この結果は、mysql_query() のコールにより得られたものです。

返値

成功した場合に TRUE を、失敗した場合に FALSE を返します。 result がリソースではなかった場合、 E_WARNING レベルのエラーが発生します。 mysql_query() が resource を返すのは SELECT, SHOW, EXPLAIN, そして DESCRIBE の場合だけであることに注意しましょう。

注意

注意: 下位互換のために、次の非推奨別名を使用してもいいでしょう。 mysql_freeresult()

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

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

サンプル

例1 mysql_free_result() の例 

$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'];