Gibt das Element oder Teil-Array des Eingangs n-dimensionales Array am angegebenen Index aus.

Wenn ein Array an diese Funktion angeschlossen wird, zeigt diese automatisch Index-Eingänge für jede Dimension des Arrays an, das Sie mit n-dimensionales Array verbunden haben. Zum Hinzufügen zusätzlicher Element oder Teil-Array-Anschlüsse ziehen Sie die Funktion mit der Maus auf. Die Standarddatentypen für diese polymorphe Funktion sind im Anschlussfeld dargestellt.


icon

Ein-/Ausgänge

  • c1ddbl.png Array —

    n-dimensionales Array kann ein beliebiges n-dimensionales Array sein.

    Wenn n-dimensionales Array ein leeres Array ist, gibt Element oder Teil-Array den Standardwert mit dem angegebenen Array-Datentyp aus.

  • ci32.png Index —

    Index 0..n-1 gibt eine Zahl an, die sich auf eine Position im Eingangs-Arrays bezieht. Der Index-Eingang für jede Dimension des Arrays wird automatisch von LabVIEW bereitgestellt.

  • ipoly.png Element —

    Element oder Teil-Array hat den gleichen Typ wie die Elemente von n-dimensionales Array.

    • Bei Arrays mit mehr als einer Dimension können Sie die Indizierung einer Dimension deaktivieren, indem Sie den dazugehörigen Index-Eingang offen lassen. Standardmäßig ist die Indizierung der ersten Dimension aktiviert, alle anderen sind deaktiviert. Die deaktivierten Anschlüsse sind von einem schwarzen Rechteck umrandet. Bei Aktivierung ist es ausgefüllt. Sie können eine Konstante oder ein Bedienelement mit den aktiven Index-Eingängen verbinden.

    So muss beispielsweise zur Indizierung einer Zeile in einem 2D-Array der erste Index-Eingang aktiviert und der zweite Index-Eingang deaktiviert sein. Wenn Sie das gleiche 2D-Array spaltenweise indizieren möchten, ziehen Sie die Funktion mit der Maus weiter auf, so dass weitere Eingangsanschlüsse zu sehen sind. Die neuen Anschlüsse haben ihren eigenen Teil-Array-Ausgang. Wenn alle Index-Eingänge offen gelassen werden, indiziert das erste Teil-Array die Zeile 0, das zweite die Zeile 1, und so weiter.

    Details zum FPGA-Modul

    Die folgenden Details gelten, wenn Sie dieses Objekt in einem FPGA-VI verwenden.

    Hinweis Die folgenden Details können sich mit jeder Version des LabVIEW FPGA Modules ändern.
    SCTL (Single-Cycle Timed Loop) Unterstützt.
    Verwendung k. A.
    Timing Diese Funktion wird in einer Taktperiode ausgeführt, es sei denn, Sie verbinden sofort eine Konstante mit dem Eingang Index. In diesem Fall erfolgt die Auswahl während der Kompilierung und die Funktion benötigt keine Taktperioden.
    Ressourcen Wenn der Index nicht konstant ist, beansprucht diese Funktion FPGA-Ressourcen proportional zur Größe des Arrays und des Elements. Wenn der Index konstant ist, beansprucht diese Funktion keine FPGA-Ressourcen.
    Hinweise Bei großen Arrays kann die Funktion "Array indizieren" möglicherweise nicht innerhalb einer Taktperiode ausgeführt werden, was zu einem Kompilierungsfehler führt.

    Funktionsweise für Werte außerhalb des Bereichs

    Wenn der Index kleiner als 0 oder größer als die Anzahl der Dimensionen im Array ist, gibt diese Funktion den Standardwert des für dieses Array definierten Datentyps aus.

    Welcher Index bezieht sich auf welche Dimension?

    Die Array-Funktionen in LabVIEW fragen den Array-Inhalt zeilenweise ab. Bei einem 2D-Array ist die Zeile der erste (höhere) Index. Die Spalte ist der letzte (niedrigere) Index. Bei Arrays mit einer größeren Anzahl von Dimensionen wird der Spalte nach wie vor der letzte Index zugewiesen. Alle zusätzlichen Dimensionen sind höherwertig und werden an den Anfang angefügt. Daher ist "Vol." der erste Index, gefolgt von "Seite", "Zeile" und "Spalte". Hierbei handelt es sich lediglich um Indexbezeichner.

    Unverbundene Index-Eingänge

    Unverbundene Eingänge des Typs Index ermöglichen das Abfragen eines Teil-Arrays des Arrays statt eines Elements. So kann beispielsweise Spalte 1 aus einem 2D-Array ausgelesen werden, indem im Spaltenindex 1 angegeben wird und der Zeilenindex unverbunden bleibt.

    Wenn der Eingang Index für ein 1D-Array unverbunden bleibt, gibt die Funktion "Array indizieren" das erste Element des Arrays aus.

    Wie verhält sich "Index" bei mehreren Ausgängen?

    Wenn Sie den Knoten nach unten aufziehen und mehrere Ausgänge des Typs Element oder Teil-Array anzeigen, werden für jeden Ausgang Index-Eingänge angezeigt. Der Wert, der mit den Index-Eingängen verbunden wird, bestimmt den Wert des entsprechenden Ausgangs. Wenn Sie jedoch keine Werte mit den Index-Eingängen verbinden, gibt der entsprechende Ausgang Element oder Teil-Array das Element oder Teil-Array aus, das auf den vorherigen Ausgang Element oder Teil-Array im Original-Array folgt. Zur Veranschaulichung dieser Beziehung sehen Sie sich den Abschnitt "Beispiele" an.

    Beispiele für verschiedene Eingangskonfigurationen

    In der folgenden Abbildung und der folgenden Tabelle wird das Verhalten der Funktion für eine Vielzahl von Eingangswerten näher erläutert:

    Ausgang Wert Kommentare
    Element, alle Indizes verbunden 1 ---
    Teil-Array, Zeile verbunden [1, 1, 1] Wenn kein Wert für die Spaltendimension festgelegt wurde, gibt die Funktion "Array indizieren" die gesamte Zeile aus, die am Eingang Zeile festgelegt wurde.
    Teil-Array, Indizes unverbunden [2, 2, 2] Dieser Ausgang hat keinen Wert festgelegt für die entsprechenden Eingänge Zeile und Spalte. Daher gibt die Funktion das Teil-Array aus, das unmittelbar auf den vorherigen Ausgang folgt.
    Teil-Array, Spalte verbunden [0, 1, 2] Wenn kein Wert für die Zeilendimension festgelegt wird, gibt die Funktion "Array indizieren" die gesamte Spalte aus, die am Eingang Spalte festgelegt wurde.