sqlite_querySQLiteDatabase::queryEjecutar una consulta en una base de datos dada y devolver un gestor de resultados
&reftitle.description;
resourcesqlite_queryresourcedbhandlestringqueryintresult_typeSQLITE_BOTHstringerror_msgresourcesqlite_querystringqueryresourcedbhandleintresult_typeSQLITE_BOTHstringerror_msg&style.oop; (método):publicSQLiteResultSQLiteDatabase::querystringqueryintresult_typeSQLITE_BOTHstringerror_msg
Ejecuta una sentencia SQL dada por query en
un gestor de base de datos daod.
&reftitle.parameters;
dbhandle
El recurso de Base de datos de SQLite; devuelto por sqlite_open
cuando se usa procedimentalmente. Este parámetro no es necesario
cuando se usa el método orientado a objetos.
query
La consulta a ejectuar.
Los datos dentro de la consulta deberían ser apropiadamente escapados.
result_type
&sqlite.result-type;
error_msg
La variable especificada será rellenada si ocurre un error. Esto es
especialmente importante ya que los errores de sintaxis de SQL no se pueden recoger usando
la función sqlite_last_error.
&sqlite.param-compat;
&reftitle.returnvalues;
Esta función devolverá un gestor de resultados &return.falseforfailure;.
Para consultas que devuelven filas, el gestor de resultados se puede usar con
funciones como sqlite_fetch_array y
sqlite_seek.
Sin tener en cuenta el tipo de consulta, esta función devolverá &false; si la
consulta falla.
sqlite_query devuelve un gestor de resultados almacenado en buffer y
rasteable. Esto es útil para consultas razonablemente pequeñas donde se necesite
la capacidad de acceso a filas aleatorio. Los gestores de resultados almacenados en buffer
asignarán memoria para contener el resultado completo y no devolverán hasta que se
haya recuperado. Si sólo se necesita acceso secuencial a los datos, se
recomienda usar la función con más alto rendimiento
sqlite_unbuffered_query en su lugar.
&reftitle.changelog;
&Version;&Description;5.1.0
Se añadió el parámetro error_msg
&reftitle.notes;
SQLite ejecutará múltiples consultas separadas por
puntos y comas, por lo que se puede usar esta función para ejecutar un lote de SQL que se haya
cargado desde un fichero o embebido en un script. Sin embargo, esto sólo funcionará
cuando el resultado de la función no se use - si se usara,
se ejecutaría solamente la primera sentencia SQL. La función
sqlite_exec siempre ejecutará múltiple sentencias
SQL.
Cuando se ejecutan múltiples consultas, el valor devuleto por esta función
será &false; si hubiera un error, pero será indefinido de otro modo (podría
ser &true; en caso de éxito o podría devolver un gestor de resultados).
&reftitle.seealso;
sqlite_unbuffered_querysqlite_array_query