(PHP 4, PHP 5)
mysql_free_result — Gibt belegten Speicher wieder frei
Diese Erweiterung ist seit PHP 5.5.0 als veraltet markiert und wurde in PHP 7.0.0 entfernt werden. Verwenden Sie stattdessen die Erweiterungen MySQLi oder PDO_MySQL. Weitere Informationen finden Sie im Ratgeber MySQL: Auswahl einer API und den zugehörigen FAQ. Alternativen zu dieser Funktion umfassen:
NULL
dem PDO-Objekt zuweisen oder PDOStatement::closeCursor()$result
)
mysql_free_result() gibt den Speicher frei, der mit
result
(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.
Ergebnis
Das Ergebnis Ressource, das ausgewertet wird. Dieses Ergebnis kommt von einem Aufruf von mysql_query().
Gibt bei Erfolg TRUE
zurück. Im Fehlerfall wird FALSE
zurückgegeben.
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'];
?>
Hinweis:
Für die Abwärtskompatibiliät kann der folgende veraltete Alias verwendet werden: mysql_freeresult()