sqlite_fetch_single(3) [php man page]

SQLITE_FETCH_SINGLE(3)													    SQLITE_FETCH_SINGLE(3)

sqlite_fetch_single - Fetches the first column of a result set as a string

SYNOPSIS

       string sqlite_fetch_single (resource  $result, [bool  $decode_binary = true])

DESCRIPTION

       Object oriented style (method):
       string SQLiteResult::fetchSingle ([bool	$decode_binary = true])
       string SQLiteUnbuffered::fetchSingle ([bool  $decode_binary = true])

       sqlite_fetch_single(3) is identical to sqlite_fetch_array(3) except that it returns the value of the first column of the rowset.

	This is the most optimal way to retrieve data when you are only interested in the values from a single column of data.

PARAMETERS

	      o $result
		- The SQLite result resource. This parameter is not required when using the object-oriented method.

	      o $decode_binary
		-When  the $decode_binary parameter is set to TRUE (the default), PHP will decode the binary encoding it applied to the data if it
		was encoded using the sqlite_escape_string(3). You should normally leave this value at its default, unless you are  interoperating
		with databases created by other sqlite capable applications.

RETURN VALUES

	Returns the first column value, as a string.

EXAMPLES

       Example #1

	      A sqlite_fetch_single(3) example

	      <?php
	      if ($dbhandle = sqlite_open('mysqlitedb', 0666, $sqliteerror)) {

		  $sql = "SELECT id FROM sometable WHERE id = 42";
		  $res = sqlite_query($dbhandle, $sql);

		  if (sqlite_num_rows($res) > 0) {
		      echo sqlite_fetch_single($res); // 42
		  }

		  sqlite_close($dbhandle);
	      }
	      ?>

SEE ALSO

       sqlite_fetch_array(3).

PHP Documentation Group 												    SQLITE_FETCH_SINGLE(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)