ifx_query

Descripción

int ifx_query ( string consulta, int id_enlace [, int tipo_cursor [, mixed matriz_id_blob]] )

Devuelve un identificador de resultado positivo si tuvo éxito, o FALSE si ocurrió un error.

Un recurso "id_resultado" es usado por otras funciones para obtener los resultados de la consulta. Define "filas_afectadas" para su consulta a través de la función ifx_affected_rows().

ifx_query() envía una consulta a la base de datos activa actualmente en el servidor, la cual está asociada con el identificador de enlace dado.

Ejecuta consulta sobre la conexión id_enlace. En el caso de consultas "tipo-select", un cursor es declarado y abierto. El parámetro opcional tipo_cursor le permite hacer que éste sea un cursor "scroll" o "hold". Es una máscara de bits y puede ser IFX_SCROLL, IFX_HOLD, o ambos unidos mediante la operación lógica OR. Las consultas que no son de selección son de "ejecución inmediata". IFX_SCROLL e IFX_HOLD son constantes simbólicas, y como tales no deben encontrarse entre comillas. Si omite este parámetro, el cursor será un cursor secuencial normal.

Para cualquier tipo de consulta, el número (estimado o real) de filas afectadas es almacenado para su consulta mediante ifx_affected_rows().

Si tiene columnas BLOB (BYTE o TEXT) en una consulta de actualización, puede añadir un parámetro matriz_id_blob que contenga los "ids de blob" correspondientes, y debería reemplazar esas columnas con un "?" en el texto de la consulta.

Si el contenido de la columna TEXT (o BYTE) lo permite, puede usar también "ifx_textasvarchar(1)" y "ifx_byteasvarchar(1)". Esto le permite tratar columnas TEXT (o BYTE) como si fueran columnas normales (pero largas) de tipo VARCHAR para consultas select, y no necesita complicarse con id's de blob.

Con ifx_textasvarchar(0) o ifx_byteasvarchar(0) (la situación predeterminada), las consultas select devolverán columnas BLOB como id's blob (valores enteros). Puede obtener el valor del blob como una cadena o archivo con las funciones blob (vea más adelante).

Ejemplo 1. Mostrar todas las filas de la tabla "ordenes" como una tabla HTML <?php ifx_textasvarchar(1);      // usar "modo de texto" para blobs $id_res = ifx_query("select * from ordenes", $id_con); if (! $id_res) {     printf("No se pueden seleccionar &oacute;rdenes: %s\n<br />%s<br />\n", ifx_error());     ifx_errormsg();     die; } ifx_htmltbl_result($id_res, "border=\"1\""); ifx_free_result($id_res); ?>

Ejemplo 2. Insertar algunos valores en la tabla "catalogo" <?php // crear id's blob para una columna byte y text $textid = ifx_create_blob(0, 0, "Text column in memory"); $byteid = ifx_create_blob(1, 0, "Byte column in memory"); // almacenar id's blob en una matriz id_blob $matriz_id_blob[] = $textid; $matriz_id_blob[] = $byteid; // ejecutar consulta $consulta = "insert into catalogo (num_bodega, cod_manu, " .          "descr_cat,imagen_cat) values(1,'HRO',?,?)"; $id_res = ifx_query($consulta, $id_con, $matriz_id_blob); if (! $id_res) {     /* ... error ... */ } // liberar el id de resultado ifx_free_result($id_res); ?>

Vea también ifx_connect().