CascadiaPHP 2024

pg_free_result

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

pg_free_resultLibera memória de resultados

Descrição

pg_free_result(PgSql\Result $result): bool

pg_free_result() libera a memória e os dados associados à instância PgSql\Result especificada.

Esta função só precisa ser chamada se o consumo de memória durante a execução do script for um problema. Caso contrário, toda a memória de resultados será liberada automaticamente quando o script terminar.

Nota:

Esta função costumava ser chamada de pg_freeresult().

Parâmetros

result

Uma instância de PgSql\Result, retornada por pg_query(), pg_query_params() ou pg_execute() (entre outras).

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro result agora espera uma instância de PgSql\Result; anteriormente, um resource era esperado.

Exemplos

Exemplo #1 Exemplo de pg_free_result()

<?php
$db
= pg_connect("dbname=users user=me") || die();

$res = pg_query($db, "SELECT 1 UNION ALL SELECT 2");

$val = pg_fetch_result($res, 1, 0);

echo
"O primeiro campo da segunda linha é: ", $val, "\n";

pg_free_result($res);
?>

O exemplo acima produzirá:

O primeiro campo da segunda linha é: 2

Veja Também

  • pg_query() - Executa uma consulta
  • pg_query_params() - Envia um comando ao servidor e aguarda o resultado, com a capacidade de passar parâmetros separadamente do texto do comando SQL
  • pg_execute() - Envia uma solicitação para executar uma instrução preparada com determinados parâmetros e aguarda o resultado

add a note

User Contributed Notes 1 note

up
2
Stefan W
10 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