fbsql_query(3) [php man page]

FBSQL_QUERY(3)								 1							    FBSQL_QUERY(3)

fbsql_query - Send a FrontBase query

SYNOPSIS

       resource fbsql_query (string  $query, [resource	$link_identifier], [int  $batch_size])

DESCRIPTION

	Sends a $query to the currently active database on the server.

	If  the  query	succeeds,  you	can  call  fbsql_num_rows(3)  to  find	out  how  many	rows  were  returned  for  a  SELECT  statement or
       fbsql_affected_rows(3) to find out how many rows were affected by a DELETE, INSERT, REPLACE, or UPDATE statement.

PARAMETERS

	      o $query
		- The SQL query to be executed.

	      Note

		      The query string shall always end with a semicolon.

	      o $
		link_identifier -A FrontBase link identifier returned by fbsql_connect(3) or fbsql_pconnect(3).If optional and not specified,  the
		function  will	try  to  find  an  open  link to the FrontBase server and if no such link is found it will try to create one as if
		fbsql_connect(3) was called with no arguments.

	      o $batch_size
		-

RETURN VALUES

       fbsql_query(3) 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(3) returns a new result identifier that you can pass to fbsql_result(3).

       fbsql_query(3) will also fail and return FALSE if you don't have permission to access the table(s) referenced by the query.

EXAMPLES

	The following query is syntactically invalid, so fbsql_query(3) fails and returns FALSE:

       Example #1

	      fbsql_query(3) example

	      <?php
	      $result = fbsql_query("SELECT * WHERE 1=1")
		  or die ("Invalid query");
	      ?>

	The following query is semantically invalid if my_col is not a column in the table my_tbl, so fbsql_query(3) fails and returns FALSE:

       Example #2

	      fbsql_query(3) example

	      <?php
	      $result = fbsql_query ("SELECT my_col FROM my_tbl;")
		  or die ("Invalid query");
	      ?>

SEE ALSO

       fbsql_affected_rows(3), fbsql_db_query(3), fbsql_free_result(3), fbsql_result(3), fbsql_select_db(3), fbsql_connect(3).

PHP Documentation Group 													    FBSQL_QUERY(3)

Check Out this Related Man Page

FBSQL_READ_BLOB(3)							 1							FBSQL_READ_BLOB(3)

fbsql_read_blob - Read a BLOB from the database

SYNOPSIS

       string fbsql_read_blob (string  $blob_handle, [resource	$link_identifier])

DESCRIPTION

	Reads BLOB data from the database.

	If  a select statement contains BLOB and/or CLOB columns FrontBase will return the data directly when data is fetched. This default behav-
       ior can be changed with fbsql_set_lob_mode(3) so the fetch functions will return handles to BLOB and CLOB data. If a handle  is	fetched  a
       user must call fbsql_read_blob(3) to get the actual BLOB data from the database.

PARAMETERS

	      o $blob_handle
		- A BLOB handle, returned by fbsql_create_blob(3).

	      o $
		link_identifier  -A FrontBase link identifier returned by fbsql_connect(3) or fbsql_pconnect(3).If optional and not specified, the
		function will try to find an open link to the FrontBase server and if no such link is found it	will  try  to  create  one  as	if
		fbsql_connect(3) was called with no arguments.

RETURN VALUES

	Returns a string containing the specified BLOB data.

EXAMPLES

       Example #1

	      fbsql_read_blob(3) example

	      <?php
	      $link = fbsql_pconnect("localhost", "_SYSTEM", "secret")
		  or die("Could not connect");
	      $sql = "SELECT BLOB_COLUMN FROM BLOB_TABLE;";
	      $rs = fbsql_query($sql, $link);
	      $row_data = fbsql_fetch_row($rs);
	      // $row_data[0] will now contain the blob data for the first row
	      fbsql_free_result($rs);

	      $rs = fbsql_query($sql, $link);
	      fbsql_set_lob_mode($rs, FBSQL_LOB_HANDLE);
	      $row_data = fbsql_fetch_row($rs);
	      // $row_data[0] will now contain a handle to the BLOB data in the first row
	      $blob_data = fbsql_read_blob($row_data[0]);
	      fbsql_free_result($rs);

	      ?>

SEE ALSO

       fbsql_create_blob(3), fbsql_read_clob(3), fbsql_set_lob_mode(3).

PHP Documentation Group 													FBSQL_READ_BLOB(3)

Linux and UNIX Man Pages

fbsql_query(3) [php man page]

Check Out this Related Man Page