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 finden
Sie im Ratgeber
MySQL: Auswahl einer API.
Alternativen zu dieser Funktion umfassen:
Beschreibung
mysql_free_result
( resource $result
) : bool
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
-
Ergebnis
-
Das Ergebnis
Ressource, das ausgewertet wird. Dieses Ergebnis kommt von einem
Aufruf von
mysql_query().
Rückgabewerte
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 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()