CStringArray Klasa
Obsługuje tablice CString obiektów.
Składnia
class CStringArray : public CObject
Elementy członkowskie
Funkcje CStringArray składowe klasy są podobne do funkcji składowych klasy CObArray. Ze względu na to podobieństwo można użyć dokumentacji referencyjnej CObArray dla specyfiki funkcji składowych. Wszędzie tam, gdzie wskaźnik jest widoczny CObject jako wartość zwracana, zastąp CString obiekt (a nie wskaźnikiem CString ). Wszędzie tam, gdzie wskaźnik jest wyświetlany CObject jako parametr funkcji, zastąp element LPCTSTR.
CObject* CObArray::GetAt( int <nIndex> ) const;
na przykład przekłada się na
const CString& CStringArray::GetAt( int <nIndex> ) const;
oraz
void SetAt( int <nIndex>, CObject* <newElement> )
przekłada się na
void SetAt( int <nIndex>, LPCTSTR <newElement> )
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
CStringArray::CStringArray |
Tworzy pustą tablicę. |
Metody publiczne
| Nazwa/nazwisko | opis |
|---|---|
CStringArray::Add |
Dodaje element na końcu tablicy; w razie potrzeby zwiększa tablicę. |
CStringArray::Append |
Dołącza kolejną tablicę do tablicy; w razie potrzeby zwiększa tablicę. |
CStringArray::Copy |
Kopiuje kolejną tablicę do tablicy; w razie potrzeby zwiększa tablicę. |
CStringArray::ElementAt |
Zwraca tymczasowe odwołanie do wskaźnika elementu w tablicy. |
CStringArray::FreeExtra |
Zwalnia całą nieużywaną pamięć powyżej bieżącej górnej granicy. |
CStringArray::GetAt |
Zwraca wartość dla danego indeksu. |
CStringArray::GetCount |
Pobiera liczbę elementów w tej tablicy. |
CStringArray::GetData |
Umożliwia dostęp do elementów w tablicy. Może to być NULL. |
CStringArray::GetSize |
Pobiera liczbę elementów w tej tablicy. |
CStringArray::GetUpperBound |
Zwraca największy prawidłowy indeks. |
CStringArray::InsertAt |
Wstawia element (lub wszystkie elementy w innej tablicy) w określonym indeksie. |
CStringArray::IsEmpty |
Określa, czy tablica jest pusta. |
CStringArray::RemoveAll |
Usuwa wszystkie elementy z tej tablicy. |
CStringArray::RemoveAt |
Usuwa element w określonym indeksie. |
CStringArray::SetAt |
Ustawia wartość dla danego indeksu; tablica nie może rosnąć. |
CStringArray::SetAtGrow |
Ustawia wartość dla danego indeksu; w razie potrzeby zwiększa tablicę. |
CStringArray::SetSize |
Ustawia liczbę elementów, które mają być zawarte w tej tablicy. |
Operatory publiczne
| Nazwa/nazwisko | opis |
|---|---|
CStringArray::operator [ ] |
Ustawia lub pobiera element w określonym indeksie. |
Uwagi
CStringArrayIMPLEMENT_SERIAL uwzględnia makro w celu wspierania serializacji i dumpingu jej elementów. Jeśli tablica CString obiektów jest przechowywana w archiwum, z przeciążonym operatorem wstawiania lub z Serialize funkcją składową, każdy element jest serializowany z kolei.
Uwaga
Przed użyciem tablicy użyj polecenia SetSize , aby ustanowić jego rozmiar i przydzielić dla niej pamięć. Jeśli nie używasz polecenia SetSize, dodanie elementów do tablicy powoduje, że jest on często ponownie przydzielany i kopiowany. Częste reallokowanie i kopiowanie są nieefektywne i mogą fragmentować pamięć.
Jeśli potrzebujesz zrzutu poszczególnych elementów ciągu w tablicy, musisz ustawić głębokość kontekstu zrzutu na 1 lub większą.
Gdy tablica CString zostanie usunięta lub gdy jej elementy zostaną usunięte, pamięć ciągu zostanie zwolniona zgodnie z potrzebami.
Aby uzyskać więcej informacji na temat korzystania z programu CStringArray, zobacz artykuł Kolekcje.
Hierarchia dziedziczenia
CStringArray
Wymagania
Nagłówek: afxcoll.h