Opérateur d’exponentiation (^) (FPScript)
Augmente une expression par une puissance.
Syntaxe
Base ^ Exposant
La syntaxe de l'opérateur ^ se compose des éléments suivants :
Élément |
Description |
|---|---|
Base |
Toute expression. Tous les types de données, à l'exception des valeurs booléennes, sont autorisés. |
Exposant |
Identique à Basis. |
Remarques
L'opérateur peut traiter des valeurs scalaires ou des séries de données entières et des matrices de données. Si au moins un argument est une série de données ou une matrice de données, l'exponentiation a lieu sur une base par élément et le résultat est à nouveau une série de données ou une matrice de données. Si au moins un des deux arguments est une matrice de données, alors les deux arguments doivent avoir le même nombre de lignes. Pour un nombre différent de colonnes dans les matrices de données ou pour un nombre différent de lignes dans les séries de données, les colonnes ou valeurs supplémentaires sont supprimées.
Si des signaux, des séries de signaux ou des courbes spatiales sont utilisés, seules leurs composantes Y sont prises en compte. Le résultat contient alors de préférence la composante X et éventuellement la composante Z de Basis. Sinon, il contient ceux d'Exponent. Si l'une des expressions renvoie une liste, alors l'opération est exécutée pour chaque élément de la liste et le résultat est également une liste.
Vous pouvez appliquer l'opérateur à des types de données réels et complexes, ainsi qu'à des intervalles de temps et à des chaînes de caractères. Pour les arguments complexes, une exponentiation complexe se produit et le résultat est également complexe. Le résultat est toujours du même type de données que les expressions. Si les expressions ont des types de données différents, ceux-ci sont adaptés les uns aux autres de manière à ce qu'il n'y ait pas de perte de résolution dans le résultat, c'est-à-dire que les résolutions inférieures sont converties en résolutions supérieures, les entiers sont convertis en valeurs à virgule flottante et les nombres réels en nombres complexes.
L'exponentiation complexe est définie comme (a, b) ^ (c, d) = Exp((c, d) * Log((a, b))).
Si un argument est numérique et que l'autre est une chaîne de caractères, la chaîne de caractères est transformée en type numérique avant l'opération. Les deux arguments ne peuvent pas être des chaînes de caractères.
Vous pouvez utiliser les valeurs de l'intervalle de temps comme base ou comme exposant. Les deux opérandes sont alors interprétés comme des secondes et le résultat est une valeur d'intervalle de temps.
Si Base est égale à zéro et que l'Exposant est négatif, cela donne une valeur invalide pour les types de données à virgule flottante. Lorsque des types de données intégraux sont utilisés, une erreur est émise. Si l'exposant est égal à zéro, le résultat est toujours égal à un.
L'opérateur est associatif à droite, c'est-à-dire que les séquences d'exponentiations sont traitées de droite à gauche.
Si la base est une quantité, son unité est exponentielle. Dans ce cas, l'exposant doit être soit un nombre entier, soit présentable sous la forme d'une fraction ne comportant pas plus de deux places au dénominateur et au numérateur. Si l'exposant est une quantité, alors il doit avoir la dimension SI 1 et il sera transformé à l'unité 1 avant l'exponentiation.
Disponible dans
FlexPro View, Basic, Professional, Developer Suite
Exemples
Signal ^ 2. |
Egalise l'amplitude d'un signal. |
(1., 2.) ^ 2. |
Renvoie la valeur complexe à virgule flottante de 64 bits (-3., 4.). |
"3,23" ^ 2n |
Renvoie le nombre entier 32 bits 9, puisque la chaîne de caractères est transformée en type de données du résultat numérique. Notez que le symbole décimal spécifique au pays défini dans Windows doit être utilisé dans la chaîne de caractère. |
{ 0., 0.} ^ {0., -1.} |
Renvoie la série de données avec des valeurs à virgule flottante de 64 bits { 1., ? }. |
2 m ^ 2 |
Donne la quantité 4 m². |
2 cm ^ 1.5 |
Renvoie la quantité 2,82842712474619 cm3/2. |
2. ^ 2 Pi |
Il retourne 2. ^ 6.2831853 = 77.8802336. |