Libera la memoria del resultado

# mysql_free_result

(PHP 4, PHP 5)

mysql_free_result — Libera la memoria del resultado

Advertencia

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:

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

### Descripción

function 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`
  La resource de resultado que acaba de ser evaluada. Este resultado proviene de la llamada a la función mysql_query().

### Valores devueltos

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.

### 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 ascendente, el siguiente alias obsoleto puede ser utilizado: mysql_freeresult()

### Ver también

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open