sqlite_exec
SQLiteDatabase->exec
(No version information available, might be only in CVS)
SQLiteDatabase->exec — Executes a result-less query against a given database
Descrição
Object oriented style (method):
Executes an SQL statement given by the query against a given database handle (specified by the dbhandle parameter).
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.
Parâmetros
- 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.
Nota: Duas sintaxes alternativas são suportaas para compatibilidade com outras extensões de banco de dados( como o MySQL). A forma preferida é a primeira, aonde o parâmetro dbhandle é o primeiro parãmetro da função.
Valor Retornado
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().
Os nomes de colunas retornados por SQLITE_ASSOC e SQLITE_BOTH serão serão modificados para maiúsculas/minúsculas de acordo com o valor da opção de configuração sqlite.assoc_case .
Histórico
| Versão | Descrição |
|---|---|
| 5.1.0 | Added the error_msg parameter |
Exemplos
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();
}
?>