PHP Handbuch
Zurück |  | Nach vorne

# fbsql_query

(PHP 4 >= 4.0.6)

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().

Zurück | Zum Anfang | Nach vorne
fbsql_pconnect | Nach oben | fbsql_read_blob