fbsql_query
Send a FrontBase query
&reftitle.description;
resourcefbsql_query
stringquery
resourcelink_identifier
intbatch_size
Sends a query to the currently active database on
the server.
If the query succeeds, you can call fbsql_num_rows to
find out how many rows were returned for a SELECT statement or
fbsql_affected_rows to find out how many rows were
affected by a DELETE, INSERT, REPLACE, or UPDATE statement.
&reftitle.parameters;
query
The SQL query to be executed.
The query string shall always end with a semicolon.
&fbsql.link-identifier.description;
batch_size
&reftitle.returnvalues;
fbsql_query returns &true; (non-zero) or &false;
to indicate whether or not the query succeeded. A return value
of &true; means that the query was legal and could be executed by
the server. It does not indicate anything about the number of
rows affected or returned. It is perfectly possible for a query
to succeed but affect no rows or return no rows.
For SELECT statements, fbsql_query returns a new
result identifier that you can pass to fbsql_result.
fbsql_query will also fail and return &false; if you
don't have permission to access the table(s) referenced by the query.
&reftitle.examples;
The following query is syntactically invalid, so
fbsql_query fails and returns &false;:
fbsql_query example
]]>
The following query is semantically invalid if
my_col is not a column in the table
my_tbl, so fbsql_query
fails and returns &false;:
fbsql_query example
]]>
&reftitle.seealso;
fbsql_affected_rows
fbsql_db_query
fbsql_free_result
fbsql_result
fbsql_select_db
fbsql_connect