[ 永遠的UNIX > PHP4手冊:函數庫及函數(三十三) Sybase 資料庫函式庫 ]

[ 永遠的UNIX::UNIX技術資料的寶庫 ] GB | BIG5

首頁 > 編程技術 > Php > 正文

PHP4手冊:函數庫及函數(三十三) Sybase 資料庫函式庫

http://netleader.126.com 星空浪子 (2001-04-18 15:25:36)

--------------------------------------------------------------------------------
　Sybase　資料庫函式庫　
--------------------------------------------------------------------------------
　

本函式庫共有　16　個函式
這個函式庫和　SQL　Server　資料庫函式庫幾乎完全相同，實際上是本函式先出現，之才出現　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()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

sybase_affected_rows
取得最　query　影響的列數。

語法:　int　sybase_affected_rows(int　[link_identifier]);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來取得最一次對資料庫下　query　指令所影響的列數，會影響的為　INSERT、UPDATE　或　DELETE　等指令，而　SELECT　不會影響。參數　link_identifier　可省略，為開啟資料庫的連線代號。傳回值即為列數。

　

--------------------------------------------------------------------------------
　函式:sybase_close()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

sybase_close
關閉與資料庫的連線。

語法:　boolean　sybase_close(int　link_identifier);

傳回值:　布林值

函式種類:　資料庫功能

　
　
內容說明　

本函式用來關閉與　Sybase　資料庫的連線，能關閉的為使用　sybase_connect()　函式開啟的資料庫，若使用　sybase_pconnect()　開啟的資料庫則不能以本函式關閉。參數　link_identifier　可省略，為開啟資料庫的連線代號。關閉成功則傳回　true　值。

　
　
參考　

sybase_connect()　　sybase_pconnect()　　

　

--------------------------------------------------------------------------------
　函式:sybase_connect()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

sybase_connect
連上資料庫。

語法:　int　sybase_connect(string　[servername],　string　[username],　string　[password]);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式用來開啟與　Sybase　資料庫的連線。參數　servername　為欲連上的資料庫伺服器名稱。參數　username　及　password　可省略，分別為連線使用的帳號及密碼。使用本函式需注意早點關閉資料庫，以減少系統的負擔。連線成功則傳回資料庫的連線代號，失敗傳回　false　值。

　
　
參考　

sybase_close()　　sybase_pconnect()　　

--------------------------------------------------------------------------------
　函式:sybase_data_seek()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

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()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

sybase_fetch_array
傳回陣列資料。

語法:　array　sybase_fetch_array(int　result);

傳回值:　陣列

函式種類:　資料庫功能

　
　
內容說明　

本函式用來將查詢結果　result　拆到陣列變數中。若　result　沒有資料，則傳回　false　值。而本函式可以說是　sybase_fetch_row()　的加強函式，除可以將傳回列及數字索引放入陣列之外，還可以將文字索引放入陣列中。

　
　
使用范例　

這是　joey@samaritan.com　(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()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

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()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

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()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

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()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

sybase_field_seek
設定指標到傳回值的某欄位。

語法:　int　sybase_field_seek(int　result,　int　field_offset);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式設定目前的指標到傳回值的特定欄位中。參數　result　為傳回值代碼。參數　field_offset　則為指定的欄位序數。

　
　
參考　

sybase_fetch_field()　　

　

--------------------------------------------------------------------------------
　函式:sybase_free_result()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

sybase_free_result
釋放傳回佔用記憶體。

語法:　int　sybase_free_result(int　result);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式可以釋放目前　Sybase　資料庫　query　傳回所佔用的記憶體。一般只有在非常擔心在記憶體的使用上可能會不足的情形下才會用本函式。PHP　程式會在結束時自動釋放。

　

--------------------------------------------------------------------------------
　函式:sybase_num_fields()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

sybase_num_fields
取得傳回欄位的數目。

語法:　int　sybase_num_fields(int　result);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式可以得到傳回欄位的數目。參數　result　為傳回值代碼。

　
　
參考　

sybase_query()　　sybase_fetch_field()　　sybase_num_rows()　　

　

--------------------------------------------------------------------------------
　函式:sybase_num_rows()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

sybase_num_rows
取得傳回列的數目。

語法:　int　sybase_num_rows(int　result);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式可以得到傳回列的數目。參數　result　為傳回值代碼。

　
　
參考　

sybase_query()　　sybase_fetch_field()　　sybase_num_fields()　　

　

--------------------------------------------------------------------------------
　函式:sybase_pconnect()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

sybase_pconnect
開啟伺服器長期連線。

語法:　int　sybase_pconnect(string　[servername],　string　[username],　string　[password]);

傳回值:　整數

函式種類:　資料庫功能

　
　
內容說明　

本函式和　sybase_connect()　雷同。不同的地方在使用本函式開啟資料庫時，程式會先尋找是否曾經執行過本函式，若執行過則傳回先前執行的　ID。另一個不同的地方是本函式無法使用　sybase_close()　關閉資料庫。參數　servername　為欲連上的資料庫伺服器名稱。參數　username　及　password　可省略，分別為連線使用的帳號及密碼。

　

--------------------------------------------------------------------------------
　函式:sybase_query()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

sybase_query
送出一個　query　字串。

語法:　boolean　sybase_query(string　query,　int　plink_identifier]);

傳回值:　布林值

函式種類:　資料庫功能

　
　
內容說明　

本函式送出　query　字串供　Sybase　做相關的處理或者執行。若沒有指定　link_identifier　參數，則程式會自動尋找最近開啟的　ID。成功則傳回　true　值。

　

--------------------------------------------------------------------------------
　函式:sybase_result()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

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()　
--------------------------------------------------------------------------------
　

Sybase　資料庫函式庫

sybase_select_db
選擇一個資料庫。

語法:　boolean　sybase_select_db(string　database_name,　int　[link_identifier]);

傳回值:　布林值

函式種類:　資料庫功能

　
　
內容說明　

本函式選擇　Sybase　中的資料庫以供之的資料查詢作業　(query)　處理。成功傳回　true，失敗則傳回　false。 (http://www.fanqiang.com) 進入【UNIX論壇】

===更多相關===

★ 樊強制作歡迎分享 ★