sqlite_unbuffered_query(3) [php man page]

SQLITE_UNBUFFERED_QUERY(3)												SQLITE_UNBUFFERED_QUERY(3)

sqlite_unbuffered_query - Execute a query that does not prefetch and buffer all data

SYNOPSIS

       resource sqlite_unbuffered_query (resource  $dbhandle, string  $query, [int  $result_type = SQLITE_BOTH], [string  &$error_msg])

DESCRIPTION

       resource sqlite_unbuffered_query (string  $query, resource  $dbhandle, [int  $result_type = SQLITE_BOTH], [string  &$error_msg])

       Object  oriented  style	(method):  SQLiteUnbuffered  SQLiteDatabase::unbufferedQuery  (string	$query, [int  $result_type = SQLITE_BOTH],
       [string	&$error_msg])

       sqlite_unbuffered_query(3) is identical to sqlite_query(3) except that the result that is returned is a sequential forward-only result  set
       that can only be used to read each row, one after the other.

	This  function	is ideal for generating things such as HTML tables where you only need to process one row at a time and don't need to ran-
       domly access the row data.

       Note

	       Functions such as sqlite_seek(3), sqlite_rewind(3), sqlite_next(3), sqlite_current(3), and sqlite_num_rows(3) do not work on result
	      handles returned from sqlite_unbuffered_query(3).

PARAMETERS

	      o $dbhandle
		- The SQLite Database resource; returned from sqlite_open(3) when used procedurally. This parameter is not required when using the
		object-oriented method.

	      o $query
		- The query to be executed.  Data inside the query should be properly escaped.

	      o $result_type
		-The optional $result_type parameter accepts a constant and determines how the returned array will be indexed. Using  SQLITE_ASSOC
		will  return  only associative indices (named fields) while SQLITE_NUM will return only numerical indices (ordinal field numbers).
		SQLITE_BOTH will return both associative and numerical indices.  SQLITE_BOTH is the default for this function.

	      o $error_msg
		- The specified variable will be filled if an error occurs. This is specially important because SQL syntax errors can't be fetched
		using the sqlite_last_error(3) function.

       Note

	      Two  alternative	syntaxes are supported for compatibility with other database extensions (such as MySQL). The preferred form is the
	      first, where the $dbhandle parameter is the first parameter to the function.

RETURN VALUES

	Returns a result handle or FALSE on failure.

       sqlite_unbuffered_query(3) returns a sequential forward-only result set that can only be used to read each row, one after the other.

CHANGELOG

       +--------+---------------------------------+
       |Version |				  |
       |	|				  |
       |	|	    Description 	  |
       |	|				  |
       +--------+---------------------------------+
       | 5.1.0	|				  |
       |	|				  |
       |	|  Added the $error_msg parameter |
       |	|				  |
       +--------+---------------------------------+
SEE ALSO

       sqlite_query(3).

PHP Documentation Group 												SQLITE_UNBUFFERED_QUERY(3)

SQLITE_EXEC(3)															    SQLITE_EXEC(3)

sqlite_exec - Executes a result-less query against a given database

SYNOPSIS

       bool sqlite_exec (resource  $dbhandle, string  $query, [string  &$error_msg])

DESCRIPTION

       bool sqlite_exec (string  $query, resource  $dbhandle)

       Object oriented style (method): bool SQLiteDatabase::queryExec (string  $query, [string	&$error_msg])

	Executes an SQL statement given by the $query against a given database handle (specified by the $dbhandle parameter).

       Warning

	       SQLite will execute multiple queries separated by semicolons, so you can use it to execute a batch of SQL that you have loaded from
	      a file or have embedded in a script.

PARAMETERS

	      o $dbhandle
		- The SQLite Database resource; returned from sqlite_open(3) when used procedurally. This parameter is not required when using the
		object-oriented method.

	      o $query
		- The query to be executed.  Data inside the query should be properly escaped.

	      o $error_msg
		- The specified variable will be filled if an error occurs. This is specially important because SQL syntax errors can't be fetched
		using the sqlite_last_error(3) function.

       Note

	      Two alternative syntaxes are supported for compatibility with other database extensions (such as MySQL). The preferred form  is  the
	      first, where the $dbhandle parameter is the first parameter to the function.

RETURN VALUES

	This  function	will  return  a  boolean  result; TRUE for success or FALSE for failure. If you need to run a query that returns rows, see
       sqlite_query(3).

       The column names returned by SQLITE_ASSOC and SQLITE_BOTH will be case-folded according to the value of the sqlite.assoc_case configuration
       option.

CHANGELOG

       +--------+---------------------------------+
       |Version |				  |
       |	|				  |
       |	|	    Description 	  |
       |	|				  |
       +--------+---------------------------------+
       | 5.1.0	|				  |
       |	|				  |
       |	|  Added the $error_msg parameter |
       |	|				  |
       +--------+---------------------------------+
EXAMPLES

       Example #1

	      Procedural example

	      <?php
	      $dbhandle = sqlite_open('mysqlitedb');
	      $query = sqlite_exec($dbhandle, "UPDATE users SET email='jDoe@example.com' WHERE username='jDoe'", $error);
	      if (!$query) {
		  exit("Error in query: '$error'");
	      } else {
		  echo 'Number of rows modified: ', sqlite_changes($dbhandle);
	      }
	      ?>

       Example #2

	      Object-oriented example

	      <?php
	      $dbhandle = new SQLiteDatabase('mysqlitedb');
	      $query = $dbhandle->queryExec("UPDATE users SET email='jDoe@example.com' WHERE username='jDoe'", $error);
	      if (!$query) {
		  exit("Error in query: '$error'");
	      } else {
		  echo 'Number of rows modified: ', $dbhandle->changes();
	      }
	      ?>

SEE ALSO

       sqlite_query(3), sqlite_unbuffered_query(3), sqlite_array_query(3).

PHP Documentation Group 													    SQLITE_EXEC(3)