在 C++ API 中,String 物件封裝了一個字串。當呼叫時,某些方法會將 String 物件當成參數來接受, 或傳回 String 物件。
String 物件可封裝一個以空值終止字元陣列。或者, String 物件可封裝一個含有內嵌空值字元的位元組陣列, 其中位元組陣列可能是也可能不是空值終止的。因此,當應用程式從位元組陣列建立 String 物件時, 應用程式必須指定陣列的長度。下列的程式碼片段建立了這兩種類型的 String 物件:
#include <xms.hpp> using namespace std; int main(int argc, char *argv[]) { xms::String strA("Normal character string"); xms::String strB("This\0string\0contains\0nulls", 26); // 超載的指定運算子可用來從空值終止字元陣列 // 建立一個 String 物件。 xms::String strC = "Another character string"; // 此處為其他程式碼 return(0); }
為了方便建立和操作 String 物件,在 String 類別上某些運算子和建構子為超載的。如果應用程式呼叫的方法要求將 String 物件當成輸入參數, 則不需先建立 String 物件。應用程式只需將空值終止字元陣列當成參數傳遞給方法, 而 XMS 會自動在堆疊中建立 String 物件。
此外,String 類別封裝了一些用以建立和操作 String 物件的方法。如需這些方法的定義,請參閱String。