(PHP 4, PHP 5)
mysql_free_result — Libera memória usada pelo resultado
Esta extensão foi descontinuada a partir do PHP 5.5.0 e foi removida no PHP 7.0.0. Em vez disso, as extensões MySQLi ou PDO_MySQL devem ser usadas. Veja também o guia MySQL: escolhendo uma API. Alternativas a esta função incluem:
null to the PDO object, or PDOStatement::closeCursor()
mysql_free_result() liberará toda a memória
associada ao identificador de resultado result.
mysql_free_result() apenas precisa ser chamada se houver preocupação sobre a quantidade de memória usada em consultas que retornam grandes conjuntos de resultados. Toda a memória associada ao resultado é liberada automaticamente no final da execução do script.
resultO resource do resultado que está sendo avaliado. Este resultado vem de uma chamada a mysql_query().
Retorna true em caso de sucesso ou false em caso de falha.
Se for usado algo que não seja um recurso para o parâmetro result, um
erro de nível E_WARNING será emitido. É importante observar que
mysql_query() somente retorna um resource
para consultas SELECT, SHOW, EXPLAIN e DESCRIBE.
Exemplo #1 Um exemplo de mysql_free_result()
<?php
$result = mysql_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
echo 'Não foi possível executar a consulta: ' . mysql_error();
exit;
}
/* Usa o resultado assumindo que não vamos precisar mais dele depois */
$row = mysql_fetch_assoc($result);
/* Agora a memória do resultado é liberada e a execução do script continua */
mysql_free_result($result);
echo $row['id'];
echo $row['email'];
?>Nota:
Para compatibilidade com versões anteriores, o seguinte apelido descontinuado pode ser usado: mysql_freeresult()