PHP Conference Nagoya 2025

SQLite3::querySingle

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

SQLite3::querySingleExecuta uma consulta e retorna um único resultado

Descrição

public SQLite3::querySingle(string $query, bool $entireRow = false): mixed

Executa uma consulta e retorna um único resultado.

Parâmetros

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.

Valor Retornado

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.

Exemplos

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
)

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top