fbsql_query
(PHP 4 >= 4.0.6, PHP 5 < 5.3.0)
fbsql_query — Realiza una consulta FrontBase
Descripción
$query
, resource $link_identifier = ?
, int $batch_size = ?
) : resource
Envia la query a la base de datos activa en el
servidor.
Si la consulta tiene éxito, se puede llamar fbsql_num_rows() para saber cuantas filas se devolvieron para una instrucción SELECT, o fbsql_affected_rows() para saber cuantas filas se vieron afectadas por una instrucción DELETE, INSERT, REPLACE, o UPDATE.
Parámetros
-
query -
La consulta SQL a ejecutar.
Nota:
La cadena de consulta debe acabar siempre con punto y coma.
-
link_identifier -
Un identificador de enlace FrontBase devuelto por fbsql_connect() o fbsql_pconnect().
Es opcional y si no se especifica, la función intentará encontrar un enlace abierto al servidor FrontBase y de no encontrarse ningún enlace abierto intentará crear uno como si fbsql_connect() fuese invocada sin parámetros.
-
batch_size -
Valores devueltos
fbsql_query() devuelve true (non-zero) o false
para indicar si la consulta tuvo éxito. Un valor devuelto
true implica que la consulta significa que la consulta es lícita y podría ser ejecutada por
el servidor. No indica nada acerca del número de filas
afectadas o devueltas. Es perfectamente posible que una consulta
tenga éxito pero no devuelva o afecte ninguna fila.
Para instrucciones SELECT, fbsql_query() devuelve un nuevo identificador de resultado que se puede pasar a fbsql_result().
fbsql_query() también fallará y devolverá false si
no se tiene permiso para acceder a la(s) tabla(s) referidas por la consulta.
Ejemplos
La siguiente consulta es sintácticamente inválida, así que
fbsql_query() falla y devuelve false:
Ejemplo #1 Ejemplo fbsql_query()
<?php
$result = fbsql_query("SELECT * WHERE 1=1")
or die ("Consulta inválida");
?>
La siguiente consulta es semánticamente inválida si
my_col no es una columna de la tabla
my_tbl, así que fbsql_query()
falla y devuelve false:
Ejemplo #2 Ejemplo fbsql_query()
<?php
$result = fbsql_query ("SELECT my_col FROM my_tbl;")
or die ("Consulta inválida");
?>
Ver también
- fbsql_affected_rows() - Obtiene el numero de filas afectadas en la anterior operación de FrontBase
- fbsql_db_query() - Ejecuta una consulta a FrontBase
- fbsql_free_result() - Libera la memoria de resultados
- fbsql_result() - Obtiene los datos de resultado
- fbsql_select_db() - Selecciona una base de datos FrontBase
- fbsql_connect() - Abre una conexión a un servidor FrontBase
add a note
