PHP Doku:: Gibt den durch ein Abfrageergebnis belegten Speicher wieder frei - function.odbc-free-result.html

Verlauf / Chronik / History: (1) anzeigen

Sie sind hier:
Doku-StartseitePHP-HandbuchFunktionsreferenzDatenbankerweiterungenAbstraktionsebenenODBC (Unified)ODBC Funktionenodbc_free_result

Ein Service von Reinhard Neidl - Webprogrammierung.

ODBC Funktionen

<<odbc_foreignkeys

odbc_gettypeinfo>>

odbc_free_result

(PHP 4, PHP 5)

odbc_free_result Gibt den durch ein Abfrageergebnis belegten Speicher wieder frei

Beschreibung

int odbc_free_result ( int $result_id )

Gibt immer TRUE zurück.

odbc_free_result() braucht nur aufgerufen zu werden, wenn Sie einen zu hohen Speicherverbrauch durch das aktuell laufende Skript vermeiden wollen. Das gesamte Abfrageergebnis wird automatisch nach Beendigung des Skriptes gelöscht. Aber wenn Sie sicher sind, dass Sie dieses Ergebnis nicht länger benötigen, dann können Sie bei Speicherproblemen die Funktion odbc_free_result() benutzen.

Hinweis: Wenn autocommit deaktiviert ist (siehe odbc_autocommit()) und Sie odbc_free_result() bevor ein Commit gemacht wird, werden alle austehenden Transaktionen zurückgenommen.


4 BenutzerBeiträge:
- Beiträge aktualisieren...
lm At bible in switzerland
25.11.2010 9:13
I use WinDev 15.0 HyperFileSQL ODBC Connector on Windows, PHP 5.2.3.
With this configuration, any result ressource obtained with odbc_exec must be freed by odbc_free_result before the next query by odbc_exec.
If the result ressource is not freed odbc_exec will return a corrupt result ressource.
example:
odbc_exec($query1);
odbc_exec($query2);
odbc_result_all();

Output: A table with empty cells
EMY
3.02.2009 17:45
It seems it is common sense to say it is a god practice to free any resource when it isn´t necessary anymore.
Also, when talking about releasing the resources associated with a given result set it is a common sense to say never release a result set before it is assured to have been either commited or rolled back.
Then, the following code sequence should be the most adequate (assuming auto-commit is disabled):

odbc_commit(...);
odbc_free_result(...);
...
odbc_close(...);
rich at kastle dot com
20.12.2004 12:48
("Note:  If auto-commit is disabled (see odbc_autocommit()) and you call odbc_free_result() before committing, all pending transactions are rolled back.")

I've looked thru the code, and that note is definitely wrong, at least in my environment (Windows/SQL Server).  odbc_free_result ultimately just calls SQLFreeStmt which has NO EFFECT on outstanding transactions.

In fact, it seems it must be wrong for all environments, because the SQLFreeStmt is bound to the destruction of the result resource.  So unset($result) would be just as dangerous - and you're randomly and unpredictably screwed if garbage collection reaps the result set before your transaction's done.
rogersd at island dot net
6.09.2001 5:03
odbc_free_result() is also the way to avoid the dreaded "Too many open cursor" error.



PHP Powered Diese Seite bei php.net
The PHP manual text and comments are covered by the Creative Commons Attribution 3.0 License © the PHP Documentation Group - Impressum - mail("TO:Reinhard Neidl",...)