PHP4手册:函数库及函数(二十二) Informix 资料库函式库


--------------------------------------------------------------------------------
Informix 资料库函式库
--------------------------------------------------------------------------------
本函式库共有 38 个函式
目前支援的 Informix 版本为 ODS 7.x、SE 7.x 与 Universal Server (IUS) 9.x 三种。在 ODS 7.x 的版本中,完全支援所有的资料型态,而在 IUS 9.x 中,不支援 SLOB 与 CLOB 二种型态。
要在 Web Server 上安装 Informix Client 端,在编译 PHP 之前 (configure 之前),要先设好 IFX_LIBDIR、IFX_LIBS 及 IFX_INCDIR 三种环境变数,若是 9.x 版尚要设定 HAVE_IFX_IUS 环境变数。同时在设定时要加入 --with_informix=yes 的选项。
ifx_connect: 开启 Informix 伺服器连线。
ifx_pconnect: 开启 Informix 伺服器长期连线。
ifx_close: 关闭 Informix 伺服器连线。
ifx_query: 送出一个 query 字串。
ifx_prepare: 准备 query 字串。
ifx_do: 执行已准备 query 字串。
ifx_error: 取得 Informix 最后的错误。
ifx_errormsg: 取得 Informix 最后错误讯息。
ifx_affected_rows: 得到 Informix 最后操作影响的列数目。
ifx_getsqlca: 取得 query 后的 sqlca 资讯。
ifx_fetch_row: 传回单列的各栏位。
ifx_htmltbl_result: 将 query 传回资料转成 HTML 表格。
ifx_fieldtypes: 列出 Informix 的 SQL 栏位。
ifx_fieldproperties: 列出 Informix 的 SQL 栏位属性。
ifx_num_fields: 取得传回栏位的数目。
ifx_num_rows: 取得传回列的数目。
ifx_free_result: 释放传回占用记忆体。
ifx_create_char: 建立字元物件。
ifx_free_char: 删除字元物件。
ifx_update_char: 更改字元物件。
ifx_get_char: 取得字元物件。
ifx_create_blob: 建立长位元物件。
ifx_copy_blob: 复制长位元物件。
ifx_free_blob: 删除长位元物件。
ifx_get_blob: 取得长位元物件。
ifx_update_blob: 更改长位元物件。
ifx_blobinfile_mode: 设定长位元物件模式。
ifx_textasvarchar: 设定文字模式内定值。
ifx_byteasvarchar: 设定位元组模式内定值。
ifx_nullformat: 设定空字元模式内定值。
ifxus_create_slob: 建立 slob 物件。
ifx_free_slob: 删除 slob 物件。
ifxus_close_slob: 删除 slob 物件。
ifxus_open_slob: 开启 slob 物件。
ifxus_tell_slob: 传回目前档案或找寻位置。
ifxus_seek_slob: 设定目前档案或找寻位置。
ifxus_read_slob: 读取指定数目的 slob 物件。
ifxus_write_slob: 将字串写入 slob 物件中。
--------------------------------------------------------------------------------
函式:ifx_connect()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_connect
开启 Informix 伺服器连线。
语法: int ifx_connect(string [database], string [userid], string [password]);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式建立与 Informix 伺服器的连线。其中所有的参数都可省略。若全部参数都省略时,使用系统的 php3.ini 或是 php.ini (视 PHP 版本决定) 中 ifx.default_host 指定的机器,或是环境变数 $INFORMIXSERVER;ifx.default_user 为使用者帐号;ifx.default_password 为使用者密码。而参数 database、userid 及 password 分别为资料库的名字、登入帐号及使用密码。当然,在使用本函式之后,尽早使用 ifx_close() 关闭 Informix 资料库比较好。连线成功则传回连线代码,失败则传回 false 值。
使用范例
本例只有连上资料库,什么事都没做。
$conn_id = ifx_pconnect("mydb@ol_srv1", "imyself", "mypassword");
ifx_close($conn_id);
?>
参考
ifx_pconnect() ifx_close()
--------------------------------------------------------------------------------
函式:ifx_pconnect()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_pconnect
开启 Informix 伺服器长期连线。
语法: int ifx_pconnect(string [database], string [userid], string [password]);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式与 ifx_connect() 很类似。不同的地方在于使用本函式开启资料库时,程式会先寻找是否曾经执行过本函式,若执行过则传回先前执行的 ID。另一个不同的地方是本函式无法使用 ifx_close() 关闭资料库。
参考
ifx_connect() ifx_close()
--------------------------------------------------------------------------------
函式:ifx_close()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_close
关闭 Informix 伺服器连线。
语法: boolean ifx_close(int [link_identifier]);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式关闭与 Informix 资料库伺服器的连线。若无指定参数 link_identifier 则会关闭最后的一笔连线。用 ifx_pconnect() 连线则无法使用本函式关闭。本函式可以省略,当 PHP 整页程式结束后,将会自动关闭与资料库的非永久性 (non-persistent) 连线。传回值均为 true。
--------------------------------------------------------------------------------
函式:ifx_query()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_query
送出一个 query 字串。
语法: int ifx_query(string query, int [link_identifier], int [cursor_type], mixed [blobidarray]);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式送出 query 字串供 Informix 做相关的处理动作。若没有指定 link_identifier 参数,则程式会自动寻找最近开启的 ID。参数 cursor_type 可省略,其值有 IFX_SCROLL 与 IFX_HOLD 二种。若有 BLOB 的栏位要加在 query 指令之中,可使用 blobidarray 参数,指定 BLOB 的代码。
使用范例
例一:
// 之前的程式省略
ifx_textasvarchar(1); // 使用文字模式 (text mode) 的 blobs
$res_id = ifx_query("select * from orders", $conn_id);
if (! $res_id) {
printf("无法取出 orders 资料表 : %s\n
%s
\n", ifx_error());
ifx_errormsg();
die;
}
ifx_htmltbl_result($res_id, "border=\"1\"");
ifx_free_result($res_id);
// 之后的程式省略
?>
例二:
// 之前的程式省略
//
// 为二进位及文字建立 BLOB 代码
$textid = ifx_create_blob(0, 0, "Text column in memory");
$byteid = ifx_create_blob(1, 0, "Byte column in memory");
$blobidarray[] = $textid;
$blobidarray[] = $byteid;
$query = "insert into catalog (stock_num, manu_code, " ."cat_descr,cat_picture) values(1,'HRO',?,?)";
$res_id = ifx_query($query, $conn_id, $blobidarray);
if (! $res_id) {
// 错误处理
}
ifx_free_result($res_id);
// 之后程式省略
?>
--------------------------------------------------------------------------------
函式:ifx_prepare()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_prepare
准备 query 字串。
语法: int ifx_prepare(string query, int link_identifier, int [cursor_type], mixed blobidarray);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式准备 query 字串供 Informix 接着做相关的处理。若没有指定 link_identifier 参数,则程式会自动寻找最近开启的 ID。参数 cursor_type 可省略,其值有 IFX_SCROLL 与 IFX_HOLD 二种。若有 BLOB 的栏位要加在 query 指令之中,可使用 blobidarray 参数,指定 BLOB 的代码。传回值可供 ifx_do() 使用。
--------------------------------------------------------------------------------
函式:ifx_do()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_do
执行已准备 query 字串。
语法: boolean ifx_do(int result_id);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式用来执行已经由 ifx_prepare() 函式所准备的字串。参数 result_id 即为 ifx_prepare() 所传回的待执行代码。成功则传回 true,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_error()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_error
取得 Informix 最后的错误。
语法: string ifx_error(void);
传回值: 字串
函式种类: 资料库功能
内容说明
本函式用来取得 Informix 资料库最后的错误资讯,本函式无须加入任何参数。传回的字串如以下的格式
X [SQLSTATE=aa bbb SQLCODE=c]
其中的 X 代表错误讯息的种类,见下表
字元 代表种类
空格 无错误
E 错误 (Error)
N 无资料
W 警告 (Warning)
? 其它未定义
至于 aa、bbb、c 表示数字资料,并分别为二位、三位及一位数。更多有关细节参考 Informix 手册中有关 SQLSTATE 与 SQLCODE 的资讯。
参考
ifx_errormsg()
--------------------------------------------------------------------------------
函式:ifx_errormsg()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_errormsg
取得 Informix 最后错误讯息。
语法: string ifx_errormsg(int [errorcode]);
传回值: 字串
函式种类: 资料库功能
内容说明
本函式用来取得 Informix 资料库最后的错误讯息字串。参数 errorcode 代表错误代码。
使用范例
本例为部份程式
printf("%s\n
", ifx_errormsg(-201));
?>
参考
ifx_error()
--------------------------------------------------------------------------------
函式:ifx_affected_rows()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_affected_rows
得到 Informix 最后操作影响的列数目。
语法: int ifx_affected_rows(int result_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式可得到 Informix 最后查询操作 INSERT、UPDATE 或 DELETE 所影响的列 (row) 数目。若最后使用的是 SELECT,则用本函式得到的数目为估计值,而非精确的数目,欲得到 SELECT 传回的数目需使用 ifx_num_rows() 函式。
使用范例
本例为部份程式
$rid = ifx_prepare ("select * from userinfo where name like " . $name, $connid);
if (! $rid) {
// 错误处理的部份
}
$rowcount = ifx_affected_rows ($rid);
if ($rowcount > 1000) {
printf ("传回资料太多,共 %d 笔\n
", $rowcount);
die ("请重新执行 SQL 指令
\n");
}
?>
参考
ifx_num_rows()
--------------------------------------------------------------------------------
函式:ifx_getsqlca()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_getsqlca
取得 query 后的 sqlca 资讯。
语法: array ifx_getsqlca(int result_id);
传回值: 阵列
函式种类: 资料库功能
内容说明
本函式可得到 Informix 最后查询操作后的 sqlca 结构 (struct) 中的相关资讯。参数 result_id 是经过 ifx_query() 及 ifx_prepare() 的传回代号。本函式传回的阵列其实就是 sqlca.sqlerrd[0] 到 sqlca.sqlerrd[5] 等六个元素的阵列。
使用范例
下例为部份程式
$qid = ifx_query("insert into sometable values(0, '2nd column', 'another column' ", $connid);
if (! $qid) {
// 错误处理
}
$sqlca = ifx_getsqlca ($qid);
$serial_value = $sqlca["sqlerrd1"];
echo "插入列序号为: " . $serial_value
n";
?>
--------------------------------------------------------------------------------
函式:ifx_fetch_row()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_fetch_row
传回单列的各栏位。
语法: array ifx_fetch_row(int result_id, mixed [position]);
传回值: 阵列
函式种类: 资料库功能
内容说明
本函式用来将查询结果 result 之单列拆到阵列变数中。阵列的索引是数字索引,第一个的索引值是 0。若 result 没有资料,则传回 false 值。参数 position 可省略,是所谓的卷动游标 (scroll cursor),可能值为:NEXT、PREVIOUS、CURRENT、FIRST 或者 LAST;亦可能为数字,表示指定为第几列。
使用范例
以下的范例为连上 Informix 资料库后的动作
$rid = ifx_prepare("select * from emp where name like ".$name, $connid, IFX_SCROLL);
if (! $rid) {
// 错误处理
}
$rowcount = ifx_affected_rows($rid);
if ($rowcount > 1000) {
printf ("传回资料太多,共 %d 笔\n
", $rowcount);
die ("请重新执行 SQL 指令
\n");
}
if (! ifx_do ($rid)) {
// 错误处理
}
$row = ifx_fetch_row($rid, "NEXT");
while (is_array($row)) {
for(reset($row); $fieldname=key($row); next($row)) {
$fieldvalue = $row[$fieldname];
printf("%s = %s,", $fieldname, $fieldvalue);
}
printf("\n
");
$row = ifx_fetch_row($rid, "NEXT");
}
ifx_free_result($rid);
?>
--------------------------------------------------------------------------------
函式:ifx_htmltbl_result()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_htmltbl_result
将 query 传回资料转成 HTML 表格。
语法: int ifx_htmltbl_result(int result_id, string [html_table_options]);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来将 query 查询结果格式化成 HTML 标记格式的表格形式。参数 html_table_options 可省略,为 标记中的参数选项。成功则传回列数,失败则传回 false 值。
使用范例
以下的范例中, 标记的参数设表格边宽为 2。
$rid = ifx_prepare("select * from emp where name like ".$name, $connid, IFX_SCROLL);
if (! $rid) {
// 错误处理
}
$rowcount = ifx_affected_rows($rid);
if ($rowcount > 1000) {
printf ("传回资料太多,共 %d 笔\n
", $rowcount);
die ("请重新执行 SQL 指令
\n");
}
if (! ifx_do($rid) {
// 错误处理
}
ifx_htmltbl_result($rid, "border=\"2\"");
ifx_free_result($rid);
?>
--------------------------------------------------------------------------------
函式:ifx_fieldtypes()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_fieldtypes
列出 Informix 的 SQL 栏位。
语法: array ifx_fieldtypes(int result_id);
传回值: 阵列
函式种类: 资料库功能
内容说明
本函式可以获得 Informix 的 SQL 指令传回的栏位。参数 result_id 是经过 ifx_query() 或 ifx_prepare() 的传回代号。
使用范例
本例为程式的一部份
$types = ifx_fieldtypes($resultid);
if (! isset($types)) {
// 错误处理
}
for ($i = 0; $i < count($types); $i++) {
$fname = key($types);
printf("%s :\t 型态为: %s\n", $fname, $types[$fname]);
next($types);
}
?>
--------------------------------------------------------------------------------
函式:ifx_fieldproperties()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_fieldproperties
列出 Informix 的 SQL 栏位属性。
语法: array ifx_fieldproperties(int result_id);
传回值: 阵列
函式种类: 资料库功能
内容说明
本函式可以获得 Informix 的 SQL 指令传回栏位的属性。参数 result_id 是经过 ifx_query() 或 ifx_prepare() 的传回代号。
使用范例
本例为程式的一部份
$properties = ifx_fieldtypes($resultid);
if (! isset($properties)) {
// 错误处理
}
for ($i = 0; $i < count($properties); $i++) {
$fname = key($properties);
printf("%s:\t type = %s\n", $fname, $properties[$fname]);
next($properties);
}
?>
--------------------------------------------------------------------------------
函式:ifx_num_fields()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_num_fields
取得传回栏位的数目。
语法: int ifx_num_fields(int result_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式可以得到传回栏位的数目。参数 result_id 是经过 ifx_query() 或 ifx_prepare() 的传回代号。若发生错误则传回 false 值。
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
函式:ifx_num_rows()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_num_rows
取得传回列的数目。
语法: int ifx_num_rows(int result_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式可以得到 Informix 资料库传回列的数目。参数 result_id 是经过 ifx_query() 或 ifx_do() 的传回代号。若发生错误则传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_free_result()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_free_result
释放传回占用记忆体。
语法: boolean ifx_free_result(int result_id);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式可以释放目前 Informix 资料库 query 传回所占用的记忆体。一般只有在非常担心在记忆体的使用上可能会不足的情形下才会用本函式,因为 PHP 程式会在结束时自动释放。发生错误则传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_create_char()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_create_char
建立字元物件。
语法: int ifx_create_char(string param);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来建立字元 (char) 物件。参数 param 为字元的内容。成功则传回字元的物件代码,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_free_char()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_free_char
删除字元物件。
语法: boolean ifx_free_char(int bid);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式用来删除字元 (char) 物件。参数 bid 为字元的物件代码。执行成功则传回 true 值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_update_char()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_update_char
更改字元物件。
语法: boolean ifx_update_char(int bid, string content);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式用来更改字元 (char) 物件。参数 bid 为字元的物件代码。参数 content 为欲使用的新字元。执行成功则传回 true 值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_get_char()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_get_char
取得字元物件。
语法: string ifx_get_char(int bid);
传回值: 字串
函式种类: 资料库功能
内容说明
本函式用来取得字元 (char) 物件。参数 bid 为字元的物件代码。传回值为字元的内容。
--------------------------------------------------------------------------------
函式:ifx_create_blob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_create_blob
建立长位元物件。
语法: int ifx_create_blob(int type, int mode, string param);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来建立长位元 (blob) 物件。参数 type 表示 blob 的型态,1 表文字资料;0 表位元资料。参数 mode 为长位元资料的存放处,0 表在记忆体;1 表在档案中。参数 param 为 blob 的内容,若 mode 为 0 则为记忆体指标;若 mode 为 1 则为档名。成功则传回长位元的物件代码,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_copy_blob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_copy_blob
复制长位元物件。
语法: int ifx_copy_blob(int bid);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来复制长位元 (blob) 物件。参数 bid 为 blob 物件代码。成功则传回新的长位元物件代码,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_free_blob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_free_blob
删除长位元物件。
语法: boolean ifx_free_blob(int bid);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式用来删除长位元 (blob) 物件。参数 bid 为 blob 物件代码。执行成功则传回 true 值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_get_blob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_get_blob
取得长位元物件。
语法: string ifx_get_blob(int bid);
传回值: 字串
函式种类: 资料库功能
内容说明
本函式用来取得长位元 (blob) 物件。参数 bid 为长位元的物件代码。传回值为 blob 物件的内容。
--------------------------------------------------------------------------------
函式:ifx_update_blob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_update_blob
更改长位元物件。
语法: boolean ifx_update_blob(int bid, string content);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式用来更改长位元 (blob) 物件。参数 bid 为 blob 物件代码。参数 content 为欲使用新的 blob 资料。执行成功则传回 true 值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_blobinfile_mode()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_blobinfile_mode
设定长位元物件模式。
语法: boolean ifx_blobinfile_mode(int mode);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式用来设定所有 select 的 SQL 指令用到的长位元 (blob) 物件模式内定值。参数 mode 的值为储存 blob 资料的地点, 0 表在记忆体;1 表在档案中。执行成功则传回 true 值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_textasvarchar()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_textasvarchar
设定文字模式内定值。
语法: boolean ifx_textasvarchar(int mode);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式用来设定所有 select 的 SQL 指令用到的文字 (text) 物件模式内定值。参数 mode 的值为 0 表传回 blob 的代码;1 表传回 varchar 字串。执行成功则传回 true 值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_byteasvarchar()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_byteasvarchar
设定位元组模式内定值。
语法: boolean ifx_byteasvarchar(int mode);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式用来设定所有 select 的 SQL 指令用到的位元组 (byte) 物件模式内定值。参数 mode 的值为 0 表传回 blob 的代码;1 表传回 varchar 字串。执行成功则传回 true 值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_nullformat()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_nullformat
设定空字元模式内定值。
语法: boolean ifx_nullformat(int mode);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式用来设定所有 select 的 SQL 指令用到的空字元 (null) 物件模式内定值。参数 mode 的值为 0 表传回 "" (空字串);1 表传回 NULL 字串。执行成功则传回 true 值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifxus_create_slob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifxus_create_slob
建立 slob 物件。
语法: int ifxus_create_slob(int mode);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来建立 slob 物件。参数 mode 值如下表
数值 常数
1 LO_RDONLY
2 LO_WRONLY
4 LO_APPEND
8 LO_RDWR
16 LO_BUFFER
32 LO_NOBUFFER
当然也 mode 可以直接使用常数值,如 IFX_LO_RDONLY。若有需要,可使用数字相加,使 mode 值更有变化。成功则传回 slob 的物件代码,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifx_free_slob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifx_free_slob
删除 slob 物件。
语法: boolean ifxus_free_slob(int bid);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式用来删除 slob 物件。参数 bid 为 slob 物件代码。执行成功则传回 true 值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifxus_close_slob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifxus_close_slob
删除 slob 物件。
语法: boolean ifxus_close_slob(int bid);
传回值: 布林值
函式种类: 资料库功能
内容说明
本函式用来删除 slob 物件。参数 bid 为 slob 物件代码。执行成功则传回 true 值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifxus_open_slob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifxus_open_slob
开启 slob 物件。
语法: int ifxus_open_slob(long bid, int mode);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来开启 slob 物件。参数 bid 为 slob 物件代码。参数 mode 值如下表
数值 常数
1 LO_RDONLY
2 LO_WRONLY
4 LO_APPEND
8 LO_RDWR
16 LO_BUFFER
32 LO_NOBUFFER
当然也 mode 可以直接使用常数值,如 IFX_LO_RDONLY。若有需要,可使用数字相加,使 mode 值更有变化。成功则传回 slob 的物件代码,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifxus_tell_slob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifxus_tell_slob
传回目前档案或找寻位置。
语法: int ifxus_tell_slob(long bid);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式传回目前档案或者找寻档案的位置。参数 bid 为 slob 物件代码。执行成功则传回代码值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifxus_seek_slob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifxus_seek_slob
设定目前档案或找寻位置。
语法: int ifxus_seek_blob(long bid, int mode, long offset);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来设定目前档案或找寻档案的位置。参数 bid 为 slob 物件代码。参数 mode 的值如下:0 表 LO_SEEK_SET、1 表 LO_SEEK_CUR、2 表 LO_SEEK_END。参数 offset 为位元组偏移值。执行成功则传回代码值,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifxus_read_slob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifxus_read_slob
读取指定数目的 slob 物件。
语法: string ifxus_read_slob(long bid, long nbytes);
传回值: 字串
函式种类: 资料库功能
内容说明
本函式用来读取指定位元数的 slob 物件。参数 bid 为 slob 物件代码。参数 nbytes 为位元组数目。执行成功则传回 slob 部份字串,失败传回 false 值。
--------------------------------------------------------------------------------
函式:ifxus_write_slob()
--------------------------------------------------------------------------------
Informix 资料库函式库
ifxus_write_slob
将字串写入 slob 物件中。
语法: int ifxus_write_slob(long bid, string content);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式将指定字串写入 slob 物件之中。参数 bid 为 slob 物件代码。参数 content 为待写入字串。执行成功则传回写入字元数,失败传回 false 值。