(PHP 5 >= 5.3.0, PHP 7, PHP 8)
SQLite3::querySingle — Executa uma consulta e retorna um único resultado
Executa uma consulta e retorna um único resultado.
query
A consulta SQL a ser executada.
entireRow
Por padrão, querySingle() retorna o valor da
primeira coluna retornada pela consulta. Se
entireRow
for true
, então ele retorna um array
da linha inteira.
Retorna o valor da primeira coluna dos resultados ou um array da primeira linha inteira
(se entireRow
for true
).
Se a consulta for válida mas nenhum resultado for retornado, então null
será
retornado se entireRow
for false
, caso contrário um
array vazio é retornado.
Consultas inválidas ou falhadas retornarão false
.
Exemplo #1 Exemplo de SQLite3::querySingle()
<?php
$db = new SQLite3('mysqlitedb.db');
var_dump($db->querySingle('SELECT username FROM user WHERE userid=1'));
print_r($db->querySingle('SELECT username, email FROM user WHERE userid=1', true));
?>
O exemplo acima produzirá algo semelhante a:
string(5) "Scott" Array ( [username] => Scott [email] => scott@example.com )