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üllkonstruktor.
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üllkonstruktor.
Array(int, const T)	Füllkonstruktor.
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 wie T ist, 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 wie T ist, 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()	Klont das Array.
static ConstrainedCopy(const ArrayPtr<SrcType>&, int64_t, const ArrayPtr<DstType>&, int64_t, int64_t)	Kopiert einen Bereich von Elementen aus einem System.Array, beginnend beim angegebenen Quell.
Contains(const T&) const override	Bestimmt, ob das angegebene Element im Array ist.
static ConvertAll(ArrayPtr<InputType>, Converter<InputType, OutputType>)	Erstellt 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)>)	Erstellt 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 Quell-Array-Ansicht zum Zielarray.
static Copy(const ArrayPtr<SrcType>&, System::Details::ArrayView<DstType>, int64_t)	Kopiert die angegebene Anzahl von Elementen vom Quellarray zur Ziel-Array-Ansicht.
static Copy(System::Details::ArrayView<SrcType>, System::Details::ArrayView<DstType>, int64_t)	Kopiert die angegebene Anzahl von Elementen von der Quell-Array-Ansicht zur Ziel-Array-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 aus dem 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 aus der Quell-Array-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 aus dem Quellarray, beginnend beim angegebenen Index, zur angegebenen Position in der Ziel-Array-Ansicht.
static Copy(System::Details::ArrayView<SrcType>, int64_t, System::Details::ArrayView<DstType>, int64_t, int64_t)	Kopiert eine angegebene Anzahl von Elementen aus der Quell-Array-Ansicht, beginnend beim angegebenen Index, zur angegebenen Position in der Ziel-Array-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 aus dem 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 aus der Quell-Array-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 beim 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 beim durch das Argument dstIndex angegebenen Index.
CopyTo(const ArrayPtr<DstType>&, int64_t, int64_t, int64_t) const	Kopiert eine angegebene Anzahl von Elementen aus dem aktuellen Array, beginnend bei der angegebenen Position, in das angegebene Zielarray. Elemente werden in das Zielarray eingefügt, beginnend beim 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 aus dem aktuellen Array, beginnend an der angegebenen Position, in die angegebene Ziel-Array-Ansicht. Elemente werden in die Ziel-Array-Ansicht eingefügt, beginnend bei dem Index, der durch das Argument dstIndex angegeben ist.
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>)	Durchsucht das angegebene Array nach dem ersten Element, 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>)	Durchsucht das angegebene Array nach dem ersten Element, 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 die 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 beim angegebenen Index.
static IndexOf(const ArrayPtr<ArrayType>&, const ValueType&, int, int)	Bestimmt den Index des ersten Vorkommens des angegebenen Elements in einem Bereich von Elementen des Arrays, der durch den Startindex und die Anzahl der Elemente im Bereich festgelegt ist.
Init(const T)	Füllt das vom aktuellen Objekt dargestellte Array mit den Werten aus dem angegebenen Array.
Initialize()	Füllt das Array mit den standardmäßig konstruierten Objekten vom Typ T.
Insert(int, const T&) override	Nicht unterstützt, weil das vom aktuellen Objekt dargestellte Array schreibgeschützt ist.
static LastIndexOf(const ArrayPtr<ArrayType>&, const ValueType&, int, int)	Bestimmt den Index des letzten Vorkommens des angegebenen Elements in einem Bereich von Elementen des Arrays, der durch den Startindex und die Anzahl der Elemente im Bereich festgelegt ist.
static LastIndexOf(const ArrayPtr<ArrayType>&, const ValueType&, int)	Bestimmt den Index des letzten Vorkommens des angegebenen Elements im Array, beginnend beim 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 Vergleich der Elemente.
Min() const	Findet das kleinste Element im Array unter Verwendung von operator<() zum Vergleich 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 dargestellte 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 mit dem Standardvergleich.
static Sort(const ArrayPtr<Type>&, int, int)	Sortiert einen Bereich von Elementen im angegebenen Array mit dem Standardvergleich.
static Sort(const ArrayPtr<Type>&, const SharedPtr<System::Collections::Generic::IComparer<T>>&)	Sortiert die Elemente im angegebenen Array mit dem angegebenen Vergleich.
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 - zugehörige Elemente, 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 - zugehörige Elemente, 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	Liefert die Implementierung des begin‑const‑Iterators für den aktuellen Container.
virtualizeBeginIterator() override	Liefert die Implementierung des begin‑Iterators für den aktuellen Container.
virtualizeEndConstIterator() const override	Liefert die Implementierung des end‑const‑Iterators für den aktuellen Container.
virtualizeEndIterator() override	Liefert die Implementierung des end‑Iterators für den aktuellen Container.

Typedefs

Typedef.	Beschreibung
const_iterator	Typ des konstanten Iterators.
const_reverse_iterator	Typ des konstanten Reverse-Iterators.
EnumerablePtr	Ein Alias für den Shared‑Pointer‑Typ, der auf ein IEnumerable‑Objekt zeigt, das Elemente vom Typ 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	Iteratortyp.
reverse_iterator	Reverse-Iteratortyp.
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;

  // Passe die Größe des Arrays an.
  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.Font for C++

System::Activator Klasse System::ArraySegment‑Klasse