Libera memória usada pelo resultado

# mysql_free_result

(PHP 4, PHP 5)

mysql_free_result — Libera memória usada pelo resultado

Aviso

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:

- mysqli_free_result()
- Atribuir o valor `null` ao objeto PDO ou PDOStatement::closeCursor()

### Descrição

function mysql_free_result(resource `$result`): bool

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.

### Parâmetros

`result`
  O resource do resultado que está sendo avaliado. Este resultado vem de uma chamada a mysql_query().

### Valor Retornado

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.

### Exemplos

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

### Notas

> Nota: Para compatibilidade com versões anteriores, o seguinte apelido descontinuado pode ser usado: mysql_freeresult()

### Veja Também

- mysql_query() - Envia uma consulta MySQL
- is_resource() - Verifica se uma variável é um recurso

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