ifx_prepare

(PHP 4, PHP 5 < 5.2.1)

ifx_preparePreparar una sentencia SQL para su ejecución

Descripción

ifx_prepare ( string $query , resource $link_identifier [, int $cursor_def ], mixed $blobidarray ) : resource

Prepara a query para su posterior uso con ifx_do().

Para consultas "SELECT" un cursor es declarado y abierto. Las consultas que no son "SELECT" son ejecutadas inmediatamente.

Para cualquier tipo de consulta el número (estimado o real) de filas afectadas es guardado para extraerse por medio de ifx_affected_rows().

Si el contendo de las columnas de tipo TEXT (o BYTE) lo permiten, se puede usar además ifx_textasvarchar(1) e ifx_byteasvarchar(1). Lo anterior permitirá tratar las columnas de tipo TEXT (o BYTE) como si fueran columnas VARCHAR ordinarias (pero extensas) en consultas "SELECT" y no es necesario preocuparse por identificadores BLOB.

Con ifx_textasvarchar(0) o ifx_byteasvarchar(0) (opción predeterminada), las consultas "SELECT" devolverán las columnas BLOB como identificadores BLOB (valores enteros). Se puede obtener el valor BLOB como si fuera cadena o archivo con las funciones BLOB (ver más abajo).

Parámetros

query

La consulta como cadena.

link_identifier

El identificador de la conexión.

cursor_def

Este parámetro opcional permite tratarlo como un cursor scroll y/o hold. Es una máscara y puede ser IFX_SCROLL, IFX_HOLD, o ambas.

blobidarray

Si existen columnas BLOB (BYTE o TEXT) en la consulta, se puede agregar un parámetro blobidarray que contenga los identificadores BLOB correspondientes.

Valores devueltos

Devuelve un identificador válido del resultado para ser usado por ifx_do(), o FALSE en caso de error.

Ver también

  • ifx_do() - Ejecutar una sentencia SQL previamente preparada