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