Sybase 数据库函数库

这个函数库和 函数库几乎完全相同，实际上是本函数先出现，之后才出现 sql server 数据库函数库。而就用户观点 sybase 和 ms sql server 6.x 也是几乎相同的。当然 ms sql server 7.0 之后的差异就比较大了。

sybase_affected_rows: 取得最后 query 影响的列数。
sybase_close: 关闭与数据库的连接。
sybase_connect: 连上数据库。
sybase_data_seek: 移动列指针。
sybase_fetch_array: 返回数组资料。
sybase_fetch_field: 取得字段信息。
sybase_fetch_object: 返回类资料。
sybase_fetch_row: 返回单列的各字段。
sybase_field_seek: 配置指针到返回值的某字段。
sybase_free_result: 释放返回占用内存。
sybase_num_fields: 取得返回字段的数目。
sybase_num_rows: 取得返回列的数目。
sybase_pconnect: 打开服务器持续连接。
sybase_query: 送出一个 query 字符串。
sybase_result: 取得查询 (query) 的结果。
sybase_select_db: 选择一个数据库。

sybase_affected_rows
取得最后 query 影响的列数。
语法: int sybase_affected_rows(int [link_identifier]);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数用来取得最后一次对数据库下 query 指令所影响的列数，会影响的为 insert、update 或 delete 等指令，而 select 不会影响。参数 link_identifier 可省略，为打开数据库的连接代号。返回值即为列数。

sybase_close
关闭与数据库的连接。
语法: boolean sybase_close(int link_identifier);
返回值: 布尔值
函数种类: 数据库功能
内容说明: 本函数用来关闭与 sybase 数据库的连接，能关闭的为使用 sybase_connect() 函数打开的数据库，若使用 sybase_pconnect() 打开的数据库则不能以本函数关闭。参数 link_identifier 可省略，为打开数据库的连接代号。关闭成功则返回 true 值。
参考: sybase_connect() sybase_pconnect()

sybase_connect
连上数据库。
语法: int sybase_connect(string [servername], string [username], string [password]);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数用来打开与 sybase 数据库的连接。参数 servername 为欲连上的数据库服务器名称。参数 username 及 password 可省略，分别为连接使用的帐号及密码。使用本函数需注意早点关闭数据库，以减少系统的负担。连接成功则返回数据库的连接代号，失败返回 false 值。
参考: sybase_close() sybase_pconnect()

sybase_data_seek
移动列指针。
语法: boolean sybase_data_seek(int result_identifier, int row_number);
返回值: 布尔值
函数种类: 数据库功能
内容说明: 本函数用来移动 sybase 资料表中的列指针到指定的列上，可供 sybase_fetch_row() 等函数使用。参数 result_identifier 为查询的代号值。参数 row_number 则为欲移往的列数。若失败则返回 false 值。
参考: sybase_close() sybase_pconnect()

sybase_fetch_array
返回数组资料。
语法: array sybase_fetch_array(int result);
返回值: 数组
函数种类: 数据库功能
内容说明: 本函数用来将查询结果 result 拆到数组变量中。若 result 没有资料，则返回 false 值。而本函数可以说是 sybase_fetch_row() 的加强函数，除可以将返回列及数字索引放入数组之外，还可以将文字索引放入数组中。
使用范例
这是 [e-mail] (22-feb-1999) 所提出的例子
$q = sybase_query("select count(distinct opportunity_id) from m_opp_interests where interest_id = $i_id", $db);
while ($op_by_int = sybase_fetch_array($q)) {
while (list($k, $v) = each($op_by_int)) {
echo "\$op[$k] => $v\n";
}
?>
返回资料如下
$op[0] => 2164
$op[computed] => 2164

sybase_fetch_field
取得字段信息。
语法: object sybase_fetch_field(int result, int field_offset);
返回值: 类
函数种类: 数学运算
内容说明: 本函数返回的类资料为 result 的字段 (column) 信息。返回类的属性如下：
name - 字段名称
column_source -字段所在表格的资料表名称
max_length - 字段的最大长度
numeric - 若为 1 表示本字段为数字类型 (numeric)
参考: sybase_field_seek()

sybase_fetch_object
返回类资料。
语法: object sybase_fetch_object(int result);
返回值: 类
函数种类: 数据库功能
内容说明: 本函数用来将查询结果 result 拆到类变量中。使用和 sybase_fetch_array() 几乎相同，不同的地方在于本函数返回资料是类而不是数组。若 result 没有资料，则返回 false 值。另外值得注意的地方是，取回的类资料的索引只能是文字而不能用数字，这是因为类的特性。类资料的特性中所有的属性 (property) 名称都不能是数字，因此只好乖乖使用文字字符串当索引了。关于速度方面，本函数的处理速度几乎和 sybase_fetch_array() 及 sybase_fetch_row() 二函数差不多，要用哪个函数还是看使用的需求决定。
参考: sybase_fetch_array() sybase_fetch_row()

sybase_fetch_row
返回单列的各字段。
语法: array sybase_fetch_row(int result);
返回值: 数组
函数种类: 数据库功能
内容说明: 本函数用来将查询结果 result 之单列拆到数组变量中。数组的索引是数字索引，第一个的索引值是 0。若 result 没有资料，则返回 false 值。
参考: sybase_fetch_array() sybase_fetch_object() sybase_data_seek() sybase_result()

sybase_field_seek
配置指针到返回值的某字段。
语法: int sybase_field_seek(int result, int field_offset);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数配置目前的指针到返回值的特定字段中。参数 result 为返回值。参数 field_offset 则为指定的字段序数。
参考: sybase_fetch_field()

sybase_free_result
释放返回占用内存。
语法: int sybase_free_result(int result);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数可以释放目前 sybase 数据库 query 返回所占用的内存。一般只有在非常担心在内存的使用上可能会不足的情形下才会用本函数。php 程序会在结束时自动释放。

sybase_num_fields
取得返回字段的数目。
语法: int sybase_num_fields(int result);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数可以得到返回字段的数目。参数 result 为返回值代码。
参考: sybase_query() sybase_fetch_field() sybase_num_rows()

sybase_num_rows
取得返回列的数目。
语法: int sybase_num_rows(int result);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数可以得到返回列的数目。参数 result 为返回值代码。
参考: sybase_query() sybase_fetch_field() sybase_num_fields()

sybase_pconnect
打开服务器持续连接。
语法: int sybase_pconnect(string [servername], string [username], string [password]);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数和 sybase_connect() 雷同。不同的地方在于使用本函数打开数据库时，程序会先寻找是否曾经执行过本函数，若执行过则返回先前执行的 id。另一个不同的地方是本函数无法使用 sybase_close() 关闭数据库。参数 servername 为欲连上的数据库服务器名称。参数 username 及 password 可省略，分别为连接使用的帐号及密码。

sybase_query
送出一个 query 字符串。
语法: boolean sybase_query(string query, int plink_identifier]);
返回值: 布尔值
函数种类: 数据库功能
内容说明: 本函数送出 query 字符串供 sybase 做相关的处理或者执行。若没有指定 link_identifier 参数，则程序会自动寻找最近打开的 id。成功则返回 true 值。

sybase_result
取得查询 (query) 的结果。
语法: int sybase_result(int result, int row, mixed field);
返回值: 整数
函数种类: 数据库功能
内容说明: 本函数取得一格 query 的结果。参数 field 可以是字段名称、顺序或者是 fieldname.tablename 的格式。在返回资料量少时，可以使用本函数来处理。当数据库大时，本函数的效率就有待考量了，这时可以使用较有效率的 sybase_fetch_row()、sybase_fetch_array() 或 sybase_fetch_object() 等函数。

sybase_select_db
选择一个数据库。
语法: boolean sybase_select_db(string database_name, int [link_identifier]);
返回值: 布尔值
函数种类: 数据库功能
内容说明: 本函数选择 sybase 中的数据库以供之后的资料查询作业 (query) 处理。成功返回 true，失败则返回 false。