System::Array Klasse

Array class

Klasse, die eine Array-Datenstruktur repräsentiert. Objekte dieser Klasse sollten nur mit den Funktionen System::MakeArray() und System::MakeObject() alloziert werden. Erzeugen Sie niemals eine Instanz dieses Typs auf dem Stack oder mit dem Operator new, da dies zu Laufzeitfehlern und/oder Assertion-Fehlern führt. Wickeln Sie diese Klasse stets in einen System::SmartPtr Pointer ein und verwenden Sie diesen Pointer, um ihn als Argument an Funktionen zu übergeben.

template<typename T>class Array : public virtual System::Object,
                                  public System::Collections::Generic::IList<T>

Parameter	Beschreibung
T	Typ der Elemente eines Arrays

Nested classes

Class Enumerator

Methoden

Methode	Beschreibung
Add(const T&) override	Nicht unterstützt, weil das vom aktuellen Objekt dargestellte Array schreibgeschützt ist.
Array()	Konstruiert ein leeres Array.
Array(int, const T&)	Füllender Konstruktor.
Array(typename std::enable_if<std::is_arithmetic<T>::value&&std::is_arithmetic<ValueType>::value&&std::is_convertible<ValueType, T>::value, int>::type, ValueType)	Füllender Konstruktor.
Array(int, const T)	Füllender Konstruktor.
Array(vector_t&&)	Move-Konstruktor.
Array(const vector_t&)	Kopierkonstruktor.
Array(const std::vector<Q>&)	Konstruiert ein Array-Objekt und füllt es mit Werten, die aus einem std::vector-Objekt kopiert wurden, dessen Werttyp derselbe ist wie T, aber sich von UnderlyingType unterscheidet.
Array(std::vector<Q>&&)	Konstruiert ein Array-Objekt und füllt es mit Werten, die aus einem std::vector-Objekt verschoben wurden, dessen Werttyp derselbe ist wie T, aber sich von UnderlyingType unterscheidet.
Array(std::initializer_list<UnderlyingType>)	Konstruiert ein Array-Objekt und füllt es mit Werten aus der angegebenen Initialisierungsliste, die Elemente des Typs UnderlyingType enthält.
Array(const std::array<UnderlyingType, InitArraySize>&)	Konstruiert ein Array-Objekt und füllt es mit Werten aus dem angegebenen Array, das Elemente des Typs UnderlyingType enthält.
Array(std::initializer_list<bool>, int)	Konstruiert ein Array-Objekt und füllt es mit Werten aus der angegebenen Initialisierungsliste, die Elemente des Typs bool enthält.
begin()	Gibt einen Iterator auf das erste Element des Containers zurück. Ist der Container leer, ist der zurückgegebene Iterator gleich end().
begin() const	Gibt einen Iterator auf das erste Element des const‑qualifizierten Containers zurück. Ist der Container leer, ist der zurückgegebene Iterator gleich end().
static BinarySearch(System::ArrayPtr<T>, const T&)	Führt eine binäre Suche im sortierten Array durch.
static BinarySearch(System::ArrayPtr<T>, const Y&, const SharedPtr<Collections::Generic::IComparer<Z>>&)	NICHT IMPLEMENTIERT.
cbegin() const	Gibt einen Iterator auf das erste const‑qualifizierte Element des Containers zurück. Ist der Container leer, ist der zurückgegebene Iterator gleich cend().
cend() const	Gibt einen Iterator auf das Element zurück, das dem letzten Element des Containers folgt. Dieses Element dient als Platzhalter; ein Zugriff darauf führt zu undefiniertem Verhalten.
Clear() override	Nicht unterstützt, weil das vom aktuellen Objekt dargestellte Array schreibgeschützt ist.
static Clear(const ArrayPtr<Type>&, int, int)	Ersetzt count Werte, beginnend beim Index startIndex, im angegebenen Array durch Standardwerte.
Clone()	Klonen des Arrays.
static ConstrainedCopy(const ArrayPtr<SrcType>&, int64_t, const ArrayPtr<DstType>&, int64_t, int64_t)	Kopiert einen Bereich von Elementen aus einem System.Array, beginnend bei der angegebenen Quelle.
Contains(const T&) const override	Bestimmt, ob das angegebene Element im Array ist.
static ConvertAll(ArrayPtr<InputType>, Converter<InputType, OutputType>)	Konstruiert ein neues Array-Objekt und füllt es mit Elementen des angegebenen Arrays, die mithilfe des angegebenen Converter-Delegaten in den Typ OutputType konvertiert wurden.
static ConvertAll(ArrayPtr<InputType>, std::function<OutputType(InputType)>)	Konstruiert ein neues Array-Objekt und füllt es mit Elementen des angegebenen Arrays, die mithilfe des angegebenen Converter-Funktionsobjekts in den Typ OutputType konvertiert wurden.
static Copy(const ArrayPtr<SrcType>&, const ArrayPtr<DstType>&, int64_t)	Kopiert die angegebene Anzahl von Elementen vom Quellarray zum Zielarray.
static Copy(System::Details::ArrayView<SrcType>, const ArrayPtr<DstType>&, int64_t)	Kopiert die angegebene Anzahl von Elementen von der Quellarray-Ansicht zum Zielarray.
static Copy(const ArrayPtr<SrcType>&, System::Details::ArrayView<DstType>, int64_t)	Kopiert die angegebene Anzahl von Elementen vom Quellarray zur Zielarray-Ansicht.
static Copy(System::Details::ArrayView<SrcType>, System::Details::ArrayView<DstType>, int64_t)	Kopiert die angegebene Anzahl von Elementen von der Quellarray-Ansicht zur Zielarray-Ansicht.
static Copy(System::Details::StackArray<SrcType, N>&, const ArrayPtr<DstType>&, int64_t)	Kopiert die angegebene Anzahl von Elementen vom Quellarray im Stack zum Zielarray.
static Copy(const ArrayPtr<SrcType>&, System::Details::StackArray<DstType, N>&, int64_t)	Kopiert die angegebene Anzahl von Elementen vom Quellarray zum Zielarray im Stack.
static Copy(System::Details::StackArray<SrcType, NS>&, System::Details::StackArray<DstType, ND>&, int64_t)	Kopiert die angegebene Anzahl von Elementen vom Quellarray im Stack zum Zielarray im Stack.
static Copy(const ArrayPtr<SrcType>&, int64_t, const ArrayPtr<DstType>&, int64_t, int64_t)	Kopiert eine angegebene Anzahl von Elementen vom Quellarray, beginnend beim angegebenen Index, zur angegebenen Position im Zielarray.
static Copy(System::Details::ArrayView<SrcType>, int64_t, const ArrayPtr<DstType>&, int64_t, int64_t)	Kopiert eine angegebene Anzahl von Elementen von der Quellarray-Ansicht, beginnend beim angegebenen Index, zur angegebenen Position im Zielarray.
static Copy(const ArrayPtr<SrcType>&, int64_t, System::Details::ArrayView<DstType>, int64_t, int64_t)	Kopiert eine angegebene Anzahl von Elementen vom Quellarray, beginnend beim angegebenen Index, zur angegebenen Position in der Zielarray-Ansicht.
static Copy(System::Details::ArrayView<SrcType>, int64_t, System::Details::ArrayView<DstType>, int64_t, int64_t)	Kopiert eine angegebene Anzahl von Elementen von der Quellarray-Ansicht, beginnend beim angegebenen Index, zur angegebenen Position in der Zielarray-Ansicht.
static Copy(System::Details::StackArray<SrcType, N>&, int64_t, const ArrayPtr<DstType>&, int64_t, int64_t)	Kopiert eine angegebene Anzahl von Elementen vom Quellarray im Stack, beginnend beim angegebenen Index, zur angegebenen Position im Zielarray.
static Copy(const ArrayPtr<SrcType>&, int64_t, System::Details::StackArray<DstType, N>&, int64_t, int64_t)	Kopiert eine angegebene Anzahl von Elementen vom Quellarray, beginnend beim angegebenen Index, zur angegebenen Position im Zielarray im Stack.
static Copy(System::Details::StackArray<SrcType, NS>&, int64_t, System::Details::StackArray<DstType, ND>&, int64_t, int64_t)	Kopiert eine angegebene Anzahl von Elementen vom Quellarray im Stack, beginnend beim angegebenen Index, zur angegebenen Position im Zielarray im Stack.
static Copy(System::Details::ArrayView<SrcType>&, int64_t, System::Details::StackArray<DstType, ND>&, int64_t, int64_t)	Kopiert eine angegebene Anzahl von Elementen von der Quellarray-Ansicht, beginnend beim angegebenen Index, zur angegebenen Position im Zielarray im Stack.
CopyTo(ArrayPtr<T>, int) override	Kopiert alle Elemente des aktuellen Arrays in das angegebene Zielarray. Elemente werden in das Zielarray eingefügt, beginnend beim durch das Argument arrayIndex angegebenen Index.
CopyTo(const ArrayPtr<DstType>&, int64_t) const	Kopiert alle Elemente des aktuellen Arrays in das angegebene Zielarray. Elemente werden in das Zielarray eingefügt, beginnend bei dem durch das Argument dstIndex angegebenen Index.
CopyTo(const System::Details::ArrayView<DstType>&, int64_t) const	Kopiert alle Elemente des aktuellen Arrays in die angegebene Ziel-Array-Ansicht. Elemente werden in die Ziel-Array-Ansicht eingefügt, beginnend bei dem durch das Argument dstIndex angegebenen Index.
CopyTo(const ArrayPtr<DstType>&, int64_t, int64_t, int64_t) const	Kopiert eine angegebene Anzahl von Elementen des aktuellen Arrays, beginnend an der angegebenen Position, in das angegebene Zielarray. Elemente werden in das Zielarray eingefügt, beginnend bei dem durch das Argument dstIndex angegebenen Index.
CopyTo(const System::Details::ArrayView<DstType>&, int64_t, int64_t, int64_t) const	Kopiert eine angegebene Anzahl von Elementen des aktuellen Arrays, beginnend an der angegebenen Position, in die angegebene Ziel-Array-Ansicht. Elemente werden in die Ziel-Array-Ansicht eingefügt, beginnend bei dem durch das Argument dstIndex angegebenen Index.
Count() const	Gibt eine Zahl zurück, die die Gesamtzahl aller Elemente in allen Dimensionen des Arrays darstellt.
crbegin() const	Gibt einen Reverse‑Iterator auf das erste Element des umgekehrten Containers zurück. Er entspricht dem letzten Element des nicht umgekehrten Containers. Ist der Container leer, ist der zurückgegebene Iterator gleich crend().
crend() const	Gibt einen Reverse‑Iterator auf das Element zurück, das dem letzten Element des umgekehrten Containers folgt. Er entspricht dem Element, das dem ersten Element des nicht umgekehrten Containers vorausgeht. Dieses Element dient als Platzhalter; ein Zugriff darauf führt zu undefiniertem Verhalten.
data()	Gibt eine Referenz auf die interne Datenstruktur zurück, die zum Speichern der Array-Elemente verwendet wird.
data() const	Gibt eine konstante Referenz auf die interne Datenstruktur zurück, die zum Speichern der Array-Elemente verwendet wird.
data_ptr()	Gibt einen rohen Zeiger auf den Anfang des Speicherpuffers zurück, in dem die Array-Elemente gespeichert sind.
data_ptr() const	Gibt einen konstanten rohen Zeiger auf den Anfang des Speicherpuffers zurück, in dem die Array-Elemente gespeichert sind.
end()	Gibt einen Iterator auf das Element zurück, das dem letzten Element des Containers folgt. Dieses Element dient als Platzhalter; ein Zugriff darauf führt zu undefiniertem Verhalten.
end() const	Gibt einen Iterator auf das Element zurück, das dem letzten Element des const‑qualifizierten Containers folgt. Dieses Element dient als Platzhalter; ein Zugriff darauf führt zu undefiniertem Verhalten.
static Exists(ArrayPtr<T>, std::function<bool(T)>)	Bestimmt, ob das angegebene Array-Objekt ein Element enthält, das die Anforderungen des angegebenen Prädikats erfüllt.
static Find(System::ArrayPtr<T>, System::Predicate<T>)	Sucht das erste Element im angegebenen Array, das die Bedingungen des angegebenen Prädikats erfüllt.
static FindAll(System::ArrayPtr<T>, System::Predicate<T>)	Ruft alle Elemente ab, die den durch das angegebene Prädikat definierten Bedingungen entsprechen.
static FindIndex(System::ArrayPtr<T>, System::Predicate<T>)	Sucht das erste Element im angegebenen Array, das die Bedingungen des angegebenen Prädikats erfüllt.
static ForEach(const ArrayPtr<T>&, System::Action<T>)	Führt die angegebene Aktion für jedes Element des angegebenen Arrays aus.
get_Count() const override	Gibt die Größe des Arrays zurück.
get_IsReadOnly() const override	Gibt an, ob das Array schreibgeschützt ist.
get_Length() const	Gibt einen 32‑Bit‑Integer zurück, der die Gesamtzahl aller Elemente in allen Dimensionen des Arrays darstellt.
get_LongLength() const	Gibt einen 64‑Bit‑Integer zurück, der die Gesamtzahl aller Elemente in allen Dimensionen des Arrays darstellt.
get_Rank() const	NICHT IMPLEMENTIERT.
GetEnumerator() override	Gibt einen Zeiger auf das Enumerator-Objekt zurück, das eine IEnumerator‑Schnittstelle für die Elemente des vom aktuellen Objekt repräsentierten Arrays bereitstellt.
GetLength(int)	Gibt die Anzahl der Elemente in der angegebenen Dimension zurück.
GetLongLength(int)	Gibt die Anzahl der Elemente in der angegebenen Dimension als 64‑Bit‑Integer zurück.
GetLowerBound(int) const	Gibt die untere Grenze der angegebenen Dimension zurück.
GetSizeTLength() const	Gibt eine std::size_t‑Variable zurück, die die Gesamtzahl aller Elemente in allen Dimensionen des Arrays darstellt.
GetUpperBound(int)	Gibt die obere Grenze der angegebenen Dimension zurück.
idx_get(int) const override	Gibt das Element am angegebenen Index zurück.
idx_set(int, T) override	Setzt den angegebenen Wert als Element des Arrays am angegebenen Index.
IndexOf(const T&) const override	Bestimmt den Index des ersten Vorkommens des angegebenen Elements im Array.
static IndexOf(const ArrayPtr<ArrayType>&, const ValueType&)	Bestimmt den Index des ersten Vorkommens des angegebenen Elements im Array.
static IndexOf(const ArrayPtr<ArrayType>&, const ValueType&, int)	Bestimmt den Index des ersten Vorkommens des angegebenen Elements im Array, beginnend ab dem angegebenen Index.
static IndexOf(const ArrayPtr<ArrayType>&, const ValueType&, int, int)	Bestimmt den Index des ersten Vorkommens des angegebenen Elements in einem durch den Startindex und die Anzahl der Elemente im Bereich definierten Bereich des Arrays.
Init(const T)	Füllt das vom aktuellen Objekt repräsentierte Array mit den Werten aus dem angegebenen Array.
Initialize()	Füllt das Array mit den standardmäßig konstruierten Objekten des Typs T.
Insert(int, const T&) override	Nicht unterstützt, weil das vom aktuellen Objekt repräsentierte Array schreibgeschützt ist.
static LastIndexOf(const ArrayPtr<ArrayType>&, const ValueType&, int, int)	Bestimmt den Index des letzten Vorkommens des angegebenen Elements in einem durch den Startindex und die Anzahl der Elemente im Bereich definierten Bereich des Arrays.
static LastIndexOf(const ArrayPtr<ArrayType>&, const ValueType&, int)	Bestimmt den Index des letzten Vorkommens des angegebenen Elements im Array, beginnend ab dem angegebenen Index.
static LastIndexOf(const ArrayPtr<ArrayType>&, const ValueType&)	Bestimmt den Index des letzten Vorkommens des angegebenen Elements im Array.
Max() const	Findet das größte Element im Array unter Verwendung von operator<() zum Vergleichen der Elemente.
Min() const	Findet das kleinste Element im Array unter Verwendung von operator<() zum Vergleichen der Elemente.
operator[](int)	Gibt ein Element am angegebenen Index zurück.
operator[](int) const	Gibt ein Element am angegebenen Index zurück.
rbegin()	Gibt einen Reverse-Iterator auf das erste Element des umgekehrten Containers zurück. Er entspricht dem letzten Element des nicht umgekehrten Containers. Wenn der Container leer ist, ist der zurückgegebene Iterator gleich rend().
rbegin() const	Gibt einen Reverse-Iterator auf das erste Element des umgekehrten Containers zurück. Er entspricht dem letzten Element des nicht umgekehrten Containers. Wenn der Container leer ist, ist der zurückgegebene Iterator gleich rend().
Remove(const T&) override	Nicht unterstützt, weil das vom aktuellen Objekt dargestellte Array schreibgeschützt ist.
RemoveAt(int) override	Nicht unterstützt, weil das vom aktuellen Objekt repräsentierte Array schreibgeschützt ist.
rend()	Gibt einen Reverse‑Iterator auf das Element zurück, das dem letzten Element des umgekehrten Containers folgt. Er entspricht dem Element, das dem ersten Element des nicht umgekehrten Containers vorausgeht. Dieses Element dient als Platzhalter; ein Zugriff darauf führt zu undefiniertem Verhalten.
rend() const	Gibt einen Reverse‑Iterator auf das Element zurück, das dem letzten Element des umgekehrten Containers folgt. Er entspricht dem Element, das dem ersten Element des nicht umgekehrten Containers vorausgeht. Dieses Element dient als Platzhalter; ein Zugriff darauf führt zu undefiniertem Verhalten.
static Resize(ArrayPtr<Type>&, int)	Ändert die Größe des angegebenen Arrays auf den angegebenen Wert oder erstellt ein neues Array mit der angegebenen Größe.
static Reverse(const ArrayPtr<Type>&)	Kehrt die Elemente im angegebenen Array um.
static Reverse(const ArrayPtr<Type>&, int, int)	Kehrt einen Bereich von Elementen im angegebenen Array um.
SetTemplateWeakPtr(uint32_t) override	Lässt das Array gespeicherte Zeiger als schwach behandeln (falls zutreffend).
SetValue(const T&, int)	Setzt den Wert des Elements am angegebenen Index.
static Sort(const ArrayPtr<Type>&)	Sortiert die Elemente im angegebenen Array unter Verwendung des Standardvergleichs.
static Sort(const ArrayPtr<Type>&, int, int)	Sortiert einen Bereich von Elementen im angegebenen Array unter Verwendung des Standardvergleichs.
static Sort(const ArrayPtr<Type>&, const SharedPtr<System::Collections::Generic::IComparer<T>>&)	Sortiert die Elemente im angegebenen Array unter Verwendung des angegebenen Vergleichs.
static Sort(const ArrayPtr<Type>&, const SharedPtr<System::Collections::Generic::IComparer<Y>>&)	NICHT IMPLEMENTIERT.
static Sort(const ArrayPtr<TKey>&, const ArrayPtr<TValue>&)	Sortiert zwei Arrays, eines mit Schlüsseln und das andere mit den zugehörigen Elementen, basierend auf den Werten des Schlüssel‑Arrays, dessen Elemente mit operator< verglichen werden.
static Sort(const ArrayPtr<TKey>&, const ArrayPtr<TValue>&, int, int)	Sortiert zwei Arrays, eines mit Schlüsseln und das andere mit den zugehörigen Elementen, basierend auf den Werten des Schlüssel‑Arrays, dessen Elemente mit dem Standardvergleich verglichen werden.
static TrueForAll(System::ArrayPtr<T>, System::Predicate<T>)	Bestimmt, ob alle Elemente im angegebenen Array die durch das angegebene Prädikat definierten Bedingungen erfüllen.
virtualizeBeginConstIterator() const override	Gibt die Implementierung des const begin-Iterators für den aktuellen Container zurück.
virtualizeBeginIterator() override	Gibt die Implementierung des begin-Iterators für den aktuellen Container zurück.
virtualizeEndConstIterator() const override	Gibt die Implementierung des const end-Iterators für den aktuellen Container zurück.
virtualizeEndIterator() override	Gibt die Implementierung des end-Iterators für den aktuellen Container zurück.

Typedefs

Typedef	Beschreibung
const_iterator	Konstanter Iterator-Typ.
const_reverse_iterator	Konstanter Reverse-Iterator-Typ.
EnumerablePtr	Ein Alias für den Shared‑Pointer‑Typ, der auf ein IEnumerable‑Objekt zeigt, das Elemente des Typs T enthält.
EnumeratorPtr	Ein Alias für den Shared-Pointer-Typ, der auf ein IEnumerator-Objekt zeigt, das Elemente vom Typ T enthält.
iterator	Iterator-Typ.
reverse_iterator	Reverse-Iterator-Typ.
UnderlyingType	Alias für den Typ, der verwendet wird, um jedes Element des Arrays darzustellen.
ValueType	Alias für den Typ der Elemente des Arrays.

Hinweise

#include <system/array.h>
#include <system/smart_ptr.h>

using namespace System;

void Print(const SmartPtr<Array<int32_t>> &arrayPtr)
{
  for (auto item: arrayPtr)
  {
    std::cout << item << ' ';
  }
  std::cout << std::endl;
}

int main()
{
  // Erstelle und fülle das Array.
  auto arrayPtr = MakeObject<Array<int32_t>>(5, 0);
  for (auto i = 0; i < arrayPtr->get_Length(); ++i)
  {
    arrayPtr[i] = 5 - i;
  }

  // Gib die Array-Elemente aus.
  Print(arrayPtr);

  // Sortiere die Array-Elemente aufsteigend.
  Array<int32_t>::Sort(arrayPtr);

  // Gib die Array-Elemente aus.
  Print(arrayPtr);

  // Gib die Anzahl der Array-Elemente aus.
  std::cout << arrayPtr->get_Length() << std::endl;

  // Gib den Index des Elements aus, das gleich 4 ist.
  std::cout << arrayPtr->IndexOf(4) << std::endl;

  // Ändere die Größe des Arrays.
  Array<int32_t>::Resize(arrayPtr, 3);

  // Gib die Array-Elemente aus.
  Print(arrayPtr);

  return 0;
}
/*
This code example produces the following output:
5 4 3 2 1
1 2 3 4 5
5
3
1 2 3
*/

Siehe auch

Class Object
Class IList
Namespace System
Library Aspose.Page for C++

System::Activator Klasse System::ArraySegment Klasse