(PHP 4, PHP 5)
mysql_free_result — Gibt belegten Speicher wieder frei
mysql_free_result() gibt den Speicher frei, der mit der Ergebnis-Kennung assoziert ist.
Die Funktion muss nur dann aufgerufen werden, wenn Sie sich bei Anfragen, die große Ergebnismengen liefern, Sorgen über den Speicherverbrauch zur Laufzeit des PHP-Skripts machen. Nach Ablauf des Skripts wird der Speicher ohnehin freigegeben.
Gibt bei Erfolg TRUE zurück, im Fehlerfall FALSE.
Wird für den Parameter result ein Wert angegeben, der nicht vom Typ resource ist, wird ein Fehler der Stufe E_WARNING ausgegeben. Beachten Sie, dass mysql_query() nur eine resource für SELECT, SHOW, EXPLAIN und DESCRIBE Abfragen liefert.
Beispiel #1 Ein mysql_free_result() Beispiel
<?php
$result = mysql_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
echo 'Abfrage konnte nicht ausgeführt werden: ' . mysql_error();
exit;
}
/* Benutze result, unrer der Annahme wir sind hinterher damit fertig */
$row = mysql_fetch_assoc($result);
/* Nun geben wir den Speicher für result frei und fahren in unserem Skript fort */
mysql_free_result($result);
echo $row['id'];
echo $row['email'];
?>
Für Abwärtskompatibilität kann mysql_freeresult() verwendet werden. Diese Funktion ist jedoch veraltet.
Siehe auch mysql_query() und is_resource().