pg_free_result

    (PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

    pg_free_result — Gibt den durch Ergebnisse belegten Speicher frei

    Beschreibung

    function pg_free_result(PgSql\Result $result): bool

    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().

    Parameter-Liste

    result

    Eine PgSql\Result-Instanz, die von pg_query(), pg_query_params() oder pg_execute() (unter anderen) zurückgegeben wurde.

    Rückgabewerte

    Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

    Changelog

    Version Beschreibung
    8.1.0 Der Parameter result erwartet nun eine PgSql\Result-Instanz; vorher wurde eine Ressource erwartet.

    Beispiele

    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

    Siehe auch

    • pg_query() - Führt eine Abfrage aus
    • pg_query_params() - Sendet ein Kommando zum Server und wartet seine Ausführung ab. Getrennt vom SQL-Kommando können dabei Parameter übergeben werden
    • pg_execute() - Fordert den Datenankserver auf, eine vorbereitete Anfrage mit den angegebenen Parametern auszuführen und wartet auf das Ergebnis
    • pg_result_memory_size() - Returns the amount of memory allocated for a query result

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    2
    Stefan W
    12 years ago
    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
    ＋add a note
    To Top