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

首頁 > 編程技術 > Php > 正文
PHP4手冊:函數庫及函數(十八) Hyperwave 伺服器函式庫-1
http://netleader.126.com 星空浪子 (2001-04-18 12:44:39)

--------------------------------------------------------------------------------
 Hyperwave 伺服器函式庫 
--------------------------------------------------------------------------------
 


本函式庫共有 53 個函式
要使用這種函式庫,須先到 http://www.hyperwave.com 下載函式館,和大多數 PHP 支援的函式館不同,這套是需要收費的函式館,提供下載的試用版為三十天的試用版。 
Hyperwave 是一種資訊系統,和一般資料庫不同的是,Hyperwave 著重在文件的儲存及管理。Hyperwave 將每一筆文件當成一個物件,同時也記載著有關該物件的 meta 資訊,當然 meta 資料可由使用者自行擴充。屬性的格式為 name/value 這也對映到 form 上的 name=value 資訊。比較特別的是這些 name 的名稱不必是唯一的,也就是 name 可以重覆。每筆物件屬性都是由換行字元分開,亦即每行代表一筆屬性。 
 


hw_Children: 取得子物件代碼。 
hw_ChildrenObj: 取得子物件的物件記錄。 
hw_Close: 關閉 Hyperwave 連線。 
hw_Connect: 連上 Hyperwave 伺服器。 
hw_Cp: 復制物件。 
hw_Deleteobject: 刪除物件。 
hw_DocByAnchor: 取得指定錨的文件物件代碼。 
hw_DocByAnchorObj: 取得指定錨的文件物件。 
hw_DocumentAttributes: 取得指定文件物件屬性。 
hw_DocumentBodyTag: 取得指定文件物件的文件主體標記。 
hw_DocumentContent: 取得指定文件物件的內容。 
hw_DocumentSetContent: 重設指定文件物件的內容。 
hw_DocumentSize: 取得文件大小。 
hw_ErrorMsg: 取得錯誤訊息。 
hw_EditText: 更動文字文件。 
hw_Error: 取得錯誤代碼。 
hw_Free_Document: 釋放文件使用的記憶體。 
hw_GetParents: 取得父物件的 ID。 
hw_GetParentsObj: 取得父物件的資料。 
hw_GetChildColl: 取得子物件們的 ID。 
hw_GetChildCollObj: 取得子物件們的資料。 
hw_GetRemote: 取得遠端文件。 
hw_GetRemoteChildren: 取得遠端的子文件。 
hw_GetSrcByDestObj: 取得指定目的的文件內容。 
hw_GetObject: 取得物件。 
hw_GetAndLock: 取得並鎖住物件。 
hw_GetText: 取得純文字文件。 
hw_GetObjectByQuery: 搜尋物件。 
hw_GetObjectByQueryObj: 搜尋物件。 
hw_GetObjectByQueryColl: 搜尋聚集物件。 
hw_GetObjectByQueryCollObj: 搜尋聚集物件。 
hw_GetChildDocColl: 取得全部子文件聚集。 
hw_GetChildDocCollObj: 取得全部子文件聚集記錄。 
hw_GetAnchors: 取得文件的連結錨。 
hw_GetAnchorsObj: 取得文件的連結錨記錄。 
hw_Mv: 移動物件。 
hw_Identify: 使用者身份確認。 
hw_InCollections: 檢查物件聚集。 
hw_Info: 連線資訊。 
hw_InsColl: 插入聚集。 
hw_InsDoc: 插入文件。 
hw_InsertDocument: 上傳文件。 
hw_InsertObject: 插入物件記錄。 
hw_Modifyobject: 修改物件記錄。 
hw_New_Document: 建立新文件。 
hw_Objrec2Array: 物件記錄轉為陣列。 
hw_OutputDocument: 輸出文件。 
hw_pConnect: 連上 Hyperwave 伺服器。 
hw_PipeDocument: 取得文件。 
hw_Root: 取得根物件代碼。 
hw_Unlock: 取消鎖定。 
hw_Who: 列出目前使用者。 
hw_GetUsername: 目前使用者名字。 


--------------------------------------------------------------------------------
 函式:hw_Children() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_Children
取得子物件代碼。

語法: array hw_children(int connection, int objectID);

傳回值: 陣列

函式種類: 網路系統


 
 
內容說明 


本函式用來取得子物件的 ID 代碼。參數 connection 為連線的代碼。參數 objectID 為欲取得的子物件。
 

--------------------------------------------------------------------------------
 函式:hw_ChildrenObj() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_ChildrenObj
取得子物件的物件記錄。

語法: array hw_childrenobj(int connection, int objectID);

傳回值: 陣列

函式種類: 網路系統


 
 
內容說明 


本函式用來取得子物件的物件記錄。參數 connection 為連線的代碼。參數 objectID 為欲取得的子物件。
 

--------------------------------------------------------------------------------
 函式:hw_Close() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_Close
關閉 Hyperwave 連線。

語法: boolean hw_close(int connection);

傳回值: 布林值

函式種類: 網路系統


 
 
內容說明 


本函式用來關閉與 Hyperwave 伺服器的連線。參數 connection 為連線代碼。
 

--------------------------------------------------------------------------------
 函式:hw_Connect() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_Connect
連上 Hyperwave 伺服器。

語法: int hw_connect(string host, int port, string [username], string [password]);

傳回值: 整數

函式種類: 網路系統


 
 
內容說明 


本函式用來與 Hyperwave 伺服器的連線。參數 host 為 Hyperwave 伺服器。參數 port 為連線的 port。參數 username 與 password 可省略,分別為連線使用的帳號及密碼,若省略 username 則為匿名使用。成功則傳回連線代碼,供其它函式使用,失敗則傳回 false。


 
 
參考 


hw_Close()  hw_pConnect()  
 

--------------------------------------------------------------------------------
 函式:hw_Cp() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_Cp
復制物件。

語法: void hw_cp(int connection, array objrec, int dest);

傳回值: 無

函式種類: 網路系統


 
 
內容說明 


本函式用來復制指定的物件。參數 connection 為連線代碼。參數 objrec 為待復制的物件代碼陣列。參數 dest 為目的的代碼。


 
 
參考 


hw_Deleteobject()  hw_Mv()  

 

--------------------------------------------------------------------------------
 函式:hw_Deleteobject() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_Deleteobject
刪除物件。

語法: boolean hw_deleteobject(int connection, int object_to_delete);

傳回值: 布林值

函式種類: 網路系統


 
 
內容說明 


本函式用來刪除指定的物件。參數 connection 為連線代碼。參數 object_to_delete 表欲刪除的物件。成功則傳回 true。


 
 
參考 


hw_Cp()  hw_Mv()  
 

--------------------------------------------------------------------------------
 函式:hw_DocByAnchor() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_DocByAnchor
取得指定錨的文件物件代碼。

語法: int hw_docbyanchor(int connection, int anchorID);

傳回值: 整數

函式種類: 網路系統


 
 
內容說明 


本函式用來取得屬指定錨 (anchor) 的文件物件代碼。參數 connection 為連線代碼。參數 anchorID 為錨代碼。成功則傳回代碼值。

 

--------------------------------------------------------------------------------
 函式:hw_DocByAnchorObj() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_DocByAnchorObj
取得指定錨的文件物件。

語法: string hw_docbyanchorobj(int connection, int anchorID);

傳回值: 字串

函式種類: 網路系統


 
 
內容說明 


本函式用來取得屬指定錨 (anchor) 的文件物件。參數 connection 為連線代碼。參數 anchorID 為錨代碼。成功則傳回物件字串。
 

--------------------------------------------------------------------------------
 函式:hw_DocumentAttributes() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_DocumentAttributes
取得指定文件物件屬性。

語法: string hw_documentattributes(int hw_document);

傳回值: 字串

函式種類: 網路系統


 
 
內容說明 


本函式用來取得指定文件物件的屬性。參數 hw_document 為文件物件。成功則傳回物件字串。


 
 
參考 


hw_DocumentBodyTag()  hw_DocumentSize()  
 

--------------------------------------------------------------------------------
 函式:hw_DocumentBodyTag() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_DocumentBodyTag
取得指定文件物件的文件主體標記。

語法: string hw_documentbodytag(int hw_document, string [prefix]);

傳回值: 字串

函式種類: 網路系統


 
 
內容說明 


本函式用來取得指定文件物件的文件主體 (body) 標記 (tag)。參數 hw_document 為文件物件。參數 prefix 可省略,表示在標記前要加的字串。成功則傳回主體標記字串。


 
 
參考 


hw_DocumentAttributes()  hw_DocumentSize()  
 

--------------------------------------------------------------------------------
 函式:hw_DocumentContent() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_DocumentContent
取得指定文件物件的內容。

語法: string hw_documentcontent(int hw_document);

傳回值: 字串

函式種類: 網路系統


 
 
內容說明 


本函式用來取得指定文件物件的內容。參數 hw_document 為文件物件。


 
 
參考 


hw_DocumentAttributes()  hw_DocumentSize()  hw_DocumentSetContent()  
 

--------------------------------------------------------------------------------
 函式:hw_DocumentSetContent() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_DocumentSetContent
重設指定文件物件的內容。

語法: boolean hw_documentsetcontent(int hw_document, string content);

傳回值: 布林值

函式種類: 網路系統


 
 
內容說明 


本函式用來重新設定或者取代指定文件物件的內容。參數 hw_document 為文件物件。參數 content 即為中新的資料內容。成功則傳回 true 值。


 
 
參考 


hw_DocumentAttributes()  hw_DocumentSize()  hw_DocumentContent()  
 

--------------------------------------------------------------------------------
 函式:hw_DocumentSize() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_DocumentSize
取得文件大小。

語法: int hw_documentsize(int hw_document);

傳回值: 整數

函式種類: 網路系統


 
 
內容說明 


本函式用來取得指定文件物件的內容大小,單位是位元組 (byte)。參數 hw_document 為文件物件。


 
 
參考 


hw_DocumentAttributes()  hw_DocumentBodyTag()  
 

--------------------------------------------------------------------------------
 函式:hw_ErrorMsg() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_ErrorMsg
取得錯誤訊息。

語法: string hw_errormsg(int connection);

傳回值: 字串

函式種類: 網路系統


 
 
內容說明 


本函式用來取得最的錯誤訊息。參數 connection 為和 Hyperwave 伺服器的連線代碼。傳回為最的錯誤訊息,若無錯誤訊息,則傳回 No Error 字串。

 

--------------------------------------------------------------------------------
 函式:hw_EditText() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_EditText
更動文字文件。

語法: boolean hw_edittext(int connection, int hw_document);

傳回值: 布林值

函式種類: 網路系統


 
 
內容說明 


本函式用來將純文字文件送上 Hyperwave 伺服器上。參數 connection 為連線代碼。參數 hw_document 為文件物件。本函式僅限純文字文件使用。


 
 
參考 


hw_PipeDocument()  hw_Free_Document()  hw_DocumentBodyTag()  hw_DocumentSize()  hw_OutputDocumen()  hw_GetText()   
 

--------------------------------------------------------------------------------
 函式:hw_Error() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_Error
取得錯誤代碼。

語法: int hw_error(int connection);

傳回值: 整數

函式種類: 網路系統


 
 
內容說明 


本函式用來取得最的錯誤代碼。參數 connection 為和 Hyperwave 伺服器的連線代碼。傳回為最的錯誤代碼數字,若無錯誤,則傳回 0。
 

--------------------------------------------------------------------------------
 函式:hw_Free_Document() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_Free_Document
釋放文件使用的記憶體。

語法: boolean hw_free_document(int hw_document);

傳回值: 布林值

函式種類: 網路系統


 
 
內容說明 


本函式用來釋放指定文件所使用的記憶體。參數 hw_document 為指定的文件名稱。
 

--------------------------------------------------------------------------------
 函式:hw_GetParents() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_GetParents
取得父物件的 ID。

語法: array hw_getparentsobj(int connection, int objectID);

傳回值: 陣列

函式種類: 網路系統


 
 
內容說明 


本函式用來取得父物件的 ID 值。參數 connection 為和 Hyperwave 伺服器的連線代碼。參數 objectID 為指定的物件 ID 值。
 

--------------------------------------------------------------------------------
 函式:hw_GetParentsObj() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_GetParentsObj
取得父物件的資料。

語法: array hw_getparentsobj(int connection, int objectID);

傳回值: 陣列

函式種類: 網路系統


 
 
內容說明 


本函式用來取得父物件的資料記錄。參數 connection 為和 Hyperwave 伺服器的連線代碼。參數 objectID 為指定的物件 ID 值。
 

--------------------------------------------------------------------------------
 函式:hw_GetChildColl() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_GetChildColl
取得子物件們的 ID。

語法: array hw_getchildcoll(int connection, int objectID);

傳回值: 陣列

函式種類: 網路系統


 
 
內容說明 


本函式用來取得子物件聚集 (collections) 的 ID。參數 connection 為和 Hyperwave 伺服器的連線代碼。參數 objectID 為指定的物件 ID 值。


 
 
參考 


hw_Children()  hw_GetChildDocColl()  
 

--------------------------------------------------------------------------------
 函式:hw_GetChildCollObj() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_GetChildCollObj
取得子物件們的資料。

語法: array hw_getchildcollobj(int connection, int objectID);

傳回值: 陣列

函式種類: 網路系統


 
 
內容說明 


本函式用來取得子物件聚集 (collections) 的記錄資料。參數 connection 為和 Hyperwave 伺服器的連線代碼。參數 objectID 為指定的物件 ID 值。


 
 
參考 


hw_ChildrenObj()  hw_GetChildDocCollObj()  
 

--------------------------------------------------------------------------------
 函式:hw_GetRemote() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_GetRemote
取得遠端文件。

語法: int hw_getremote(int connection, int objectID);

傳回值: 整數

函式種類: 網路系統


 
 
內容說明 


本函式用來取得網路上遠端機器的文件,透過 Hyperwave 閘道介面 (HGI, Hyperwave Gateway Interface) 取得 http、ftp 及部份資料庫的文件資料。參數 connection 為和 Hyperwave 伺服器的連線代碼。參數 objectID 為指定的物件 ID 值。
 

--------------------------------------------------------------------------------
 函式:hw_GetRemoteChildren() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_GetRemoteChildren
取得遠端的子文件。

語法: [array|int] hw_getremotechildren(int connection, string object_record);

傳回值: 陣列或整數

函式種類: 網路系統


 
 
內容說明 


本函式用來取得網路上遠端機器的子文件。若子文件數值為 1,則傳回該文件本身;若子文件數超過 1,則傳回物件記錄陣列,更多的資訊可以參考 Hyperwave 程式設計手冊。參數 connection 為和 Hyperwave 伺服器的連線代碼。參數 object_record 為指定的物件記錄。


 
 
參考 


hw_GetRemote()  
 

--------------------------------------------------------------------------------
 函式:hw_GetSrcByDestObj() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_GetSrcByDestObj
取得指定目的的文件內容。

語法: array hw_getsrcbydestobj(int connection, int objectID);

傳回值: 陣列

函式種類: 網路系統


 
 
內容說明 


本函式用來取得網路上遠端機器的子文件。若子文件數值為 1,則傳回該文件本身;若子文件數超過 1,則傳回物件記錄陣列,更多的資訊可以參考 Hyperwave 程式設計手冊。參數 connection 為和 Hyperwave 伺服器的連線代碼。參數 objectID 為指定的物件 ID 值。
 

--------------------------------------------------------------------------------
 函式:hw_GetObject() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_GetObject
取得物件。

語法: string hw_getobject(int connection, int objectID);

傳回值: 字串

函式種類: 網路系統


 
 
內容說明 


本函式用來取得物件。參數 connection 為和 Hyperwave 伺服器的連線代碼。參數 objectID 為指定的物件 ID 值。


 
 
參考 


hw_GetAndLock()  
 

--------------------------------------------------------------------------------
 函式:hw_GetAndLock() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_GetAndLock
取得並鎖住物件。

語法: string hw_getandlock(int connection, int objectID);

傳回值: 字串

函式種類: 網路系統


 
 
內容說明 


本函式用來取得物件同時並鎖住物件,鎖住之別的程式無法存取該物件,直到解除鎖定為止。參數 connection 為和 Hyperwave 伺服器的連線代碼。參數 objectID 為指定的物件 ID 值。


 
 
參考 


hw_GetObject()  hw_Unlock()  
 

--------------------------------------------------------------------------------
 函式:hw_GetText() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_GetText
取得純文字文件。

語法: int hw_gettext(int connection, int objectID, int [rootID]);

傳回值: 整數

函式種類: 網路系統


 
 
內容說明 


本函式用來取得純文字文件,無法開啟其它格式的文件。參數 connection 為和 Hyperwave 伺服器的連線代碼。參數 objectID 為指定的物件 ID 值。參數 rootID 可省略,內定值為 0,表自動在錨 (ancher) 連結處加上適當的路徑字串。


 
 
參考 


hw_PipeDocument()  hw_Free_Document()  hw_DocumentBodyTag()  hw_DocumentSize()  hw_OutputDocument()  
 

--------------------------------------------------------------------------------
 函式:hw_GetObjectByQuery() 
--------------------------------------------------------------------------------
 


Hyperwave 伺服器函式庫


hw_GetObjectByQuery
搜尋物件。

語法: array hw_getobjectbyquery(int connection, string query, int max_hits);

傳回值: 陣列

函式種類: 網路系統


 
 
內容說明 


本函式用來搜尋伺服器中的物件,並傳回物件資料陣列。參數 connection 為和 Hyperwave 伺服器的連線代碼。參數 query 為為搜尋的字串。參數 max_hits 表合條件的最大筆數,若設為 -1 則表示沒有限制。


 
 
參考 


hw_GetObjectByQueryObj()   (http://www.fanqiang.com)
    進入【UNIX論壇

相關文章
PHP4手冊:函數庫及函數(四十六) SNMP 網管函式庫 (2001-04-18 16:56:55)
PHP4手冊:函數庫及函數(四十五) Solid 資料庫連結函式庫 (2001-04-18 16:54:16)
PHP4手冊:函數庫及函數(四十四) 信號與共享記憶體函式庫 (2001-04-18 16:49:09)
PHP4手冊:函數庫及函數(四十三) 常規表示法函式庫 (2001-04-18 16:40:33)
PHP4手冊:函數庫及函數(四十二) URL 處理函式庫 (2001-04-18 16:37:13)
PHP4手冊:函數庫及函數(四十一) PostgreSQL 資料庫函式庫 (2001-04-18 15:58:12)
PHP4手冊:函數庫及函數(四十) PDF 格式檔案函式庫 - 2 (2001-04-18 15:53:53)
PHP4手冊:函數庫及函數(四十) PDF 格式檔案函式庫 - 1 (2001-04-18 15:53:35)
PHP4手冊:函數庫及函數(三十九) Perl 相容語法函式庫 (2001-04-18 15:45:08)
PHP4手冊:函數庫及函數(三十八) Oracle 資料庫函式庫 (2001-04-18 15:43:09)

===更多相關===
 

★  樊強制作 歡迎分享  ★