# mysql_free_result

(PHP 4, PHP 5)

mysql_free_result — Libera la memoria del resultado

Advertencia

Esta extensión fue declarada obsoleta en PHP 5.5.0 y eliminada en PHP 7.0.0. En su lugar debería utilzarse las extensiones MySQLi o PDO_MySQL. Véase también la guía MySQL: elegir una API. Las alternativas a esta función son:

- mysqli_free_result()
- Asignar el valor de `null` al objeto PDO, o PDOStatement::closeCursor()

### Descripción

mysql_free_result(resource `$result`): bool

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.

### Parámetros

`result`

  El resultado resource que está siendo evaluado. Este resultado proviene de una llamada a mysql_query().

### Valores devueltos

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.

### Ejemplos

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'];
?>`

### Notas

> Nota:

> Por razones de compatibilidad con versiones anteriores, los siguientes alias obsoletos podrían usarse: mysql_freeresult()

### Ver también

- mysql_query() - Enviar una consulta MySQL
- is_resource() - Comprueba si una variable es un recurso