mysql_free_result

(PHP 3, PHP 4 , PHP 5)

mysql_free_result -- Efface le résultat de la mémoire

Description

bool mysql_free_result ( resource 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.

Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.

Si la valeur passée à l'argument result n'est pas une ressource, une erreur de degrès 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.

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

Pour des raisons de compatibilité ascendante, mysql_freeresult() peut encore être utilisée.

Voir aussi mysql_query() et is_resource().