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");

$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
  • pg_result_memory_size() - Retorna a quantidade de memória alocada para um resultado de consulta

adicione uma nota

Notas Enviadas por Usuários (em inglês) 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