XLIII_ Funciones para Informix

El conector para Informix Online (ODS) 7_x, SE 7_x y Universal Server (IUS) 9_x se encuentra implementado en "functions/ifx_ec" y "functions/php3_ifx_h"_ Para ODS 7_x está completado, con total soporte para columnas de tipo BYTE y TEXT_ Para IUS 9_x está parcialmente finalizado: los tipos de datos nuevos están allí (en el IUS 9_x), pero la funcionalidad para SLOB y CLOB se encuentra bajo construcción todavía_

Notas de configuración:
Antes de ejecutar el guión (script) "configure", asegúrate que la variable "INFORMIXDIR" ha sido definida_
Si ejecutas "configure __with_informix=yes" entonces el guión de configuración detectará automáticamente las librerías y los directorios include_ Puedes obviar esta detección definiendo las variables de entorno "IFX_LIBDIR", "IFX_LIBS" y "IFX_INCDIR"_ Definirás la variable de compilación condicional "HAVE_IFX_IUS" si la versión de Informix es 9_00 o superior_

Algunas notas sobre el uso de BLOBs (columnas de tipo TEXT y BYTE):
BLOBs son normalmente manipulados por enteros, los cuales representan identificadores de BLOB_ Las consultas de selección devuelven un "blob id" para columnas de tipo BYTE y TEXT_ Si eliges trabajar con los BLOBs en memoria (con: "ifx_blobinfile(0);") entonces puedes obtener el contenido con "string_var = ifx_get_blob($blob_id);"_ Si prefieres manipularlos en ficheros usa "ifx_blobinfile(1);" y "ifx_get_blob($blob_id);" devolverá el nombre del archivo_ En este caso, utiliza las funciones habituales de entrada y salida de ficheros para obtener el contenido de los blob_
Para consultas de inserción y actualización debes crear estos identificadores de blob con "ifx_create_blob(__);"_ Entonces pondrás los identificadores de blob en un array y sustituirás en la cadena de la consulta las columnas de tipo blob por una interrogación (?)_ Para inserciones y actualizaciones eres responsable de definir el contenido de los blob con ifx_update_blob(___)_
La conducta de columnas BLOB puede ser modificada mediante variables de configuración, las cuales pueden ser definidas en tiempo de ejecución mediante funciones_

variable de configuración: ifx_textasvarchar
variable de configuración: ifx_byteasvarchar

funciones en tiempo de ejecución:
ifx_textasvarchar(0): usa identificadores de blob para columnas de tipo TEXT en las consultas de selección
ifx_byteasvarchar(0): usa identificadores de blob para columnas de tipo BYTE en las consultas de selección
ifx_textasvarchar(1): devuelve columnas de tipo TEXT como si fueran de tipo VARCHAR, sin tener que usar identificadores de blob en las consultas de selección
ifx_byteasvarchar(1): devuelve columnas de tipo BYTE como si fueran de tipo VARCHAR, sin tener que usar identificadores de blob en las consultas de selección_

variable de configuración: ifx_blobinfile
función en tiempo de ejecución:
ifx_blobinfile_mode(0): devuelve columnas de tipo BYTE en memoria, el identificador de blob te permite obtener el contenido_
ifx_blobinfile_mode(1): devuelve columnas de tipo BYTE en un fichero, el identificador te permite saber el nombre de dicho archivo_
Si defines ifx_text/byteasvarchar a 1 entonces puedes usar columnas de tipo TEXT y BYTE en las consultas de selección como campos de tipo VARCHAR, pero teniendo en cuenta que tendrán un mayor tamaño que el habitual_ Ya que en PHP todas las cadenas son posibles, esto permite datos binarios_ De esta forma, se pueden manejar correctamente_ La información devuelta puede contener cualquier cosa, tú eres responsable del contenido_
Si defines ifx_blobinfile a 1, utiliza el nombre del archivo devuelto por ifx_get_blob(__) para acceder a los contenidos del blobs_ En este caso, ERES REPONSABLE DE ELIMINAR EL ARCHIVO TEMPORAL GENERADO POR INFORMIX cuando accedas a los registros_ Cada nueva fila obtenida creará un nuevo archivo temporal para cada columna de tipo BYTE_
El directorio donde se guardan los archivos temporales puede ser definido por la variable de entorno blobdir, por defecto es "_", es decir, el directorio actual_ Así, putenv(blobdir=tmpblob"); definirá un directorio donde se localizarán todos los ficheros temporales y facilitará su borrado_ Todos los nombres de los archivos comienzan por "blb"_

Recortado (trimming) automático de datos de tipo "char" (SQLCHAR y SQLNCHAR):
Puede ser definido con la variable de configuración
ifx_charasvarchar: si se define a 1 eliminará automáticamente los espacios en blanco al final de la cadena_

Valores NULL:
La variable de configuración ifx_nullformat (y en tiempo de ejecución ifx_nullformat()) cuando sea definida a TRUE devolverá columnas NULL como la cadena "NULL", si es definida a FALSE entonces la cadena vacía_ Esto permite distinguir entre columnas NULL y vacías_

Tabla de contenidos
ifx_affected_rows __ Obtiene el número de registros procesados por una consulta
ifx_blobinfile_mode __ Define el modo por defecto para los blob en todas las consultas de selección
ifx_byteasvarchar __ Define el modo por defecto para los campos de tipo byte
ifx_close __ Cierra una conexión con Informix
ifx_connect __ Abre una conexión con un servidor Informix
ifx_copy_blob __ Duplica el objeto blob dado
ifx_create_blob __ Crea un objeto blob
ifx_create_char __ Crea un objeto char
ifx_do __ Ejecuta una sentencia SQL preparada previamente
ifx_error __ Devuelve el código de error de la última llamada a Informix
ifx_errormsg __ Devuelve el mensaje de error de la última llamada a Informix
ifx_fetch_row __ Obtiene registros como un array (vector) enumerado
ifx_fieldproperties __ Indica las propiedades de los campos de una consulta SQL
ifx_fieldtypes __ Obtiene los campos de una consulta SQL
ifx_free_blob __ Borra el objeto blob
ifx_free_char __ Elimina un objeto char
ifx_free_result __ Libera los recursos de una consulta
ifx_get_blob __ Obtiene el contenido de un objeto blob
ifx_get_char __ Obtiene el contenido de un objeto char
ifx_getsqlca __ Después de una consulta, obtiene el contenido de sqlca_sqlerrd[0__5]
ifx_htmltbl_result __ Muestra todos los registros de una consulta en una tabla HTML
ifx_nullformat __ Define el valor por defecto cuando se leen valores nulos
ifx_num_fields __ Devuelve el número de columnas en una consulta
ifx_num_rows __ Cuenta los registros ya leídos de una consulta
ifx_pconnect __ Abre una conexión permanente con Informix
ifx_prepare __ Prepara una sentencia SQL para su ejecución
ifx_query __ Envía una consulta a Informix
ifx_textasvarchar __ Define el modo por defecto para los campos de tipo text
ifx_update_blob __ Actualiza el contenido de un objeto blob
ifx_update_char __ Actualiza el contenido de un objeto char
ifxus_close_slob __ Cierra un objeto slob
ifxus_create_slob __ Crea un objeto slob y lo abre
ifx_free_slob __ Elimina un objeto slob
ifxus_open_slob __ Abre un objeto slob
ifxus_read_slob __ Lee un número de bytes (nbytes) de un objeto slob
ifxus_seek_slob __ Define el fichero o posición en memoria
ifxus_tell_slob __ Devuelve el fichero actual o la posición en memoria
ifxus_write_slob __ Escribe una cadena en un objeto slob