PHP 8.4.0 RC4 available for testing

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

up
2
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
To Top