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.

Note:

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

Example #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