SQLite3::querySingle

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#

Ejecuta una consulta y devuelve un único resultado

Descripción#

public SQLite3::querySingle(string $query, [bool $entireRow]): mixed
```php

Ejecuta una consulta y devuelve un único resultado.

## Parámetros

`query`  
La consulta SQL a ejecutar.

`entireRow`  
Por omisión, esta función devuelve el valor de la primera columna devuelta por la consulta. Si `entireRow` es `true`, entonces la función devolverá un array que contiene toda la primera fila.

## Valores devueltos

Devuelve el valor de la primera columna del resultado, o un array que contiene toda la primera fila (si el argumento `entireRow` es `true`).

Si la consulta es válida pero no devuelve ningún resultado, `null` será devuelto si `entireRow` es `false`, de lo contrario se devuelve un array vacío.

Las consultas inválidas devolverán `false`.

## Ejemplos

Ejemplo con `SQLite3::querySingle`

querySingle('SELECT username FROM user WHERE userid=1')); print_r($db->querySingle('SELECT username, email FROM user WHERE userid=1', true)); ?>

```php

Resultado del ejemplo anterior es similar a:

string(5) "Scott"
Array
(
    [username] => Scott
    [email] => scott@example.com
)