wb_close


boolean wb_close( resource connection )
boolean wb_close( resource odbc_connection )
boolean wb_close( resource cursor )
boolean wb_close( resource lob )
boolean wb_close( resource psql )
Parametry
-
connection
- Identifikátor spojení získaným voláním wb_connect.
-
odbc_connection
- Identifikátor spojení získaným voláním wb_odbc_connect.
-
cursor
- Identifikátor kurzoru získaný předchozím voláním wb_exec.
-
lob
- Identifikátor LOBu získaný předchozím voláním wb_result, resp. wb_fetch_into v módu čtení LOBů WB_LOBMODE_RESOURCE (viz. wb_set_lob_mode).
-
psql
- Identifikátor prepared SQL příkazu získaný předchozím voláním wb_psql_prepare.
Popis
Funkce uzavře otevřené spojení, otevřený kurzor, otevřený LOB (Large Object - hodnotu databázového sloupce typu BLOB, CLOB, nebo NCLOB), nebo připravený SQL příkaz. Pokud bylo spojení otevřeno pomocí funkce wb_pconnect, nebude uzavřeno, ale přesto funkce vrátí TRUE. Toto chování je v souladu s logikou persistentních spojení.
Spojení, kurzory, LOBy, ani prepared SQL příkazy není nutno zavírat před skončením PHP skriptu, protože o jejich uzavření se postará PHP modul po skončení generování stránky podle PHP skriptu. Jejich explicitním uzavřením pomocí této funkce se sice uvolní zdroje obsazené prepared SQL příkazem, LOBem, kurzorem, nebo spojením, ale tyto zdroje jsou relativně malé. Explicitní uzavírání kurzorů by mělo význam pouze v takovém PHP skriptu, který otevírá velké množství (řádově desítky a více) kurzorů. Před explicitním uzavřením kurzoru je nutno explicitně uzavřít všechny LOBy, které byly z něj otevřeny. Před explicitním uzavřením spojení na databázi je nutno explicitně uzavřít všechny kurzory a prepared SQL příkazy, které byly pomocí tohoto spojení otevřeny.
Návratová hodnota
TRUE v případě úspěchu, FALSE pokud dojde k chybě.
Příklad
$conn=wb_connect("wbserver", "_sysext", "Anonymous", "");
$res=wb_exec($conn, "select logname from Usertab where Ord(category)=CATEG_USER");
wb_result_all($res,"border=1");
wb_close($res);
wb_close($conn);
Viz