PHP4手册:函数库及函数(一) Adabas D 资料库连结函式库
December 21th,2008 22:39:58 Category :
PHP+Mysql
Click (1116)
--------------------------------------------------------------------------------
Adabas D 资料库连结函式库
--------------------------------------------------------------------------------
本函式库共有 15 个函式
在使用 PHP 与资料库的结合上，用 Adabas D 函式库是较不好的方法，建议使用业界标准的 ODBC 函式库取代 Adabas D 函式库。
ada_afetch: 取得资料库的传回列。
ada_autocommit: 开关自动更动功能。
ada_close: 关闭 Adabas D 连结。
ada_commit: 更动 Adabas D 资料库。
ada_connect: 连结至 Adabas D 资料库。
ada_exec: 执行 SQL 指令。
ada_fetchrow: 取得传回一列。
ada_fieldname: 取得栏位名称。
ada_fieldtype: 取得栏位资料形态。
ada_freeresult: 释出传回资料的记忆体。
ada_numfields: 取得栏位数目。
ada_numrows: 取得传回列数目。
ada_result: 取得传回资料。
ada_resultall: 传回 HTML 表格资料。
ada_rollback: 撤消当前交易。
--------------------------------------------------------------------------------
函式:ada_afetch()
--------------------------------------------------------------------------------
ada_afetch
取得资料库的传回列。
语法: int ada_afetch(int result_id, int rownumber, array result_array);
传回值: 整数
函式种类: 资料库功能
内容说明
将资料库传回的列资料 (row) 放入阵列变数中。参数 result_id 为资料库传回 ID 值。参数 rownumber 为指定的取得列 (row)。阵列参数 result_array 为取得列的资料阵列，通常在前面加上 "&" 符号。
参考
odbc_fetch_into()
--------------------------------------------------------------------------------
函式:ada_autocommit()
--------------------------------------------------------------------------------
ada_autocommit
开关自动更动功能。
语法: int ada_autocommit(int connection_id, int [OnOff]);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来开启或关闭自动更新 (auto-commit) 功能。参数 connection_id 为资料库连结的 ID 值。参数 OnOff 可省略，表开启或关闭自动更动功能，内定值为 on，欲关闭则设 off。传回值为目前的自动更新状态，若开启自动更新功能则传回 true；若关闭自动更新功能则传回 false。
参考
odbc_autocommit()
--------------------------------------------------------------------------------
函式:ada_close()
--------------------------------------------------------------------------------
ada_close
关闭 Adabas D 连结。
语法: void ada_close(int connection_id);
传回值: 无
函式种类: 资料库功能
内容说明
本函式用来关闭与 Adabas D 资料库之间的连结。参数 connection_id 为资料库连结代号 ID 值。若正在执行 transactions 则无法关闭连结。
参考
odbc_close()
--------------------------------------------------------------------------------
函式:ada_commit()
--------------------------------------------------------------------------------
ada_commit
更动 Adabas D 资料库。
语法: int ada_commit(int connection_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来更动 (commit) Adabas D 资料库。参数 connection_id 为资料库连结的 ID 值。若有设定 ada_autocommit() 成自动更动资料库时，则不需使用本函式。
参考
odbc_commit()
--------------------------------------------------------------------------------
函式:ada_connect()
--------------------------------------------------------------------------------
ada_connect
连结至 Adabas D 资料库。
语法: int ada_connect(string dsn, string user, string password);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来连结到 Adabas D 资料库，传回值为连结的代号 ID 值。参数 dsn 为资料来源名称 (Data Sources Name)。参数 user 及 password 分别为连结的帐号及密码。
参考
odbc_connect()
--------------------------------------------------------------------------------
函式:ada_exec()
--------------------------------------------------------------------------------
ada_exec
执行 SQL 指令。
语法: int ada_exec(int connection_id, string query);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来执行 SQL 的 query 指令。参数 connection_id 为 Adabas D 连结代号 ID 值。参数 query 则为欲执行的指令。传回值为 Result ID 值。
参考
odbc_exec()
--------------------------------------------------------------------------------
函式:ada_fetchrow()
--------------------------------------------------------------------------------
ada_fetchrow
取得传回一列。
语法: int ada_fetchrow(int result_id, int [row_number]);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来取得 Query 的传回资料的一列。参数 result_id 为 Adabas D 传回 ID 值。参数 rownumber 可省略，为指定的取得列 (row)。
参考
odbc_fetch_row()
--------------------------------------------------------------------------------
函式:ada_fieldname()
--------------------------------------------------------------------------------
ada_fieldname
取得栏位名称。
语法: string ada_fieldname(int result_id, int field_number);
传回值: 字串
函式种类: 资料库功能
内容说明
本函式用来取得 Query 的传回资料的栏位名称。参数 result_id 为 Adabas D 资料库传回 ID 值。参数 field_number 为指定的栏位，起始值为 1。
参考
odbc_field_name()
--------------------------------------------------------------------------------
函式:ada_fieldtype()
--------------------------------------------------------------------------------
ada_fieldtype
取得栏位资料形态。
语法: string ada_fieldtype(int result_id, int field_number);
传回值: 字串
函式种类: 资料库功能
内容说明
本函式用来取得 Query 的传回资料的栏位资料形态。参数 result_id 为 Adabas D 传回 ID 值。参数 field_number 为指定的栏位，起始值为 1。
参考
odbc_field_type()
--------------------------------------------------------------------------------
函式:ada_freeresult()
--------------------------------------------------------------------------------
ada_freeresult
释出传回资料的记忆体。
语法: int ada_freeresult(int result_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式可用来释出传回资料所使用的记忆体，通常在系统记忆体资源不足的情形下才需要使用。参数 result_id 为 Adabas D 传回 ID 值。传回值永远都是 true。
参考
odbc_free_result()
--------------------------------------------------------------------------------
函式:ada_numfields()
--------------------------------------------------------------------------------
ada_numfields
取得栏位数目。
语法: int ada_numfields(int result_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来取得传回资料的栏位数目。参数 result_id 为 Adabas D 传回 ID 值。若发生错误则传回 -1。
参考
odbc_num_fields()
--------------------------------------------------------------------------------
函式:ada_numrows()
--------------------------------------------------------------------------------
ada_numrows
取得传回列数目。
语法: int ada_numrows(int result_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来取得传回列的数目。参数 result_id 为 Adabas D 资料库传回 ID 值。若有错误发生则传回 -1。
参考
odbc_num_rows()
--------------------------------------------------------------------------------
函式:ada_result()
--------------------------------------------------------------------------------
ada_result
取得传回资料。
语法: string ada_result(int result_id, mixed field);
传回值: 字串
函式种类: 资料库功能
内容说明
本函式用来取得传回的资料。参数 result_id 为 Adabas D 传回 ID 值。参数 field 可以是数字形态，代表指定的栏位序号 (从 1 开始)；亦可以是字串形态，为指定的栏位名称。
参考
odbc_result()
--------------------------------------------------------------------------------
函式:ada_resultall()
--------------------------------------------------------------------------------
ada_resultall
传回 HTML 表格资料。
语法: int ada_resultall(int result_id, string [format]);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式用来将取得的资料转成 HTML 的表格 (table) 格式。参数 result_id 为 Adabas D 传回 ID 值。参数 format 可省略，为表格的特殊设定值。传回值为资料列数。
参考
odbc_result_all()
--------------------------------------------------------------------------------
函式:ada_rollback()
--------------------------------------------------------------------------------
ada_rollback
撤消当前交易。
语法: int ada_rollback(int connection_id);
传回值: 整数
函式种类: 资料库功能
内容说明
本函式取消 Adabas D 交易处理 (transaction) 对资料库所做的修改。若成功则传回 true，反之传回 false。
参考
odbc_rollback()
