WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 作業系統: Linux, Windows

Iterator

疊代子封裝了物件清單。應用程式會使用疊代子依序存取每一個物件。

疊代子亦會封裝一個游標,以維護清單中的現行位置。當建立疊代子時, 游標會位在第一個物件前面。

應用程式無法直接建立疊代子。疊代子只能使用某些函數來建立, 以便將物件清單傳回給應用程式。

這個類別為 Helper 類別。

函數

函數摘要:
函數 說明
xmsIteratorDispose 刪除疊代子。
xmsIteratorGetNext 將游標移至下一個物件,並取得游標新位置處的物件。
xmsIteratorHasNext 檢查是否還有其他物件位於游標現行位置外。
xmsIteratorReset 將游標移回第一個物件前的位置。

xmsIteratorDispose – 刪除疊代子

介面:
xmsRC xmsIteratorDispose(xmsHIterator *iterator,
                         xmsHErrorBlock errorBlock);

刪除疊代子。

如果應用程式試著刪除已刪除的疊代子, 則會忽略該呼叫。

參數:
iterator(輸入/輸出)
在輸入方面,為疊代子的控點。在輸出方面,函數會傳回空值控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsIteratorGetNext – 取得下一個物件

介面:
xmsRC xmsIteratorGetNext(xmsHIterator iterator,
                         xmsHObj *object,
                         xmsHErrorBlock errorBlock);

將游標移至下一個物件,並取得游標新位置處的物件。

參數:
iterator(輸入)
疊代子的控點。
object(輸出)
物件的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsIteratorHasNext – 檢查是否還有物件

介面:
xmsRC xmsIteratorHasNext(xmsHIterator iterator,
                         xmsBOOL *moreProperties,
                         xmsHErrorBlock errorBlock);

檢查是否還有其他物件位於游標現行位置外。此呼叫不會移動游標。

參數:
iterator(輸入)
疊代子的控點。
moreProperties(輸出)
如果還有其他物件位於游標現行位置外,則值為 xmsTRUE。如果已無物件位於游標現行位置外,則值為 xmsFALSE
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

xmsIteratorReset – 重設疊代子

介面:
xmsRC xmsIteratorReset(xmsHIterator iterator,
                       xmsHErrorBlock errorBlock);

將游標移回第一個物件前的位置。

參數:
iterator(輸入)
疊代子的控點。
errorBlock(輸入)
錯誤區塊的控點或空值控點。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

Reference topic

使用條款 | 評比此網頁

時間戳記前次更新: 25 Apr 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)