fbsql_query

(PHP 4 >= 4.0.6, PHP 5 < 5.3.0)

fbsql_queryRealiza una consulta FrontBase

Descripción

fbsql_query ( string $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