(PHP 4, PHP 5)
mysql_free_result — Libera la memoria del resultado
Esta extensión estaba obsoleta en PHP 5.5.0, y fue eliminada en PHP 7.0.0. En su lugar, se puede utilizar la extensión MySQLi o la extensión PDO_MySQL. Ver también MySQL: elegir una API de la guía. Alternativas a esta función:
null
al objeto PDO, o PDOStatement::closeCursor()
mysql_free_result() liberará toda la memoria
asociada con el identificador del resultado result
.
mysql_free_result() solo necesita ser llamado si se está preocupado por la cantidad de memoria que está siendo usada por las consultas que devuelven conjuntos de resultados grandes. Toda la memoria de resultados asociada se liberará automaticamente al finalizar la ejecución del script.
result
La resource de resultado que acaba de ser evaluada. Este resultado proviene de la llamada a la función mysql_query().
Esta función retorna true
en caso de éxito o false
si ocurre un error.
Si se utiliza un recurso no válido para result
,
se emitirá un error de nivel E_WARNING. Vale la pena señalar que
mysql_query() solo devuelve un recurso
para las consultas SELECT, SHOW, EXPLAIN, y DESCRIBE.
Ejemplo #1 Un ejemplo de mysql_free_result()
<?php
$resultado = mysql_query("SELECT id, email FROM people WHERE id = '42'");
if (!$resultado) {
echo 'No se pudo ejecutar la consulta: ' . mysql_error();
exit;
}
/* Usamos el resultado, asumiendo que, acto seguido, hemos terminado con él */
$fila = mysql_fetch_assoc($resultado);
/* Ahora liberamos el resultado y continuamos con nuestro script */
mysql_free_result($resultado);
echo $fila['id'];
echo $fila['email'];
?>
Nota:
Por razones de compatibilidad ascendente, el siguiente alias obsoleto puede ser utilizado : mysql_freeresult()