ifx_prepare
(No version information available, might be only in CVS)
ifx_prepare — Preparar una sentencia-SQL para su ejecución
Descripción
Prepara una consulta para su uso posterior con ifx_do().
Para consultas "tipo-select" un cursor es declarado y abierto. Las consultas no-select son de "ejecución inmediata".
Para cualquiera de los tipos de consulta, el número (estimado o real) de filas afectadas es almacenado para su recuperación por ifx_affected_rows().
Si los contenidos de la columna TEXT (o BYTE) lo permiten, es posible usar también ifx_textasvarchar(1) y ifx_byteasvarchar(1). Esto le permite tratar columnas TEXT (o BYTE) como si fueran columnas VARCHAR ordinarias (pero largas) para las consultas select, y no debe preocuparse por id's blob.
Con ifx_textasvarchar(0) o ifx_byteasvarchar(0) (la situación predeterminada), las consultas select devolverán columnas BLOB como id's blob (valor entero). Puede obtener el valor del blob como una cadena o un archivo con las funciones blob (vea más adelante).
Lista de parámetros
- consulta
-
La cadena de consulta.
- id_enlace
-
El identificador de enlace.
- tipo_cursor
-
Este parámetro opcional le permite hacer de éste un cursor scroll y/o hold. Es una máscara de bits y puede contener el valor IFX_SCROLL, IFX_HOLD, o ambos unidos con el operador lógico OR.
- matriz_id_blob
-
Si tiene columnas BLOB (BYTE o TEXT) en la consulta, puede agregar un parámetro matriz_id_blob que contenga los "ids blob" correspondientes, y debería reemplazar esas columnas con un "?" en el texto de la consulta.
Valores retornados
Devuelve un identificador de resultado válido para su uso con ifx_do(), o FALSE en caso de errores.