sqlite_prev
sqlite_rewind
SQLite Functions
PHP Manual

# sqlite_query

# SQLiteDatabase->query

(PHP 5, PECL sqlite >= 1.0.0)

sqlite_query -- SQLiteDatabase->query — Ejecuta una consulta sobre la base de datos y devuelve un manejador del resultado

### Descripción

resource sqlite_query ( resource `$manejador_bd` , string `$consulta` [, int `$tipo_resultado` ] )
resource sqlite_query ( string `$consulta` , resource `$manejador_bd` [, int `$tipo_resultado` ] )

Método que sigue el estilo orientado a objetos:

SQLiteDatabase
SQLiteResult query ( string `$consulta` [, int `$tipo_resultado` ] )

Ejecuta una sentencia SQL dada por el parámetro `consulta` contra una base de datos identificada mediante el parámetro `manejador_bd` .

### Lista de parámetros

`consulta`

  La consulta que se quiere ejecutar.

`manejador_bd`

  El recurso que identifica la base de datos SQLite (y que es el que devuelve la función sqlite_open()). Este parámetro no se requiere cuando se emplea el método orientado a objetos.

`tipo_resultado`

  The optional `result_type` parameter accepts a constant and determines how the returned array will be indexed. Using `SQLITE_ASSOC` will return only associative indices (named fields) while `SQLITE_NUM` will return only numerical indices (ordinal field numbers). `SQLITE_BOTH` will return both associative and numerical indices. `SQLITE_BOTH` is the default for this function.

> Note: Two alternative syntaxes are supported for compatibility with other database extensions (such as MySQL). The preferred form is the first, where the `dbhandle` parameter is the first parameter to the function.

### Valores retornados

La función devuelve el manejador del resultado o `FALSE` si se produce un error. Para las consultas que devuelven una serie de filas, el manejador del resultado se puede emplear con funciones como sqlite_fetch_array() y sqlite_seek().

Independientemente del tipo de consulta, la función devuelve `FALSE` si la consulta ha producido un error.

sqlite_query() devuelve un manejador de resultado que referencia un resultado almacenado (buffered) y que se puede recorrer hacia delante y hacia detrás. Este tipo de resultado es útil para consultas pequeñas en las que es necesario recorrer el resultado en cualquier sentido para poder acceder de forma directa a cualquiera de las filas. Los resultados almacenados reservan la memoria suficiente como para almacenar todo el resultado y el manejador no se devuelve hasta que se han obtenido todas las filas. Si solamente es necesario el acceso secuencial a los resultados, se recomienda emplear la función sqlite_unbuffered_query(), que tiene un rendimiento muy superior, ya que el resultado no es almacenado (unbuffered).

### Notes

Warning

SQLite permite ejecutar múltiples consultas seguidas separadas por un punto y coma. De esta forma, se pueden ejecutar de una vez una serie de consultas SQL que se han cargado por ejemplo de un archivo o que se han incluido en un script. De todas formas, este funcionamiento solo es válido cuando el resultado de una consulta no se utiliza en las demás. Si se utiliza el resultado, entonces solamente se ejecuta la primera sentencia SQL. La función sqlite_exec() siempre ejecuta múltiples consultas SQL.

Cuando se ejecutan varias consultas de forma seguida, el valor devuelto por esta función será `FALSE` si se ha producido un error o indefinido en cualquier otro caso ya que depende de las consultas realizadas (puede que devuelva `TRUE` si se ha tenido éxito o puede que devuelva un manejador de un resultado).

### Ver también

- sqlite_unbuffered_query() - Ejecuta una consulta sobre la base de datos cuyo resultado no almacena todos los datos devueltos
- sqlite_array_query() - Ejecuta una consulta contra una base de datos y devuelve el resultado en forma de matriz

sqlite_prev
sqlite_rewind
SQLite Functions
PHP Manual