PHP4手册:函数库及函数(四十五) Solid 资料库连结函式库


--------------------------------------------------------------------------------
Solid 资料库连结函式库
--------------------------------------------------------------------------------
本函式库共有 10 个函式
理论上,使用标准的 ODBC 会比使用本函式好。当然也可以使用本函式,只是较不鼓励 Solid 函式库。
solid_close: 关闭 solid 连结。
solid_connect: 连结至 solid 资料库。
solid_exec: 执行 SQL 指令。
solid_fetchrow: 取得传回一列。
solid_fieldname: 取得栏位名称。
solid_fieldnum: 取得栏位数目。
solid_freeresult: 释出传回资料的记忆体。
solid_numfields: 取得栏位数目。
solid_numrows: 取得传回列数目。
solid_result: 取得传回资料。
--------------------------------------------------------------------------------
函式:solid_close()
--------------------------------------------------------------------------------
Solid 资料库连结函式库
solid_close
关闭 solid 连结。
语法: void solid_close(int connection_id);
传回值: 无
函式种类: 资料库功能
内容说明
本函式用来关闭与 solid 资料库之间的连结。参数 connection_id 为 solid 连结代号 ID 值。若正在执行 transactions 则无法关闭连结。
--------------------------------------------------------------------------------
函式:solid_connect()
--------------------------------------------------------------------------------
Solid 资料库连结函式库
solid_connect
连结至 solid 资料库。
语法: int solid_connect(string dsn, string user, string password, int [cursor_type]);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来连结到 solid 资料库,传回值为连结的代号 ID 值。参数 dsn 为资料来源名称 (Data Sources Name)。参数 user 及 password 分别为连结的帐号及密码。参数 cursor_type 通常省略,其值有 SQL_CUR_USE_IF_NEEDED、SQL_CUR_USE_ODBC、SQL_CUR_USE_DRIVER 及 SQL_CUR_DEFAULT 等四种。当使用复杂的资料存取时可能会有类似 "Cannot open a cursor on a stored procedure that has anything other than a single select statement in it" 的错误讯息字串,此时若将参数 cursor_type 的值设为 SQL_CUR_USE_ODBC 就可以避开了。
--------------------------------------------------------------------------------
函式:solid_exec()
--------------------------------------------------------------------------------
Solid 资料库连结函式库
solid_exec
执行 SQL 指令。
语法: int solid_exec(int connection_id, string query);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来执行 SQL 的 query 指令。参数 connection_id 为 ODBC 连结代号 ID 值。参数 query 则为欲执行的指令。传回值为 Result ID 值。
--------------------------------------------------------------------------------
函式:solid_fetchrow()
--------------------------------------------------------------------------------
Solid 资料库连结函式库
solid_fetchrow
取得传回一列。
语法: int solid_fetchrow(int result_id, int [row_number]);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来取得 Query 的传回资料的一列。参数 result_id 为 ODBC 传回 ID 值。参数 rownumber 可省略,为指定的取得列 (row)。
--------------------------------------------------------------------------------
函式:solid_fieldname()
--------------------------------------------------------------------------------
Solid 资料库连结函式库
solid_fieldname
取得栏位名称。
语法: string solid_fieldname(int result_id, int field_number);
传回值: 字串
函式种类: 资料库功能
内容说明
本函式用来取得 Query 的传回资料的栏位名称。参数 result_id 为 solid 传回 ID 值。参数 field_number 为指定的栏位,起始值为 1。
--------------------------------------------------------------------------------
函式:solid_fieldnum()
--------------------------------------------------------------------------------
Solid 资料库连结函式库
solid_fieldnum
取得栏位数目。
语法: int solid_fieldnum(int result_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来取得传回资料的栏位数目。参数 result_id 为 solid 传回 ID 值。若发生错误则传回 -1。
--------------------------------------------------------------------------------
函式:solid_freeresult()
--------------------------------------------------------------------------------
Solid 资料库连结函式库
solid_freeresult
释出传回资料的记忆体。
语法: int solid_freeresult(int result_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式可用来释出传回资料所使用的记忆体,通常在系统记忆体资源不足的情形下才需要使用。参数 result_id 为 solid 传回 ID 值。传回值永远都是 true
--------------------------------------------------------------------------------
函式:solid_numfields()
--------------------------------------------------------------------------------
Solid 资料库连结函式库
solid_numfields
取得栏位数目。
语法: int solid_numfields(int result_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来取得传回资料的栏位数目。参数 result_id 为 solid 传回 ID 值。若发生错误则传回 -1。
--------------------------------------------------------------------------------
函式:solid_numrows()
--------------------------------------------------------------------------------
Solid 资料库连结函式库
solid_numrows
取得传回列数目。
语法: int solid_numrows(int result_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来取得传回列的数目。参数 result_id 为 solid 传回 ID 值。若有错误发生则传回 -1。
--------------------------------------------------------------------------------
函式:solid_result()
--------------------------------------------------------------------------------
Solid 资料库连结函式库
solid_result
取得传回资料。
语法: string solid_result(int result_id, mixed field);
传回值: 字串
函式种类: 资料库功能
内容说明
本函式用来取得传回的资料。参数 result_id 为 solid 传回 ID 值。参数 field 可以是数字形态,代表指定的栏位序号 (从 1 开始);亦可以是字串形态,为指定的栏位名称。