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

Iterator

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

繼承階層:

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

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

這個類別為 Helper 類別。

方法

方法摘要:
方法 說明
~Iterator 刪除疊代子。
getHandle 取得 C 應用程式在存取疊代子時所要使用的控點。
getNext 將游標移至下一個物件,並取得游標新位置處的物件。
hasNext 檢查是否還有其他物件位於游標現行位置外。
isNull 判斷 Iterator 物件是否為一個空值物件。
reset 將游標移回第一個物件前的位置。

~Iterator – 刪除疊代子

介面:
virtual ~Iterator();

刪除疊代子。

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

參數:
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getHandle – 取得控點

介面:
xmsHIterator getHandle() const;

取得 C 應用程式在存取疊代子時所要使用的控點。

參數:
傳回:
疊代子的控點。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

getNext – 取得下一個物件

介面:
xmsVOID * getNext() const;

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

參數:
傳回:
物件的指標。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

hasNext – 檢查是否還有物件

介面:
xmsBOOL hasNext();

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

參數:
傳回:
  • 如果還有其他物件位於游標現行位置外,則為 xmsTRUE
  • 如果已無物件位於游標現行位置外,則為 xmsFALSE
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

isNull – 檢查是否為空值

介面:
xmsBOOL isNull() const;

判斷 Iterator 物件是否為一個空值物件。

參數:
傳回:
  • 如果 Iterator 物件為空值物件,則為 xmsTRUE
  • 如果 Iterator 物件不是空值物件,則為 xmsFALSE
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

reset – 重設疊代子

介面:
xmsVOID reset();

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

參數:
傳回:
Void
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

Reference topic

使用條款 | 評比此網頁

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