mysql_free_result
(PHP 4, PHP 5)
mysql_free_result — Gibt belegten Speicher wieder frei
Warnung
Diese Erweiterung ist seit PHP 5.5.0 als veraltet markiert und wurde in PHP 7.0.0 entfernt.
Verwenden Sie stattdessen die Erweiterungen MySQLi oder PDO_MySQL.
Weitere Informationen bietet der Ratgeber MySQL: Auswahl einer API.
Alternativen zu dieser Funktion umfassen:
Beschreibung
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.
Parameter-Liste
-
result
-
Das Ergebnis
Ressource, das ausgewertet wird. Dieses Ergebnis kommt von einem
Aufruf von
mysql_query().
Rückgabewerte
Gibt bei Erfolg true
zurück. Bei einem Fehler 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 Ressource für SELECT-, SHOW-, EXPLAIN- und DESCRIBE-Abfragen
zurückgibt.
Beispiele
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;
}
/* Verwende result, unter 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'];
?>
Anmerkungen
Hinweis:
Für die Abwärtskompatibiliät kann der
folgende veraltete Alias verwendet werden:
mysql_freeresult()