(No version information available, might be only in CVS)
SQLiteDatabase->query — Ejecuta una consulta sobre la base de datos y devuelve un manejador del resultado
Método que sigue el estilo orientado a objetos:
Ejecuta una sentencia SQL dada por el parámetro consulta contra una base de datos identificada mediante el parámetro manejador_bd .
La consulta que se quiere ejecutar.
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.
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.
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).
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).