pg_free_result

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

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

Описание

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

down

Stefan W ¶

11 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

＋Добавить