ChangeUnitSymbol (FPScript)
Remplace un ou plusieurs symboles d'unité d'un ensemble de données.
Syntaxe
ChangeUnitSymbol(DataSet, [ UnitSymbol ], [ UnitSymbolX ], [ UnitSymbolZ ] [ , Verify = TRUE ])
La syntaxe de la fonction ChangeUnitSymbol se compose des éléments suivants :
Section |
Description |
|---|---|
DataSet |
L'ensemble de données avec le(s) symbole(s) d'unité à remplacer. Toutes les structures de données sont autorisées. Les types de données pris en charge sont Virgule flottante de 32 bits, Virgule flottante de 64 bits, Nombre complexe à virgule flottante de 32 bits, Nombre complexe à virgule flottante de 64 bits, Temps calendaire et Période de temps. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
UnitSymbol |
Spécifie le symbole d'unité pour l'ensemble de données ou sa composante Y. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. |
UnitSymbolX |
Spécifie le symbole d'unité pour la composante X de l'ensemble de données. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. |
UnitSymbolZ |
Spécifie le symbole d'unité pour la composante Z de l'ensemble de données. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Chaîne de caractères. |
Verify |
TRUE si le symbole de l'unité doit être vérifié pour déterminer s'il correspond à l'unité existante. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Valeur booléenne. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut TRUE . |
Remarques
Utilisez cette fonction pour remplacer le symbole d'unité généré automatiquement par FlexPro par un symbole d'unité personnalisé. En remplaçant le symbole de l'unité, l'unité de DataSet reste inchangée et seul le symbole représentant l'unité est remplacé. Si DataSet n'a pas d'unité, alors la fonction n'aura aucun effet. Si une chaîne vide est spécifiée pour l'un des arguments Unit, UnitX ou UnitZ, le symbole de l'unité personnalisée correspondante, s'il existe, est supprimé. FlexPro régénérera alors automatiquement le symbole de l'unité. Si vous omettez un argument, l'unité correspondante restera inchangée.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
ChangeUnitSymbol(600 Nm / 300 1/min, "Nm/(1/min)") |
Renvoie 2 Nm/(1/min). Le symbole de l'unité passe de "Nm min" à "Nm/(1/min)". |
ChangeUnitSymbol(5 kOhm, "") |
Renvoie 5 kΩ. Le symbole de l'unité "kOhm" est supprimé. FlexPro utilise donc le symbole standard Ω pour l'unité. |
ChangeUnitSymbol(Spectrum, , "1/s") |
Seul le symbole de l'unité de la composante X du signal est modifié. Le symbole de l'unité de la composante Y reste inchangé. |
ChangeUnitSymbol(1 Hz, "1/min") |
Il en résulte un message d'erreur parce que le symbole d'unité spécifié ne correspond pas à l'unité existante. |