Forum und email
sqlite_exec

sqlite_exec

(PHP 5)

sqlite_exec

(no version information, might be only in CVS)

SQLiteDatabase->exec -- Executes a result-less query against a given database

Popis

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

bool sqlite_exec ( string query, resource dbhandle )

Object oriented style (method):

class SQLiteDatabase {

bool queryExec ( string query [, string &error_msg] )

}

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

Varování

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.

Seznam parametrů

dbhandle

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

query

The query to be executed.

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

Poznámka: Pro kompatibilitu s jinými databázovými rozšířeními (např. MySQL) jsou podporovány dvě alternativní syntaxe. Preferována je první z nich, kde parametr dbhandle je prvním parametrem funkce.

Návratové hodnoty

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

Názvy sloupců zjištěné pomocí SQLITE_ASSOC a SQLITE_BOTH will be upraveny z hlediska malých/velkých písmen podle hodnoty konfiguračního parametru sqlite.assoc_case.

ChangeLog (záznam změn)

VerzePopis
5.1.0 Added the error_msg parameter

Příklady

Příklad 1. Procedural example

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

Příklad 2. Object-oriented example

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