Ersetzt an der durch Index angegebenen Stelle ein Element oder einen Teil eines Array.

Wenn ein Array an diese Funktion angeschlossen wird, passt die Funktion automatisch zur Anzeige der Index-Eingänge für jede Dimension im Array an. Die Standarddatentypen für diese polymorphe Funktion sind im Anschlussfeld dargestellt.


icon

Ein-/Ausgänge

  • c1ddbl.png Array —

    n-dimensionales Array ist das Array, in dem Elemente, Zeilen, Spalten oder Seiten ersetzt werden sollen. Der Eingang kann ein n-dimensionales Array beliebigen Typs sein.

  • ci32.png Index —

    Index 0..n-1 gibt das Element, die Reihe, Spalte oder die Seite an, die im Array ersetzt werden soll. Wenn Sie diesen Eingang offen lassen, wird die Anzahl der zu ersetzenden Elemente in n-dimensionales Array durch die Dimensionen des Eingangs Neues Element/Teil-Array beginnend mit dem Element 0 bestimmt. Wenn Sie einen Index angeben, ohne die folgenden Indizes zu verbinden, setzt diese Funktion ihre Arbeit am zuletzt angegebenen Index fort.

    For example, if you do not wire this input and n-dimensionales Array consists of three elements, and Neues Element/Teil-Array consists of two elements, this function replaces only the first two elements (0 and 1) ofn-dimensionales Array. If you specify 1 for the first index without wiring other indexes and n-dimensionales Array consists of three elements, and Neues Element/Teil-Array consists of two elements, this function replaces only the second and the third element (1 and 2) of n-dimensionales Array.
  • cdbl.png Neues Element/Teil-Array —

    Neues Element/Teil-Array ist das Array oder Element, durch das ein Element bzw. eine Zeile, Spalte oder Seite im n-dimensionales Array ersetzt werden soll.

    Hinweis Der Grunddatentyp des neuen Elements oder Teil-Arrays muss mit dem Typ des Eingangs-Arrays übereinstimmen.
  • i1duvoid.png Array (Ausgang) —

    Array (Ausgang) ist das Array mit den ersetzten Bestandteilen.

    • Durch Vergrößern oder Verkleinern der Funktion lassen sich mehrere Elemente oder Teile des Arrays gleichzeitig ersetzen. Das Original-Array am Eingang wird nicht verändert. Wenn ein Teil-Array zu groß ist und nicht in das Array passt, wird ein Teil davon abgeschnitten. Wenn ein Index negativ ist oder größer als die dazugehörende Dimension in n-dimensionales Array, so hat die Funktion keine Auswirkung.

    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 Das LabVIEW FPGA Module unterstützt nur eindimensionale Arrays, die sich während der Kompilierung auf eine Größe auflösen. Sie können konstante oder nicht konstante Eingänge verwenden.
    Timing Diese Funktion wird in einer Taktperiode ausgeführt. Wenn Sie jedoch sofort eine Konstante mit dem Eingang Index verbinden, 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 der Größe von Neues Element/Teil-Array. Wenn der Index konstant ist, beansprucht diese Funktion keine FPGA-Ressourcen.
    Hinweise Bei großen Arrays kann die Funktion "Teil-Array ersetzen" möglicherweise nicht innerhalb einer Taktperiode ausgeführt werden, was zu einem Kompilierungsfehler führt.

    Beispiele

    Die folgenden Beispieldateien sind in LabVIEW enthalten.

    • labview\examples\Arrays\Replace Array Elements.vi