System::Collections::Generic::List Klasse

List class

List forward declaration.

template<typename T>class List : public virtual System::Object,
                                 public System::Collections::Generic::IList<T>
ParameterBeschreibung
TElementtyp.

Nested classes

Methoden

MethodeBeschreibung
_add_range(std::initializer_list<T>)C++-spezifisch.
Add(const T&) overrideFügt ein Element am Ende der Liste hinzu.
AddInitializer(int, const T *)Fügt Elemente zur Liste hinzu; wird beim Übersetzen von Initialisierern verwendet.
AddRange(IEnumerablePtr)Fügt alle Elemente aus der Sammlung (oder sich selbst) am Ende der aktuellen Liste hinzu.
AsReadOnly()Erhält eine schreibgeschützte Referenz auf diese Sammlung.
begin()Gibt einen Iterator auf das erste Element der Sammlung zurück.
begin() constErhält einen Iterator zum ersten Element der const‑qualifizierten Sammlung.
BinarySearch(const T&) constSucht nach einem Element in einer sortierten Liste.
BinarySearch(const T&, const SharedPtr<System::Collections::Generic::IComparer<T>>&) constSucht nach einem Element in einer sortierten Liste.
BinarySearch(int, int, const T&, const SharedPtr<System::Collections::Generic::IComparer<T>>&) constSucht nach einem Element in einer sortierten Liste.
cbegin() constErhält einen Iterator zum ersten const‑qualifizierten Element der Sammlung.
cend() constErhält einen Iterator für ein nicht existierendes const‑qualifiziertes Element hinter dem Ende der Sammlung.
Clear() overrideLöscht alle Elemente.
Contains(const T&) const overrideÜberprüft, ob das Element in der Liste vorhanden ist.
ConvertAll(Converter<T, OutputType>)Erstellt eine Liste von Elementen, die in einen anderen Typ konvertiert wurden.
CopyTo(System::ArrayPtr<T>, int) overrideKopiert Listenelemente in vorhandene Array-Elemente.
CopyTo(const System::ArrayPtr<T>&)Kopiert alle Elemente in vorhandene Array-Elemente.
CopyTo(int, const System::ArrayPtr<T>&, int, int)Kopiert Elemente beginnend ab dem angegebenen Index in vorhandene Array-Elemente.
crbegin() constGibt einen Reverse‑Iterator auf das letzte const‑qualifizierte Element der Sammlung zurück (erstes im Reverse).
crend() constGibt einen Reverse‑Iterator für ein nicht vorhandenes const‑qualifiziertes Element vor dem Beginn der Sammlung zurück.
data()Zugriffs‑Funktion der zugrunde liegenden Datenstruktur.
data() constZugriffs‑Funktion der zugrunde liegenden Datenstruktur.
end()Erhält einen Iterator für ein nicht existierendes Element hinter dem Ende der Sammlung.
end() constErhält einen Iterator für ein nicht existierendes Element hinter dem Ende der const‑qualifizierten Sammlung.
Exists(System::Predicate<T>)Prüft, ob ein Element, das ein bestimmtes Prädikat erfüllt, in der Liste existiert.
Find(System::Predicate<T>)Sucht nach einem Element, das ein bestimmtes Prädikat erfüllt.
FindAll(System::Predicate<T>)Sucht nach Elementen, die ein bestimmtes Prädikat erfüllen.
FindIndex(System::Predicate<T>)Sucht nach einem Element, das ein bestimmtes Prädikat erfüllt.
FindIndex(int, System::Predicate<T>)Sucht nach einem Element, das ein bestimmtes Prädikat erfüllt.
FindIndex(int, int, System::Predicate<T>)Sucht nach einem Element, das ein bestimmtes Prädikat erfüllt.
FindLast(System::Predicate<T>)Sucht nach dem letzten Element, das ein bestimmtes Prädikat erfüllt.
ForEach(System::Action<T>)Wendet eine Aktion auf alle Elemente in der Liste an.
get_Capacity() constErmittelt die aktuelle Listenkapazität.
get_Count() const overrideErmittelt die Anzahl der Elemente in der aktuellen Liste.
GetEnumerator() overrideErmittelt den Enumerator, um durch Listenelemente zu iterieren.
GetRange(int, int)Erstellt einen Ausschnitt der Liste.
idx_get(int) const overrideErmittelt das Element an einer bestimmten Position.
idx_set(int, T) overrideSetzt das Element an einer bestimmten Position.
IndexOf(const T&) const overrideErmittelt den ersten Index eines bestimmten Elements.
IndexOf(const T&, int) constSucht nach einem bestimmten Element in der Liste.
Insert(int, const T&) overrideFügt ein Element an der angegebenen Position ein.
InsertRange(int, IEnumerablePtr)Fügt einen Datenbereich an einer bestimmten Position ein.
LastIndexOf(const T&) constDurchsucht das angegebene Objekt und gibt den nullbasierten Index des letzten Vorkommens in der gesamten Liste zurück.
LastIndexOf(const T&, int32_t) constDurchsucht das angegebene Objekt und gibt den nullbasierten Index des letzten Vorkommens im Bereich der Elemente in der List zurück, der vom ersten Element bis zum angegebenen Index reicht.
LastIndexOf(const T&, int32_t, int32_t) constDurchsucht das angegebene Objekt und gibt den nullbasierten Index des letzten Vorkommens im Bereich der Elemente in der List zurück, der die angegebene Anzahl von Elementen enthält und am angegebenen Index endet.
List()Erstellt eine leere Liste.
List(int)Erstellt eine Liste mit vordefinierter Kapazität.
List(IEnumerablePtr)Kopierkonstruktor.
operator[](int)Accessor‑Funktion.
operator[](int) constAccessor‑Funktion.
rbegin()Gibt einen Reverse‑Iterator auf das letzte Element der Sammlung zurück (erstes im Reverse).
rbegin() constGibt einen Reverse‑Iterator auf das letzte Element der const‑qualifizierten Sammlung zurück (erstes im Reverse).
Remove(const T&) overrideEntfernt die erste Instanz des angegebenen Elements aus der Liste.
RemoveAll(Predicate<T>)Entfernt alle Elemente, die einem bestimmten Prädikat entsprechen.
RemoveAt(int) overrideEntfernt das Element an der angegebenen Position.
RemoveRange(int, int)Entfernt einen Ausschnitt der Liste.
rend()Gibt einen Reverse‑Iterator für ein nicht vorhandenes Element vor dem Beginn der Sammlung zurück.
rend() constGibt einen Reverse‑Iterator für ein nicht vorhandenes Element vor dem Beginn der const‑qualifizierten Sammlung zurück.
Reverse()Kehrt die Reihenfolge der Elemente der gesamten Liste um.
Reverse(int, int)Kehrt die Reihenfolge der Elemente des Listenausschnitts um.
set_Capacity(int)Setzt die Listenkapazität.
Sort(const SharedPtr<System::Collections::Generic::IComparer<T>>&)Sortiert die Elemente in der Liste.
Sort()Sortiert die Elemente in der Liste mit dem Standardvergleich.
Sort(int, int, SharedPtr<System::Collections::Generic::IComparer<T>>)Sortiert die Elemente im Listenausschnitt.
Sort(Comparison<T>, bool)Sortiert die Elemente in der Liste.
ToArray() constKonvertiert die Liste in ein Array.
TrimExcess()Passt die Listenkapazität an ihre Größe an.
TrueForAll(System::Predicate<T>)Bestimmt, ob jedes Element in der Sammlung den durch das angegebene Prädikat definierten Bedingungen entspricht.
virtualizeBeginConstIterator() const overrideLiefert die Implementierung des begin‑const‑Iterators für den aktuellen Container.
virtualizeBeginIterator() overrideLiefert die Implementierung des begin‑Iterators für den aktuellen Container.
virtualizeEndConstIterator() const overrideLiefert die Implementierung des end‑const‑Iterators für den aktuellen Container.
virtualizeEndIterator() overrideLiefert die Implementierung des end‑Iterators für den aktuellen Container.

Typedefs

Typedef.Beschreibung
BaseTypeSchnittstellentyp.
const_iteratorTyp des konstanten Iterators.
const_reverse_iteratorTyp des konstanten Reverse-Iterators.
IEnumerablePtrContainer, der Elemente desselben Typs hält.
IEnumeratorPtrEnumerator Typ.
iteratorIteratortyp.
reverse_iteratorReverse-Iteratortyp.
ValueTypeDieser Typ.
vector_tRTTI-Informationen.

Hinweise

List - wrapper around std::vector to be used in translated code. Requires operator == to be impemented for element type. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument.

#include <system/collections/list.h>
#include <system/smart_ptr.h>

using namespace System;
using namespace System::Collections::Generic;

int main()
{
  // Erstelle die erste Liste.
  auto list1 = MakeObject<List<int>>();

  // Fülle die erste Liste.
  list1->Add(3);
  list1->Add(1);
  list1->Add(-5);
  list1->Add(8);

  // Sortiere die erste Liste.
  // Die Elemente der ersten Liste werden sein: {-5, 1, 3, 8}
  list1->Sort();

  // Entferne das Element an Index 2.
  // Die Elemente der ersten Liste werden sein: {-5, 1, 8}
  list1->RemoveAt(2);

  // Füge das Element an Index 1 ein.
  // Die Elemente der ersten Liste werden sein: {-5, 15, 1, 8}
  list1->Insert(1, 15);

  // Erstelle die zweite Liste.
  auto list2 = MakeObject<List<int>>();

  // Fülle die zweite Liste.
  list2->Add(10);
  list2->Add(20);
  list2->Add(30);

  // Hänge Elemente der zweiten Liste an die erste an.
  list1->AddRange(list2);

  // Gib die Elemente der ersten Liste aus.
  for (const auto item: list1)
  {
    std::cout << item << ' ';
  }

  return 0;
}
/*
This code example produces the following output:
-5 15 1 8 10 20 30
*/

Siehe auch