fbsql_query

fbsql_query -- Sendet eine FrontBase-Abfrage

Beschreibung

resource fbsql_query ( string Abfrage [, resource Verbindungskennung])

fbsql_query( ) sendet eine Abfrage an die momentan active Datenbank auf dem Server , der mit der Verbindungskennung spezifiziert ist . Wenn die Verbindungskennung nicht angegeben ist , wird die zuletzt geöffnete Verbindung verwendet . Wenn keine Verbindung offen ist , wird versucht eine Verbindung aufzubauen . Dies geschieht in der gleichen Weise , als ob fbsql_connect( ) was ohne Argumente aufgerufen wird .

Anmerkung : Der Abfrage-String soll immer mit einem Semikolon enden .

fbsql_query( ) liefert zur Überprüfung des Erfolgs der Abfrage TRUE (Nicht NULL ) oder FALSE zurück . Ein TRUE -Rückgabewert bestätigt , dass die Abfrage gültig war und vom Server ausgeführt werden konnte . Über den Rückgabewert können nicht die betroffenen oder selektierten Datensätze ermittelt werden . Es ist sogar möglich , dass die Abfrage erfolgreich war , aber keine Datensätze betroffen oder selektiert werden .

Die folgende Abfrage ist syntaktisch falsch , so dass fbsql_query( ) fehlschlägt und FALSE zurückliefert :

Beispiel 1 . fbsql_query( ) Beispiel

 
?php

 
$result

 
=

 
fbsql_query

 
(

 
"SELECT

 
*

 
WHERE

 
1=1"

 
)

 
or

 
die

 
("Abfrage

 
gescheitert")

 
;

 
?





Die folgende Abfrage ist sematisch falsch , wenn my_col keine Spalte in der Tabelle my_tbl ist . Deshalb schlägt fbsql_query( ) fehl und liefert FALSE zurück :

Beispiel 2 . fbsql_query( ) example

 
?php

 
$result

 
=

 
fbsql_query

 
(

 
"SELECT

 
my_col

 
FROM

 
my_tbl"

 
)

 
or

 
die

 
("Abfrage

 
gescheitert")

 
;

 
?





fbsql_query( ) schlägt ebenso fehl und liefert FALSE , wenn Sie keine Berechtigung zum Zugriff auf die verwiesene(n ) Tabelle(n ) haben .

Wenn die Abfrage ist erfolgreich ist , können Sie fbsql_num_rows( ) aufrufen , um herauszufinden wie viele Datensätze von einer SELECT-Abfrage zurückgeliefert wurde . Falls Sie eine DELETE- , INSERT- , REPLACE - oder UPDATE-Abfrage verwendet haben , können Sie fbsql_affected_rows( ) verwendet , um die betroffenen Datensätze herauszufinden .

Nur bei SELECT-Abfragen wird fbsql_query( ) eine neue Ergebniskennung zurück , die Sie an fbsql_result( ) übergeben können . Wenn die Bearbeitung des Ergebnisses abgeschlossen ist , können Sie die belegten Resourcen durch den Aufruf von fbsql_free_result( ) freigeben . Bei Scriptende wird der belegte Speicher automatisch freigegeben .

Siehe auch : fbsql_affected_rows( ) , fbsql_db_query( ) , fbsql_free_result( ) , fbsql_result( ) , fbsql_select_db( ) und fbsql_connect( ) .