Affectation (FPScript)
Affecte une valeur à la propriété d'un objet, à une variable ou à un composant, ou à un élément de liste dans celui-ci.
Syntaxe
Cible = Expression
ou
[ Target )., Target], ...] ] = List
La syntaxe de la fonction Assignation se compose des éléments suivants :
Élément |
Description |
---|---|
Cible |
Une expression qui fait référence à une variable, à un composant d'une variable ou à une propriété d'objet de la formule dans laquelle l'instruction est utilisée. |
Expression |
Toute expression dont la valeur doit être attribuée. |
Cible1...n |
Plusieurs expressions qui font référence à une variable, à un composant dans une variable ou à une propriété d'objet de la formule dans laquelle l'instruction est utilisée. |
Liste |
Toute expression qui donne lieu à une liste dont les éléments doivent être affectés. |
Remarques
Pour supprimer une variable, on peut lui attribuer la valeur Empty. Si vous attribuez une valeur à une composante d'un signal, d'une série de signaux ou d'une courbe spatiale, son type de données et sa structure de données doivent être choisis de manière à ce que la valeur ainsi modifiée ait une structure de données valide lorsqu'elle est considérée dans son ensemble. Vous pouvez attribuer la valeur Vide, par exemple, à la composante Z d'une courbe d'espace. Les composantes X et Y restantes forment alors un signal. Vous ne pouvez cependant pas affecter une série de données avec des chaînes de caractères à la composante Y d'un signal, par exemple, car ce type de données n'est pas autorisé pour les signaux.
L'affectation aux propriétés de l'objet est fortement réduite et n'est autorisée que pour les propriétés UnitY, UnitX, UnitZ, CommentsY, CommentsX et CommentsZ de la formule contenant le code FPScript.
Utilisez la deuxième forme de l'affectation afin d'affecter des variables individuelles aux éléments d'une liste. Si vous spécifiez plus de variables qu'il n'y a d'éléments de liste, alors Empty sera affecté aux variables en excès.
Remarques :
Utilisez l'instruction Dim pour déclarer une variable et lui attribuer une valeur en même temps.
Vous ne devez utiliser l'affectation aux propriétés d'objet de la formule que lorsque cela est absolument nécessaire. En général, il est préférable de modifier les attributs respectifs dans la boîte de dialogue Propriétés de la formule. L'accès en écriture aux propriétés de l'objet est utile pour le FPScript intégré si le gestionnaire d'unités est désactivé. Une expression FPScript sur l'onglet "Données" de la boîte de dialogue Propriétés d'un graphique 2D pourrait ressembler à ceci, par exemple : .Unit = "%" ; Signal * 100. / Maximum(Signal). En utilisant ce calcul, l'unité physique change ici. L'utilisation de l'accès en écriture sous Propriété de l'unité garantit que l'unité correcte est affichée dans la légende.
Si le gestionnaire d'unités est activé, l'expression doit être écrite de manière à ce que le résultat soit fourni dans l'unité correcte, par exemple : Unité<%>Unité<1>(Signal / Maximum(Signal)).
Si vous utilisez le nom du chemin d'accès d'un objet de données dans FPScript, il sera interprété comme une valeur et non comme une référence d'objet. Utilisez l'instruction Set ou le mot-clé As Object pour attribuer une référence d'objet.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
Sig = Smooth(Sig, 3) |
Lisse le signal stocké dans Sig. |
Liste.[1n] = 1 |
Une affectation au deuxième élément de la liste stockée dans le fichier Liste. |
Sig.X = (10, 0 s, 0.1 s) |
Remplace la composante X du signal stocké dans le fichier Sigpar dix points. |
.UnitX = "ms" |
Modifie l'unité physique du composant X dans les informations d'en-tête de la formule dans laquelle se trouve la déclaration. |
[y, x, z] = Liste |
Affecte les variables y, x et z aux trois premiers éléments de la liste. |