Fonction VISA Find Resource

expression assure la correspondance entre la valeur spécifiée et les périphériques disponibles pour une interface particulière.

La chaîne de description spécifiée détermine les critères de recherche d'une interface (GPIB, GPIB-VXI, VXI, toutes les VXI, Série ou Toutes) pour des périphériques existants. Le tableau suivant inclut les caractères et opérateurs spéciaux qui sont valides.

Caractères et opérateurs spécifiques	Signification
?	Recherche tout caractère.
\	Transforme le caractère qui le suit en un caractère ordinaire plutôt qu'en un caractère spécial. Par exemple, quand un point d'interrogation suit immédiatement une barre oblique inversée (\?), cela correspond au caractère ? plutôt qu'à un caractère quelconque.
[liste]	Trouve tout caractère seul de la liste entre crochets. Vous pouvez utiliser un trait d'union pour trouver toute une gamme de caractères.
[^liste]	Trouve tout caractère ne se trouvant pas dans la liste entre crochets. Vous pouvez utiliser un trait d'union pour faire correspondre toute une gamme de caractères.
*	*Correspond à un nombre d'occurrences supérieur ou égal à 0 du caractère ou de l'expression qui précède.
+	Correspond à une ou plusieurs occurrences du caractère ou de l'expression qui précède.
Exp|exp	Recherche soit l'expression qui précède, soit l'expression qui suit. L'opérateur OU | correspond à l'expression entière qui le précède ou le suit et pas seulement au caractère qui le précède ou le suit. Par exemple, VXI|GPIB signifie (VXI)|(GPIB) et non pas VX(I|G)PIB.
(exp)	Regrouper des caractères ou des expressions.

Les critères de recherche spécifiés dans le paramètre expression possèdent deux parties : une expression régulière au-dessus d'une chaîne de ressource et une expression logique optionnelle au-dessus des valeurs de l'attribut. L'expression régulière est mise en correspondance avec des chaînes de ressource des ressources connues du gestionnaire de ressources VISA. Si la chaîne de ressource correspond à l'expression régulière, les valeurs des attributs de la ressource sont mises en correspondance avec l'expression pour les valeurs des attributs. Si la correspondance est réussie, la ressource a rempli les critères de recherche et est ajoutée à la liste des ressources trouvées. La table suivante comprend des expressions régulières valides.

Expression régulière	Recherche de l'échantillon
GPIB?*INSTR	Trouve GPIB0::2::INSTR, GPIB1::1::1::INSTR et GPIB-VXI1::8::INSTR.
GPIB[0-9]*::?*INSTR	Trouve GPIB0::2::INSTR et GPIB1::1::1::INSTR, mais pas GPIB-VXI1::8::INSTR.
GPIB[^0]::?*INSTR	Trouve GPIB1::1::1::INSTR, mais ni GPIB0::2::INSTR ni GPIB12::8::INSTR.
VXI?*INSTR	Recherche VXI0::1::INSTR mais pas GPIB-VXI0::1::INSTR.
GPIB-VXI?*INSTR	Trouve GPIB-VXI0::1::INSTR mais pas VXI0::1::INSTR.
?*VXI[0-9]*::?*INSTR	Trouve VXI0::1::INSTR et GPIB-VXI0::1::INSTR.
ASRL[0-9]*::?*INSTR	Trouve ASRL1::INSTR mais pas VXI0::5::INSTR.
ASRL1+::INSTR	Trouve ASRL1::INSTR et ASRL11::INSTR, mais pas ASRL2::INSTR.
(GPIB|VXI)?*INSTR	Trouve GPIB1::5::INSTR et VXI0::3::INSTR, mais pas ASRL2::INSTR.
(GPIB0|VXI0)::1::INSTR	Recherche GPIB0::1::INSTR et VXI0::1::INSTR.
?*INSTR	Trouve toutes les ressources INSTR (de périphérique).
?*VXI[0-9]*::?*MEMACC	Trouve VXI0::MEMACC et GPIB-VXI1::MEMACC.
VXI0::?*	Trouve VXI0::1::INSTR, VXI0::2::INSTR et VXI0::MEMACC.
?*	Recherche toutes les ressources (valeur par défaut).
visa://hostname/?*	Trouve toutes les ressources sur le système distant spécifié. Vous pouvez définir le nom de l'hôte (hostname) par une adresse IP (notation à points) ou le nom d'une machine du réseau. Ce système distant n'a pas besoin d'être un système distant configuré.
/?*	Correspond à toutes les ressources sur la machine locale. N'interroge pas les systèmes distants configurés.
visa:/ASRL?*INSTR	Recherche toutes les ressources ASRL sur la machine locale et les renvoie au format URL comme, par exemple, visa:/ASRL1::INSTR.

En utilisant l'expression de l'attribut optionnel, vous pouvez construire des expressions puissantes et souples à l'aide des opérateurs logiques ET (&&), OU(||) et NON (!). Vous pouvez utiliser des comparateurs d'égalité (==) et d'inégalité (!=) pour comparer les attributs de n'importe quel type de données ainsi que d'autres comparateurs (>, <, >=, <=) afin de comparer des attributs de type de données numérique. Utilisez seulement des attributs globaux dans l'expression de l'attribut. Les attributs locaux ne sont pas autorisés dans la partie de l'expression logique du paramètre expr. La table suivante comprend des paramètres d'expressions valides.

Paramètre d'expression	Signification
GPIB[0-9]*::?*::?*::INSTR{VI_ATTR_GPIB_SECONDARY_ADDR > 0 && VI_ATTR_GPIB_SECONDARY_ADDR < 10}	Trouve tous les périphériques GPIB qui ont une adresse secondaire comprise entre 1 et 9.
ASRL?*INSTR{VI_ATTR_ASRL_BAUD == 9600}	Trouve tous les ports séries configurés à 9600 bauds.
?*VXI?INSTR{VI_ATTR_MANF_ID == 0xFF6 && !(VI_ATTR_VXI_LA ==0 || VI_ATTR_SLOT <= 0)}	Trouve toutes les ressources d'instruments VXI dont l'ID de fabricant est FF6 et qui ne sont ni des contrôleurs externes, ni à l'adresse logique 0, ni à l'emplacement 0.

mode de recherche détermine comment la fonction renvoie les interfaces trouvées dans la sortie liste trouvée : par noms canoniques ou par alias. La valeur par défaut est 0.

Cette entrée accepte les valeurs suivantes.

0	Noms canoniques uniquement — Recherche tous les bus configurés. Renvoie uniquement les ressources trouvées qui correspondent à la chaîne d'expression. Le format de chaque chaîne renvoyée correspond au format de ressource VISA canonique définie par les spéc.
2	Alias uniquement — Recherche tous les bus configurés. Renvoie uniquement les ressources trouvées qui correspondent à la chaîne d'expression. Pour chaque ressource, si un alias défini par l'utilisateur existe pour cette ressource, cet alias est renvoyé. Pour les autres ressources, la chaîne renvoyée sera dans le format de ressource VISA canonique définie par les spéc.
3	Inclure les alias correspondants — Ne recherche aucun bus. Renvoie uniquement les ressources ayant un alias défini par l'utilisateur. La seule chaîne d'expression valide est "?*". Le format de chaque chaîne renvoyée est un alias.
4	Inclure tous les alias — Recherche tous les bus configurés. Renvoie toutes les ressources trouvées qui correspondent à la chaîne d'expression, ainsi que tous les alias définis par l'utilisateur, même si ceux-ci ne correspondent pas à la chaîne d'expression. Pour chaque ressource, la fonction renvoie un alias défini par l'utilisateur s'il en existe un pour cette ressource. Pour les autres ressources, la chaîne renvoyée sera dans le format de ressource VISA canonique définie par les spéc.

entrée d'erreur décrit les conditions d'erreur qui ont lieu avant l'exécution de ce nœud. Cette entrée fournit la fonctionnalité entrée d'erreur standard.

liste trouvée correspond à un tableau de chaînes, chaque chaîne spécifiant une interface trouvée par la fonction.

nombre renvoyé spécifie le nombre de correspondances trouvées. Le nombre de correspondances trouvées est le nombre de chaînes contenues dans le tableau de la liste trouvée.

sortie d'erreur contient des informations sur l'erreur. Cette sortie fournit la fonctionnalité sortie d'erreur standard.