CStringArray 類別

支援某些 CString 物件。

class CStringArray : public CObject

成員

CStringArray 的成員函式類似於類別 使用 CObArray的成員函式。因此相似，您可以使用成員的函式特定使用 CObArray 參考文件。不論您在何處參閱 CObject 指標做為傳回值，請用 CString (不是 CString 指標)。不論您在何處參閱 CObject 指標做為函式參數，請以 LPCTSTR。

CObject* CObArray::GetAt( int <nIndex> ) const;

例如，轉譯

CString CStringArray::GetAt( int <nIndex> ) const;

和

void SetAt( int <nIndex>, CObject* <newElement> )

轉譯

void SetAt( int <nIndex>, LPCTSTR <newElement> )

公用建構函式

名稱	描述
CObArray::CObArray	建構空白陣列。

公用方法

名稱	描述
CObArray::Add	將項目加入至陣列結尾;如果需要，擴大陣列。
CObArray::Append	附加另一個陣列的陣列;如果需要，擴大陣列。
CObArray::Copy	複製到另一個陣列的陣列;如果需要，擴大陣列。
CObArray::ElementAt	傳回項目指標的暫存參考在陣列中。
CObArray::FreeExtra	釋放在目前的上限 (Upper Bound) 上的所有未使用的記憶體。
CObArray::GetAt	傳回值是在指定的索引。
CObArray::GetCount	取得項目的參數數目等於陣列中的。
CObArray::GetData	允許存取項目的存取陣列中。可以是 NULL。
CObArray::GetSize	取得項目的參數數目等於陣列中的。
CObArray::GetUpperBound	會傳回最大的有效索引。
CObArray::InsertAt	插入項目 (或另一個檔案中的所有元素的陣列) 中的指定索引。
CObArray::IsEmpty	判斷陣列是否是空的。
CObArray::RemoveAll	從陣列中移除所有項目。
CObArray::RemoveAt	移除項目中的特定索引處。
CObArray::SetAt	設定指定之索引的值;不允許的陣列成長。
CObArray::SetAtGrow	設定指定之索引的值;如果需要，擴大陣列。
CObArray::SetSize	將陣列中的元素數目。

公用運算子

名稱	描述
[in] CObArray::operator	設定或取得這個項目在指定之索引處的。

備註

CStringArray 合併 IMPLEMENT_SERIAL 巨集支援序列化和傾印其項目。如果陣列 CString 物件儲存至檔案，具有多載插入運算子的或 Serialize 成員函式中，每個項目依次序列化。

注意事項
在使用陣列，請使用 SetSize 建立控制項的大小和配置其記憶體。如果您不使用 SetSize，將項目加入至陣列會經常被重新配置和複製。經常重新配置和複製沒有效率，而且可能分段記憶體。

如果您在陣列需要個別資料項目傾印，您必須將傾印內容的深度為 1 或更大。

當 CString 陣列 delete 時，或在移除項目時，其元素，字串記憶體釋放適當。

如需使用 CStringArray的詳細資訊，請參閱本文 集合。

繼承階層架構

CObject

CStringArray

需求

Header: afxcoll.h

請參閱

參考

CObject 類別

階層架構圖