Libère le résultat de la mémoire

# mysql_free_result

(PHP 4, PHP 5)

mysql_free_result — Libère le résultat de la mémoire

Avertissement

Cette extension était obsolète en PHP 5.5.0, et a été supprimée en PHP 7.0.0. À la place, vous pouvez utiliser l'extension MySQLi ou l'extension PDO_MySQL. Voir aussi MySQL : choisir une API du guide et ces entrées de la FAQ pour plus d'informations. Alternatives à cette fonction :

- mysqli_free_result()
- Assignez la valeur `NULL` à l'objet PDO, ou PDOStatement::closeCursor()

### Description

mysql_free_result ( resource `$result` ) : bool

mysql_free_result() libère toute la mémoire et les ressources utilisées par la ressource de résultat `result`.

mysql_free_result() n'est à appeler que si vous avez peur d'utiliser trop de mémoire durant l'exécution de votre script. Toute la mémoire associée à l'identifiant de résultat sera automatiquement libérée.

### Liste de paramètres

`result`

  La ressource de résultat qui vient d'être évaluée. Ce résultat vient de l'appel à la fonction mysql_query().

### Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès ou `FALSE` si une erreur survient.

Si la valeur passée à l'argument `result` n'est pas une ressource, une erreur de niveau E_WARNING sera émise. Il est important de noter que la fonction mysql_query() retourne uniquement une ressource pour les requêtes SELECT, SHOW, EXPLAIN et DESCRIBE.

### Exemples

Exemple #1 Exemple avec mysql_free_result()

`<?php
$result = mysql_query("SELECT id,email FROM people WHERE id = '42'");
if (!$result) {
echo 'Impossible d\'exécuter la requête : ' . mysql_error();
exit;
}
/* Utilisation du résultat */
$row = mysql_fetch_assoc($result);
/* Maintenant, nous libérons le résultat et continuons notre script */
mysql_free_result($result);
echo $row['id'];
echo $row['email'];
?>`

### Notes

> Note:

> Pour des raisons de compatibilité ascendante, l'alias obsolète suivant peut être utilisé : mysql_freeresult()

### Voir aussi

- mysql_query() - Envoie une requête à un serveur MySQL
- is_resource() - Détermine si une variable est une ressource