(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_free_result — Gibt den durch Ergebnisse belegten Speicher frei
pg_free_result() gibt den Speicher und die Daten, die mit der PgSql\Result-Instanz assoziiert sind, frei.
Die Funktion braucht nur aufgerufen zu werden, wenn man befürchten muss, dass während der Ausführung des Skripts zu viel Speicher verbraucht wird. Ansonsten wird der Speicherplatz, den Ergebnisse belegen, automatisch nach Beendigung des Skriptes freigegeben.
Hinweis:
Diese Funktion ersetzt die Funktion pg_freeresult().
resultEine PgSql\Result-Instanz, die von pg_query(), pg_query_params() oder pg_execute() (unter anderen) zurückgegeben wurde.
| Version | Beschreibung |
|---|---|
| 8.1.0 |
Der Parameter result erwartet nun eine PgSql\Result-Instanz;
vorher wurde eine Ressource erwartet.
|
Beispiel #1 pg_free_result()-Beispiel
<?php
$db = pg_connect("dbname=users user=me");
$res = pg_query($db, "SELECT 1 UNION ALL SELECT 2");
$val = pg_fetch_result($res, 1, 0);
echo "Das erste Feld in der zweiten Zeile enthält: ", $val, "\n";
pg_free_result($res);
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Das erste Feld in der zweiten Zeile enthält: 2
You do NOT need to call pg_free_result() on every result resource you create.
When result resources go out of scope, they are garbage collected just like everything else.
Unless you're hoarding your results somewhere, you can basically ignore this function.
Here's a little test you can run to confirm this: http://pastebin.com/ghw1PHuE