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

String

String 物件封裝了一個字串。這個類別為 Helper 類別。

繼承階層:

建構子

建構子摘要:
建構子 說明
String 建立一個封裝空值字串的 String 物件。
String 從位元組陣列來建立一個 String 物件。
String 從字元陣列來建立一個 String 物件。

String – 建立字串

介面:
String();

建立一個封裝空值字串的 String 物件。

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

String – 建立字串(從位元組陣列)

介面:
String(const xmsSBYTE *value,
       const xmsINT length);

從位元組陣列來建立一個 String 物件。

參數:
value(輸入)
所要複製以構成 String 物件所封裝之字串的位元組陣列。
length(輸入)
陣列中的位元組數。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

String – 建立字串(從字元陣列)

介面:
String(const xmsCHAR *value);

從字元陣列來建立一個 String 物件。

參數:
value(輸入)
所要複製以構成 String 物件所封裝之字串的字元空值終止陣列。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

方法

方法摘要:
方法 說明
~String 刪除 String 物件。
c_str 取得 String 物件所封裝之字串的指標。
concatenate 讓 String 物件所封裝的字串和第二個 String 物件所封裝的字串相串連在一起。
equalTo 判斷 String 物件所封裝的字串是否等於第二個 String 物件所封裝的字串。
get 取得 String 物件所封裝的字串。
isNull 判斷 String 物件是否為一個空值物件。

~String – 刪除字串

介面:
virtual ~String();

刪除 String 物件。

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

c_str – 取得字串的指標

介面:
xmsCHAR * c_str() const;

取得 String 物件所封裝之字串的指標。

參數:
傳回:
String 物件所封裝之字串的指標。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

concatenate – 串連字串

介面:
String & concatenate(const String & string) const;

讓 String 物件所封裝的字串和第二個 String 物件所封裝的字串相串連在一起。

參數:
string(輸入)
第二個 String 物件。
傳回:
封裝所串連之字串的原始 String 物件。
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

equalTo – 比較字串

介面:
xmsBOOL equalTo(const String & string) const;

判斷 String 物件所封裝的字串是否等於第二個 String 物件所封裝的字串。

參數:
string(輸入)
第二個 String 物件。
傳回:
  • 如果兩個字串相等,則為 xmsTRUE
  • 如果兩個字串不相等,則為 xmsFALSE
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

get – 取得字串

介面:
xmsVOID get(xmsSBYTE *value,
            const xmsINT length,
            xmsINT *actualLength) const;

取得 String 物件所封裝的字串。

有關此方法用法的詳細資訊, 請參閱會傳回位元組陣列的 C++ 方法

參數:
value(輸出)
內含字串的緩衝區。
length(輸入)
緩衝區的長度(以位元組計)。如果您指定的是 XMSC_QUERY_SIZE, 則不會傳回字串,而會將其長度放在 actualLength 參數中傳回。
actualLength(輸出)
字串的長度(以位元組計)。如果您在輸入中指定一個空值指標, 則不會傳回長度。
傳回:
Void
執行緒環境定義:
任何
異常狀況:
  • XMS_X_GENERAL_EXCEPTION

isNull – 檢查是否為空值

介面:
xmsBOOL isNull() const;

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

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

Reference topic

使用條款 | 評比此網頁

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