VISA: Ressource suchen - Funktion

Ausdruck entspricht dem jeweiligen Wert des Geräts, das an einem bestimmten Anschluss angeschlossen ist.

Mit dem angegebenen Beschreibungs-String werden die Kriterien zur Suche von Geräten ("GPIB", "GPIB-VXI", "VXI", "alle VXI", "seriell" oder "alle") an einem bestimmten Anschluss festgelegt. In der folgenden Tabelle sehen Sie alle gültigen Sonderzeichen und Operatoren.

Sonderzeichen und Operatoren	Bedeutung
?	Kann für jedes beliebige Zeichen eingesetzt werden.
\	Sorgt dafür, dass das nachfolgende Zeichen als gewöhnliches Zeichen und nicht als Sonderzeichen interpretiert werden. Wenn ein Fragezeichen beispielsweise auf einen umgekehrten Schrägstrich folgt (\?), wird das Fragezeichen gesucht und nicht ein beliebiges einzelnes Zeichen.
[Liste]	Sucht nach jedem beliebigem Zeichen in der eingeschlossenen Liste. Mit einem Bindestrich können hier auch Zeichenbereiche angegeben werden.
[^Liste]	Sucht nach allen Zeichen, die sich nicht in der eingeschlossenen Liste befinden. Mit einem Bindestrich können hier auch Zeichenbereiche angegeben werden.
*	Steht für das vorausgehende Zeichen oder den vorherigen Ausdruck (muss jedoch keinen Treffer ergeben).
+	Steht für das vorausgehende Zeichen oder den vorherigen Ausdruck.
Ausdr|Ausdr	Steht entweder für den vorhergehenden oder den nachfolgenden Ausdruck. Mit dem ODER-Operator | wird jeweils der gesamte Ausdruck gesucht, und nicht nur das Zeichen, das ihm vorausgeht oder folgt. Beispielsweise steht VXI|GPIB für (VXI)|(GPIB) und nicht für VX(I|G)PIB.
(Ausdr)	Gruppiert Zeichen oder Ausdrücke.

Das im Parameter Ausdruck angegebene Suchkriterium besteht aus zwei Teilen: einem regulären Ausdruck für einen Ressourcen-String und einem optionalen logischen Ausdruck für Eigenschaftswerte. Der reguläre Ausdruck wird mit allen Strings von Ressourcen verglichen, die dem VISA-Ressourcenmanager bekannt sind. Wenn der Ressourcen-String dagegen mit dem regulären Ausdruck übereinstimmt, werden die Eigenschaftswerte mit dem Ausdruck über Eigenschaftswerte verglichen. Bei einem Treffer wird die Ressource der Liste der gefundenen Ressourcen hinzugefügt. In der Tabelle sehen Sie gültige reguläre Ausdrücke.

Regulärer Ausdruck	Beispiele für Entsprechungen
GPIB?*INSTR	Entspricht GPIB0::2::INSTR, GPIB1::1::1::INSTR und GPIB-VXI1::8::INSTR.
GPIB[0-9]*::?*INSTR	Entspricht GPIB0::2::INSTR und GPIB1::1::1::INSTR, aber nicht GPIB-VXI1::8::INSTR.
GPIB[^0]::?*INSTR	Steht für GPIB1::1::1::INSTR, jedoch nicht für GPIB0::2::INSTR oder GPIB12::8::INSTR.
VXI?*INSTR	Steht für VXI0::1::INSTR, jedoch nicht für GPIB-VXI0::1::INSTR.
GPIB-VXI?*INSTR	Steht für GPIB-VXI0::1::INSTR, jedoch nicht für VXI0::1::INSTR.
?*VXI[0-9]*::?*INSTR	Steht für VXI0::1::INSTR und GPIB-VXI0::1::INSTR.
ASRL[0-9]*::?*INSTR	Steht für ASRL1::INSTR, jedoch nicht für VXI0::5::INSTR.
ASRL1+::INSTR	Steht für ASRL1::INSTR und ASRL11::INSTR, jedoch nicht für ASRL2::INSTR.
(GPIB|VXI)?*INSTR	Steht für GPIB1::5::INSTR und VXI0::3::INSTR, jedoch nicht für ASRL2::INSTR.
(GPIB0|VXI0)::1::INSTR	Steht für GPIB0::1::INSTR und VXI0::1::INSTR.
?*INSTR	Steht für alle INSTR-(Geräte-)Ressourcen.
?*VXI[0-9]*::?*MEMACC	Steht für VXI0::MEMACC und GPIB-VXI1::MEMACC.
VXI0::?*	Steht für VXI0::1::INSTR, VXI0::2::INSTR und VXI0::MEMACC.
?*	Steht für alle Ressourcen (Standardeinstellung).
visa://hostname/?*	Steht für alle Ressourcen auf dem angegebenen System im Netzwerk. Der Host-Name wird entweder in Form einer IP-Adresse oder eines Computernamens angegeben. Das System im Netzwerk muss dazu nicht speziell konfiguriert sein.
/?*	Steht für alle Ressourcen auf dem lokalen System. Fragt konfigurierte Netzwerksysteme nicht ab.
visa:/ASRL?*INSTR	Steht für alle ASRL-Ressourcen auf dem lokalen System und gibt diese im URL-Format aus (z. B. visa:/ASRL1::INSTR).

Mit den optionalen Attributausdrücken können Sie zusammen mit logischen Verknüpfungen (z. B. "UND" [&&], ODER [||] oder NICHT [!]) flexible und leistungsfähige Ausdrücke erstellen. Mit IST GLEICH (==) und IST UNGLEICH (!=) können Sie Attribute beliebigen Typs und mit den Ungleichheitszeichen (>, <, >=, <=) numerische Attribute vergleichen. In einem Attributausdruck sollten nur globale Attribute verwendet werden. Lokale Attribute sind im logischen Teil des Ausdrucks eines Ausdrucksparameters nicht zulässig. In der folgenden Tabelle finden Sie gültige Ausdrucksparameter.

Ausdrucksparameter	Bedeutung
GPIB[0-9]*::?*::?*::INSTR{VI_ATTR_GPIB_SECONDARY_ADDR > 0 && VI_ATTR_GPIB_SECONDARY_ADDR < 10}	Suche alle GPIB-Geräte mit einer Sekundäradresse zwischen 1 und 9.
ASRL?*INSTR{VI_ATTR_ASRL_BAUD == 9600}	Suche alle seriellen Anschlüsse, die mit 9600 Baud konfiguriert sind.
?*VXI?INSTR{VI_ATTR_MANF_ID == 0xFF6 && !(VI_ATTR_VXI_LA ==0 || VI_ATTR_SLOT <= 0)}	Suche alle VXI-Instrumentenressourcen mit der Hersteller-ID FF6, die keine externen Controller sind und weder die logische Adresse 0 noch den Steckplatz 0 haben.

Suchmodus bestimmt, wie die Funktion die gefundenen Schnittstellen im Ausgang Suchergebnisse ausgibt – entweder als Standard- oder Aliasname. Der Standardwert lautet 0.

Der Eingang kann folgende Einstellungen haben:

0	Nur anerkannte Namen—Sucht alle konfigurierten Busse. Es werden nur die Ressourcen ausgegeben, die die Suchkriterien erfüllen. Das Format der ausgegebenen Strings richtet sich nach dem Format in den VISA-Spezifikationen.
2	Nur Aliasnamen—Sucht alle konfigurierten Busse. Es werden nur die Ressourcen ausgegeben, die die Suchkriterien erfüllen. Wenn es einen Aliasnamen gibt, wird dieser ausgegeben. Bei den anderen Ressourcen wird ein String ausgegeben, der den VISA-Spezifikationen entspricht.
3	Übereinstimmende Aliasnamen einschließen—Sucht nicht nach Bussen. Gibt nur Ressourcen mit benutzerdefinierten Aliasnamen aus. Der einzig gültige Ausdrucks-String ist "?*". Das Format des ausgegebenen Strings ist ein Alias.
4	Alle Aliasnamen einschließen—Sucht alle konfigurierten Busse. Es werden alle Ressourcen ausgegeben, die dem Suchausdruck entsprechen, und alle benutzerdefiniertem Aliasnamen, auch wenn sie nicht dem Suchausdruck übereinstimmen. Die Funktion gibt für jede Ressource einen benutzerdefinierten Alias aus, wenn es einen gibt. Bei den anderen Ressourcen wird ein String ausgegeben, der den VISA-Spezifikationen entspricht.

Fehler (Eingang) beschreibt Fehlerbedingungen, die vor der Ausführung des Knotens auftreten. An Fehler (Eingang) werden Standardfehlerdaten übergeben.

Suchergebnisse ist ein String-Array mit den gefundenen Schnittstellen.

Ausgabezählwert gibt die Trefferanzahl der Suche an. Diese entspricht der Anzahl der Strings im Array "Suchergebnisse".

Fehler (Ausgang) enthält Angaben zum Fehler. Dieser Ausgang ist ein Standardausgang zur Fehlerausgabe.