Variablen-Container durchsuchen - Funktion
- Aktualisiert2025-07-30
- 3 Minute(n) Lesezeit
Durchsucht einen Variablen-Container und gibt ein Array aus Referenzen auf die gefundenen Variablenobjekte aus, die Ihren Suchkriterien entsprechen. Mit dieser Funktion können Sie auch Variablen programmatisch suchen.
Alle Suchkriterien sind optional. Wenn Sie einen Eingang für ein bestimmtes Suchkriterium offen lassen, wird das Kriterium nicht berücksichtigt.

Ein-/Ausgänge
Klasse
—
Klasse gibt die Klasse des zu suchenden Variablenobjekts an. Die Standardeinstellung lautet Variablenobjekt.
Container-Referenz (Eingang)
—
Container-Referenz (Eingang) gibt den zu Variablen-Container an, unter dem gesucht werden soll. Es wird die gesamte Container-Hierarchie unter dem angegebenen Container durchsucht. Die Funktion durchsucht die partielle URL aller Variablen unter dem angegebenen Container. Die partiellen URLs enthalten nicht die URL des Containers.
Regulärer Ausdruck
—
Regulärer Ausdruck gibt das Muster an, das innerhalb der Variablenobjekt-URLs gesucht werden soll. Die Standardeinstellung ist ein leerer String. Diese Funktion verwendet dieselben Regeln für reguläre Ausdrücke wie die Funktion " Regulärer Ausdruck abgleichen" .
Datentyp
—
Datentyp gibt den Datentyp der Umgebungsvariablen an, nach denen Sie suchen möchten. Der Standardwert ist variant, d. h., wenn Sie das Terminal unverdrahtet lassen, filtert die Funktion nicht nach dem Datentyp. Wenn Sie allerdings ein Element oder eine Konstante des Datentyps "Variant" mit diesem Anschluss verbinden, sucht die Funktion nach Variablen mit dem Datentyp "Variant".
Fehler (Eingang)
—
Fehler (Eingang) beschreibt Fehlerbedingungen, die vor der Ausführung des Knotens auftreten. An Fehler (Eingang) werden Standardfehlerdaten übergeben.
Zugriffsart
—
Zugriffsart gibt die Datenrichtung der zu suchenden Umgebungsvariablen an. Die Standardeinstellung lautet sowohl bei Lese- als auch bei Schreibzugriff Zulässig.
Container-Referenz (Ausgang)
—
Container-Referenz (Ausgang) ist die Referenz auf den Umgebungsvariablen-Container, den Sie mit Container-Referenz (Eingang) verbunden haben.
Referenz-Array (Ausgang)
—
Referenz-Array (Ausgang) enthält die Objektreferenzen der gefundenen Variablen.
Fehler (Ausgang)
—
Fehler (Ausgang) enthält Angaben zum Fehler. Dieser Ausgang ist ein Standardausgang zur Fehlerausgabe. |
Bei der Suche wird ein angegebener Regulärer Ausdruck auf die partiellen Variablen-ID-URLs der Variablenobjekte im angegebenen Variablen-Container angewandt. Bei der partiellen URL wird der Anfang der Original-URL weggelassen, die in Form einer Referenz am Eingang Container-Referenz (Eingang) anliegt.
Wenn z. B. am Eingang Container-Referenz (Eingang) eine URL mit dem Namen ni.var.psp://lib1 angegeben ist und das Variablenobjekt die URL ni.var.psp://lib1/lib2/var1 hat, lautet die partielle URL lib2/var1.
Klasse
—
Regulärer Ausdruck
—
Datentyp
—
Fehler (Eingang)
—
Zugriffsart
—
Read Access
—
Container-Referenz (Ausgang)
—
Referenz-Array (Ausgang)
—
Fehler (Ausgang)
—