(PHP 4, PHP 5 < 5.2.1)
ifx_prepare — Preparar una sentencia SQL para su ejecución
$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).
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.
Devuelve un identificador válido del resultado para ser usado por ifx_do(),
o FALSE
en caso de error.