pg_free_result

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

    pg_free_result — Очищает результат запроса и освобождает память

    Описание

    function pg_free_result(PgSql\Result $result): bool

    Функция pg_free_result() освобождает память, которую занимает экземпляр класса PgSql\Result.

    Функцию вызывают, только если при выполнении скрипта недостаточно памяти. Память так или иначе освободится автоматически, когда скрипт завершит работу.

    Замечание:

    Раньше функция называлась pg_freeresult().

    Список параметров

    result
    Экземпляр класса PgSql\Result, который возвращают функции pg_query(), pg_query_params() или pg_execute() (среди прочего).

    Возвращаемые значения

    Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

    Список изменений

    Версия Описание
    8.1.0 Параметр result теперь принимает объект PgSql\Result; раньше параметр принимал тип resource.

    Примеры

    Пример #1 Пример очистки результата запроса и освобождения памяти функцией pg_free_result()

    <?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 "Первое поле во второй строчке: ", $val, "\n";

pg_free_result($res);

?>

    Результат выполнения приведённого примера: 

    Первое поле во второй строчке: 2

    Смотрите также

    • pg_query() - Выполняет запрос
    • pg_query_params() - Посылает параметризованный запрос на сервер, параметры передаются отдельно от текста SQL запроса
    • pg_execute() - Запускает выполнение ранее подготовленного параметризованного запроса и ждёт результат
    • pg_result_memory_size() - Возвращает объём памяти, выделенный для результата запроса

    Нашли ошибку?

    Инструкция • Исправление • Сообщение об ошибке
    ＋Добавить

    Примечания пользователей 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
    ＋Добавить
    To Top