ifx_prepare
(PHP 4, PHP <=5.2.0)
ifx_prepare — Preparar una sentencia SQL para su ejecución
Descripción
$query
, resource $link_identifier
[, int $cursor_def
], mixed $blobidarray
)
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
blobidarrayque 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.