mysql_free_result
(PHP 4, PHP 5)
mysql_free_result — Libère le résultat de la mémoire
Cette extension est obsolète depuis PHP 5.5.0, et sera supprimée dans le futur. À la place, les extensions MySQLi ou PDO_MySQL doivent être utilisées. Voir aussi le guide MySQL : choix de l'API ainsi que la FAQ associée pour plus d'information. Voici les alternatives à cette fonction :
- mysqli_free_result()
- Assignez la valeur
NULL
à l'objet PDO, ou PDOStatement::closeCursor()
Description
$result
)
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