(PHP 4, PHP 5)
mysql_free_result — Libera la memoria del resultado
Esta extensión está obsoleta a partir de PHP 5.5.0, y será eliminada en el futuro. En su lugar, deberían usarse las extensiones MySQLi o PDO_MySQL. Véase también la guía MySQL: elegir una API y P+F relacionadas para más información. Las alternativas a esta función incluyen:
NULL
al objeto PDO, o PDOStatement::closeCursor()$result
)
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
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada a mysql_query().
Devuelve TRUE
en caso de éxito o FALSE
en caso de 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 con versiones anteriores, los siguientes alias obsoletos podrían usarse: mysql_freeresult()