CStringArray 類別
支援 CString 物件的陣列。
語法
class CStringArray : public CObject
成員
的成員函 CStringArray 式類似於 類別 CObArray的成員函式。 由於此相似性，您可以針對成員函式特性使用 CObArray 參考文件。 無論您在何處看到 CObject 指標做為傳回值，請取代 CString 物件（而非 CString 指標）。 無論在何處看到 CObject 指標做為函式參數，請取代 LPCTSTR。
CObject* CObArray::GetAt( int <nIndex> ) const;
例如，轉換為
const CString& CStringArray::GetAt( int <nIndex> ) const;
及
void SetAt( int <nIndex>, CObject* <newElement> )
轉換為
void SetAt( int <nIndex>, LPCTSTR <newElement> )
公用建構函式
| 名稱 | 描述 |
|---|---|
CStringArray::CStringArray |
建構空陣列。 |
公用方法
| 名稱 | 描述 |
|---|---|
CStringArray::Add |
將項目加入至陣列結尾；必要時讓陣列增長。 |
CStringArray::Append |
將其他陣列附加至該陣列；必要時讓陣列成長。 |
CStringArray::Copy |
將其他陣列複製到該陣列；必要時讓陣列成長。 |
CStringArray::ElementAt |
傳回陣列中項目指標的臨時參考。 |
CStringArray::FreeExtra |
釋放超過目前上限的所有未使用記憶體。 |
CStringArray::GetAt |
傳回給定索引的值。 |
CStringArray::GetCount |
取得此陣列中項目的數目。 |
CStringArray::GetData |
容許存取陣列中的項目。 可以是 NULL。 |
CStringArray::GetSize |
取得此陣列中項目的數目。 |
CStringArray::GetUpperBound |
傳回最大的有效索引。 |
CStringArray::InsertAt |
在指定索引處插入項目 (或其他陣列中的所有項目)。 |
CStringArray::IsEmpty |
判定陣列是否是空的。 |
CStringArray::RemoveAll |
從此陣列移除所有項目。 |
CStringArray::RemoveAt |
移除特定索引處的項目。 |
CStringArray::SetAt |
設定給定索引的值；不容許陣列成長。 |
CStringArray::SetAtGrow |
設定給定索引的值；必要時讓陣列成長。 |
CStringArray::SetSize |
設定此陣列中要包含的項目數目。 |
公用運算子
| 名稱 | 描述 |
|---|---|
CStringArray::operator [ ] |
設定或取得指定索引處的項目。 |
備註
CStringArray 引入 IMPLEMENT_SERIAL 巨集，以支援其項目的序列化和傾印。 如果 CString 物件的陣列儲存至封存檔，請使用多載插入運算子或 Serialize 成員函式，依次對每一個項目進行序列化。
注意
使用陣列之前，請先使用 SetSize 建立其大小，並為其配置記憶體。 如果您未使用 SetSize，則將項目加入至陣列會導致其被頻繁地重新配置及複製。 頻繁的重新配置及複製效率不高，且可能會讓記憶體分段。
如果您需要傾印陣列中的個別字串項目，則您必須將傾印內容的深度設定為 1 或更大。
當刪除 CString 陣列，或者移除其項目時，會適當地釋放字串記憶體。
如需使用 CStringArray的詳細資訊，請參閱集合一文。
繼承階層架構
CStringArray
需求
標頭： afxcoll.h