CVS update: php3/functions

Date: Saturday September 19, 1998 @ 10:09 Author: danny Update of /repository/php3/functions In directory asf:/u2/tmp/cvs-serv20513/functions Modified Files: readme.ifx Log Message: ifx_htmltbl_result really returns number of rows processed, not TRUE. Index: php3/functions/readme.ifx diff -c php3/functions/readme.ifx:1.1 php3/functions/readme.ifx:1.2 *** php3/functions/readme.ifx:1.1 Fri Sep 18 16:56:01 1998 --- php3/functions/readme.ifx Sat Sep 19 10:09:41 1998 *************** *** 22,28 **** The configure script will autodetect the libraries and include directories, if you run "configure --with_informix=yes". You can overide this detection by specifying "IFX_LIBDIR", "IFX_LIBS" and ! "IFX_INCDIR" in the environment. The configure script will also try to detect your Informix server version. It will set the "HAVE_IFX_IUS" conditional compilation variable if your Informix version >= 9.00. --- 22,29 ---- The configure script will autodetect the libraries and include directories, if you run "configure --with_informix=yes". You can overide this detection by specifying "IFX_LIBDIR", "IFX_LIBS" and ! "IFX_INCDIR" in the environment, this allows you to enforce static linking ! if you prefer or need to. The configure script will also try to detect your Informix server version. It will set the "HAVE_IFX_IUS" conditional compilation variable if your Informix version >= 9.00. *************** *** 33,47 **** The current version (September 18, 1998) has complete select/insert/update support for BLOB columns. ! BLOBs are normally addressed by BLOB identifiers. Select queries return a "blob id" for every BYTE and TEXT column. ! You can get at the contents with "string_var = ifx_get_blob(blob_id);" if ! you choose to get the BLOBs in memory (ifx_blobinfile(0);). If you prefer to receive the content of BLOB columns in a file, use ! "ifx_blobinfile(1);", and "ifx_get_blob(blob_id) will get you the filename. Use normal file I/O to get at the blob contents. ! For insert/update queries you must create the "blob id's" yourself with "ifx_create_blob(..);". You then plug the blob id's into an array, and replace the blob columns with a question mark (?) in the query string. For updates/inserts, you are responsible for setting the blob contents with --- 34,48 ---- The current version (September 18, 1998) has complete select/insert/update support for BLOB columns. ! BLOBs are normally addressed by integer BLOB identifiers. Select queries return a "blob id" for every BYTE and TEXT column. ! You can get at the contents with "string_var = ifx_get_blob($blob_id);" if ! you choose to get the BLOBs in memory (with : "ifx_blobinfile(0);"). If you prefer to receive the content of BLOB columns in a file, use ! "ifx_blobinfile(1);", and "ifx_get_blob($blob_id);" will get you the filename. Use normal file I/O to get at the blob contents. ! For insert/update queries you must create these "blob id's" yourself with "ifx_create_blob(..);". You then plug the blob id's into an array, and replace the blob columns with a question mark (?) in the query string. For updates/inserts, you are responsible for setting the blob contents with *************** *** 50,55 **** --- 51,59 ---- The behaviour of BLOB columns can be altered by configuration variables that also can be set at runtime : + configuration variable : ifx.textasvarchar + configuration variable : ifx.byteasvarchar + runtime functions : ifx_textasvarchar(0) : use blob id's for select queries with TEXT columns ifx_byteasvarchar(0) : use blob id's for select queries with BYTE columns ifx_textasvarchar(1) : return TEXT columns as if they were VARCHAR columns, *************** *** 57,66 **** ifx_byteasvarchar(1) : return BYTE columns as if they were VARCHAR columns, without the use of blob id's for select queries. ! ifx_blobinfile(0) : return BYTE columns in memory, the blob id lets you ! get at the contents. ! ifx_blobinfile(1) : return BYTE columns in a file, the blob id lets you ! get at the file name. If you set ifx_text/byteasvarchar to 1, you can use TEXT and BYTE columns in select queries just like normal (but rather long) VARCHAR fields. --- 61,72 ---- ifx_byteasvarchar(1) : return BYTE columns as if they were VARCHAR columns, without the use of blob id's for select queries. ! configuration variable : ifx.blobinfile ! runtime function : ! ifx_blobinfile_mode(0) : return BYTE columns in memory, the blob id lets you ! get at the contents. ! ifx_blobinfile_mode(1) : return BYTE columns in a file, the blob id lets you ! get at the file name. If you set ifx_text/byteasvarchar to 1, you can use TEXT and BYTE columns in select queries just like normal (but rather long) VARCHAR fields. *************** *** 70,82 **** If you set ifx_blobinfile to 1, use the file name returned by ifx_get_blob(..) to get at the blob contents. Note that in this case YOU ARE RESPONSIBLE FOR ! DELETING THE TEMPORARY FILES CREATED BY INFORMIX. Every new row fetched will ! create new temporary files for every BYTE column. The location of the temporary files can be influenced by the environment variable "blobdir", default is "." (the current directory). ! Something like : putenv(blobdir=tmp"); will ease the cleaning up of temp files ! accidentally left behind (they all start with "blb"). --- 76,88 ---- If you set ifx_blobinfile to 1, use the file name returned by ifx_get_blob(..) to get at the blob contents. Note that in this case YOU ARE RESPONSIBLE FOR ! DELETING THE TEMPORARY FILES CREATED BY INFORMIX when fetching the row. ! Every new row fetched will create new temporary files for every BYTE column. The location of the temporary files can be influenced by the environment variable "blobdir", default is "." (the current directory). ! Something like : putenv(blobdir=tmpblob"); will ease the cleaning up of temp ! files accidentally left behind (their names all start with "blb"). *************** *** 161,173 **** Executes query $query on connection $conn_id. For "select-type" queries a cursor is declared and opened. The optional "HOLD" and "SCROLL" parameters allow you to make ! this a "scroll" and/or "hold" cursor. Non-select queries are "execute immediate". For either query type the number of (estimated or real) affected rows is saved for retrieval by "ifx_affected_rows()". ! If you have BLOB (BYTE or TEXT) columns in an update query, you can add a "blobid array" parameter containing the corresponding "blob ids", and you should replace those columns with a "?" in the query text. --- 167,179 ---- Executes query $query on connection $conn_id. For "select-type" queries a cursor is declared and opened. The optional "HOLD" and "SCROLL" parameters allow you to make ! this a "scroll" and/or "hold" cursor for select queries. Non-select queries are "execute immediate". For either query type the number of (estimated or real) affected rows is saved for retrieval by "ifx_affected_rows()". ! If you have BLOB (BYTE or TEXT) columns in an update query, you should add a "blobid array" parameter containing the corresponding "blob ids", and you should replace those columns with a "?" in the query text. *************** *** 201,207 **** -- Example 2 : insert some values into the "catalog" table -- ! // create blob id's for a byte and text column $textid = ifx_create_blob(0, 0, "Text column in memory"); $byteid = ifx_create_blob(1, 0, "Byte column in memory"); // store blob id's in a blobid array --- 207,213 ---- -- Example 2 : insert some values into the "catalog" table -- ! // create blob id's for a byte and a text column $textid = ifx_create_blob(0, 0, "Text column in memory"); $byteid = ifx_create_blob(1, 0, "Byte column in memory"); // store blob id's in a blobid array *************** *** 482,488 **** $htmltableoptions: HTML table tag options string, optional Returns: ! TRUE on success, FALSE on error Description: formats all rows of the $resultid query into a html table --- 488,494 ---- $htmltableoptions: HTML table tag options string, optional Returns: ! The number of rows read on success, FALSE on error Description: formats all rows of the $resultid query into a html table *************** *** 503,510 **** if (! ifx_do($rid) { ... error ... } ! ifx_htmltbl_result($rid, "border=\"2\""); ifx_free_result($rid); --- 509,518 ---- if (! ifx_do($rid) { ... error ... } + + $rowcount = ifx_htmltbl_result($rid, "border=\"2\""); ! printf("\n<br>There are %d rows in this table\n<br>", $rowcount); ifx_free_result($rid); -- PHP Development Mailing List http://www.php.net/ To unsubscribe send an empty message to php-dev-unsubscribe@lists.php.net For help: php-dev-help@lists.php.net