Udostępnij za pośrednictwem

Klasa CStringArray

  • Artykuł

Obsługuje tablice CString obiektów.

class CStringArray : public CObject

Elementy członkowskie

Funkcje elementu członkowskiego CStringArray są podobne do funkcji elementów członkowskich klasy CObArray.Z powodu tego podobieństwa, można użyć CObArray odwołania dokumentacji charakterystykę funkcji elementu członkowskiego.Po wyświetleniu CObject wskaźnik jako zwracanej wartości, należy zastąpić CString obiektu (nie CString wskaźnik myszy).Po wyświetleniu CObject wskaźnik jako parametr funkcji podstaw LPCTSTR.

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

na przykład tłumaczy do

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

and

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

wykonuje translację na

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

Konstruktory publiczne

Nazwa

Opis

CObArray::CObArray

Tworzy pustą tablicę.

Metody publiczne

Nazwa

Opis

CObArray::Add

Dodaje element do końca tablicy; Jeśli to konieczne, zwiększania rozmiaru tablicy.

CObArray::Append

Dołącza innej tablicy do tablicy; Jeśli to konieczne, zwiększania rozmiaru tablicy.

CObArray::Copy

Kopiuje innej tablicy do tablicy; Jeśli to konieczne, zwiększania rozmiaru tablicy.

CObArray::ElementAt

Zwraca tymczasowe odwołanie do elementu wskaźnik myszy w tablicy.

CObArray::FreeExtra

Zwalnia wszystkie nieużywane pamięci powyżej bieżącego górna granica.

CObArray::GetAt

Zwraca wartość danego indeksu.

CObArray::GetCount

Pobiera liczbę elementów w tej macierzy.

CObArray::GetData

Umożliwia dostęp do elementów w tablicy.Może być NULL.

CObArray::GetSize

Pobiera liczbę elementów w tej macierzy.

CObArray::GetUpperBound

Zwraca największą nieprawidłowy indeks.

CObArray::InsertAt

Wstawia element (lub wszystkie elementy w innej tablicy) pod określonym indeksem.

CObArray::IsEmpty

Określa, czy tablica jest pusta.

CObArray::RemoveAll

Usuwa wszystkie elementy z tej tablicy.

CObArray::RemoveAt

Usuwa element od określonego indeksu.

CObArray::SetAt

Ustawia wartość dla danego indeksu; Tablica nie może wzrosną.

CObArray::SetAtGrow

Ustawia wartość dla danego indeksu; Jeśli to konieczne, zwiększania rozmiaru tablicy.

CObArray::SetSize

Ustawia liczbę elementów, które mają zostać zawarte w tej tablicy.

Operatory publiczne

Nazwa

Opis

[CObArray::operator]

Ustawia lub pobiera element pod określonym indeksem.

Uwagi

CStringArrayzawiera IMPLEMENT_SERIAL makra do obsługi serializacji i składowanie swoich elementów.Jeśli tablica CString obiekty są przechowywane do archiwum, za pomocą operatora wstawiania przeciążenia lub z Serialize funkcji elementu członkowskiego, każdy element jest serializowana z kolei.

[!UWAGA]

Przed rozpoczęciem korzystania z tablicy, użyj SetSize do ustanawiania jego rozmiar i przydzielić pamięci dla niego.Jeśli nie używasz SetSize, dodawanie elementów do macierzy powoduje, że ono często ponownie przydzielona i skopiowany.Ponowny częstych kopiowanie nieefektywne i są można fragment pamięci.

Zrzut ciąg poszczególnych elementów w tablicy, należy należy ustawić głębokość kontekstu zrzutu do 1 lub większą.

Gdy CString tablicy został usunięty lub gdy jego elementy zostaną usunięte, ciąg pamięci jest zwalniane odpowiednio.

Aby uzyskać więcej informacji na temat CStringArray, zobacz artykuł kolekcje.

Hierarchia dziedziczenia

CObject

CStringArray

Wymagania

Nagłówek: afxcoll.h

Zobacz też

Informacje

Klasa CObject

Diagram hierarchii