Fonctions mathématiques ( DataStage® )

Les fonctions mathématiques exécutent des opérations mathématiques.

Les fonctions mathématiques se trouvent dans la catégorie Mathématique de l'éditeur d'expression. Des crochets indiquent qu'un argument est facultatif. Les exemples illustrent la fonction telle qu'elle apparaît dans une zone Dérivation de l'étape Transformer.

Abs

Renvoie la valeur absolue d'une expression numérique. La valeur absolue d'une expression est sa magnitude sans signe.

Entrée : numeric_expression (int32)
Sortie : result (dfloat)
Exemples. Si mylink.number1 contient le nombre 12 et mylink.number2 contient le numéro 34, les deux fonctions suivantes sont équivalentes et renvoient le numéro 22 :
```
Abs(12-34)
Abs(mylink.mynumber1-mylink.mynumber2)
```
Si mylink.number1 contient le nombre 34 et mylink.number2 contient le numéro 12, les deux fonctions suivantes sont équivalentes et renvoient le numéro 22 :
```
Abs(34-12)
Abs(mylink.mynumber1-mylink.mynumber2)
```

Acos

Calcule l'arc cosinus trigonométrique d'une expression. L'expression doit être une valeur numérique. Le résultat est exprimé en radians.

Entrée : numeric_expression (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro 0.707106781, les deux fonctions suivantes sont équivalentes et renvoient la valeur 0.785398 :
```
Acos(0.707106781)
Acos(mylink.mynumber)
```

Asin

Calcule l'arc sinus trigonométrique d'une expression. L'expression doit être une valeur numérique. Le résultat est exprimé en radians.

Entrée : numeric_expression (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro 0.707106781, les deux fonctions suivantes sont équivalentes et renvoient la valeur 0.785398 :
```
Asin(0.707106781)
Asin(mylink.mynumber)
```

Atan

Calcule l'arc tangente trigonométrique d'une expression. L'expression doit être une valeur numérique. Le résultat est exprimé en radians.

Entrée : numeric_expression (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro 135, les deux fonctions suivantes sont équivalentes et renvoient la valeur 1.56339, qui est l'angle avec une tangente d'arc de 135 :
```
Atan(135)
Atan(mylink.mynumber)
```

Atan2

Calcule l'arc tangente trigonométrique des deux entrées en utilisant leurs signes pour déterminer le quadrant du résultat. Les entrées doivent être des valeurs numériques. Le résultat est exprimé en radians.

Entrée : numeric_expression (dfloat, dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number1 contient le nombre 10.0 et mylink.number2 contient le nombre -10.0, les deux fonctions suivantes sont équivalentes et renvoient la valeur 2.35619 :
```
Atan2(10.0. -10.0)
Atan2(mylink.mynumber1, mylink.mynumber2)
```

Ceil

Calcule la plus petite valeur entière supérieure ou égale à la valeur décimale spécifiée.

Entrée : number (dfloat)
Sortie : result (int32)
Exemples. Si mylink.number contient le numéro 2355.66, les deux fonctions suivantes sont équivalentes et renvoient la valeur 2356 :
```
Ceil(2355.66)
Ceil(mylink.mynumber)
```

Cos

Calcule le cosinus trigonométrique d'une expression. L'expression doit être une valeur numérique. L'expression doit générer une valeur numérique qui est l'angle en radians.

Entrée : radians (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro 0.785398, alors les deux fonctions suivantes sont équivalentes et renvoient la valeur 0.7071 :
```
Cos(0.785398)
Cos(mylink.mynumber)
```

Cosh

Calcule le cosinus hyperbolique d'une expression. L'expression doit être une valeur numérique.

Entrée : number (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro 2, les deux fonctions suivantes sont équivalentes et renvoient la valeur 3.7622 :
```
Cosh(2)
Cosh(mylink.mynumber)
```

Div

Génère le composant entier de la division réelle de deux nombres réels (dividende, diviseur).

Entrée : dividend (dfloat), divisor (dfloat)
Sortie : result (int32)
Exemples. Si mylink.dividende contient le nombre 100 et mylink.divisor contient le nombre 25, les deux fonctions suivantes sont équivalentes et renvoient la valeur 4 :
```
Div(100,25)
Div(mylink.dividend,mylink.divisor)
```

Exp

Calcule le résultat de la base E élevée à la puissance désignée par la valeur de l'expression. La valeur de E est d'environ 2,71828. L'expression doit avoir pour résultat une valeur numérique.

Entrée : number (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro 5, les deux fonctions suivantes sont équivalentes et renvoient la valeur 54.5982 :
```
Exp(5-1)
Exp(mylink.number-1)
```

Fabs

Calcule la valeur absolue de la valeur flottante spécifiée.

Entrée : number (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro -26.53, les deux fonctions suivantes sont équivalentes et renvoient la valeur 26.53 :
```
Fabs(-26.53)
Fabs(mylink.number)
```

Plancher

Calcule la plus grande valeur entière inférieure ou égale à la valeur décimale spécifiée.

Entrée : number (dfloat)
Sortie : result (int32)
Exemples. Si mylink.number contient le nombre 203.25, les deux fonctions suivantes sont équivalentes et renvoient la valeur 203 :
```
Floor(203.25)
Floor(mylink.number)
```

Ldexp

Renvoie une valeur dfloat en multipliant la mantisse par 2 élevée à la puissance de l'exposant.

Entrée : mantissa (dfloat), exponent (int32)
Sortie : result (dfloat)
Exemples. Si mylink.mantissa contient le nombre 2 et mylink.exponent contient le numéro 3, les deux fonctions suivantes sont équivalentes et renvoient la valeur 16 :
```
Floor(2,3)
Floor(mylink.mantissa,mylink.exponent)
```

Llabs

Calcule la valeur absolue de la valeur entière spécifiée.

Entrée : number (integer)
Sortie : result (unsigned integer)
Exemples. Si mylink.number contient le nombre -26, les deux fonctions suivantes sont équivalentes et renvoient la valeur 26 :
```
Llabs(-26)
Llabs(mylink.number)
```

Ln

Calcule le logarithme naturel d'une expression en base e. La valeur de E est d'environ 2,71828. L'expression doit avoir pour résultat une valeur numérique supérieure à 0.

Entrée : number (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro 6, les deux fonctions suivantes sont équivalentes et renvoient la valeur 1.79176 :
```
Ln(6)
Ln(mylink.number)
```

Log10

Renvoie le logarithme en base 10 de la valeur spécifiée.

Entrée : number (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro 6, les deux fonctions suivantes sont équivalentes et renvoient la valeur 0.778151 :
```
Log10(6)
Log10(mylink.number)
```

Maxi

Renvoie la valeur la plus élevée des deux valeurs d'argument.

Entrée : number1 (int32),number2(int32)
Sortie : result (int32)
Exemples. Si mylink.number1 contient le numéro 6 et mylink.number1 contient le numéro 101, les deux fonctions suivantes sont équivalentes et renvoient la valeur 101 :
```
Max(6,101)
Max(mylink.number1,mylink.number2)
```

Mini

Renvoie la valeur la moins élevée des deux valeurs d'argument.

Entrée : number1 (int32),number2(int32)
Sortie : result (int32)
Exemples. Si mylink.number1 contient le numéro 6 et mylink.number1 contient le numéro 101, les deux fonctions suivantes sont équivalentes et renvoient la valeur 6 :
```
Min(6,101)
Min(mylink.number1,mylink.number2)
```

Mod

Calcule le modulo (le reste) de deux expressions (dividende, diviseur).

Entrée : dividend (int32), divisor (int32)
Sortie : result (int32)
Exemples. Si mylink.dividend contient le nombre 115 et mylink.divisor contient le numéro 25, les deux fonctions suivantes sont équivalentes et renvoient la valeur 15 :
```
Mod(115,25)
Mod(mylink.dividend,mylink.divisor)
```

Neg

Nie un nombre.

Entrée : number (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro 123, les deux fonctions suivantes sont équivalentes et renvoient la valeur -123 :
```
Neg(123)
Neg(mylink.number)
```

Pwr

Calcule la valeur d'une expression lorsqu'elle est élevée à une puissance spécifiée (expression, puissance).

Entrée : expression (dfloat), power (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.expression contient le nombre 2 et mylink.power contient le nombre 3, les deux fonctions suivantes sont équivalentes et renvoient la valeur 8 :
```
Pwr(2,3)
Pwr(mylink.expression,mylink.power)
```

Rand

Retourne un entier pseudo-aléatoire compris entre 0 et 2³²-1.

Entrée : Non applicable
Sortie : result (uint32)
Exemples. Utilisez cette fonction pour ajouter une colonne à votre sortie contenant un nombre pseudo-aléatoire :
```
Rand()
```

Aléatoire

Renvoie un nombre aléatoire entre 0 et 2³²-1.

Entrée : Non applicable
Sortie : result (uint32)
Exemples. Utilisez cette fonction pour ajouter une colonne à votre sortie contenant un nombre aléatoire :
```
Random()
```

Sin

Calcule le sinus trigonométrique d'une expression. L'expression doit être une valeur numérique. L'expression doit générer une valeur numérique qui est l'angle en radians.

Entrée : radians (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro 0.785398, alors les deux fonctions suivantes sont équivalentes et renvoient la valeur 0.7071 :
```
Sin(0.785398)
Sin(mylink.mynumber)
```

Sinh

Calcule le sinus hyperbolique d'une expression. L'expression doit être une valeur numérique.

Entrée : number (dfloat)
Sortie : result (dfloat)
Exemples : Si mylink.number contient le numéro 2, les deux fonctions suivantes sont équivalentes et renvoient la valeur 3.62686 :
```
Sinh(2)
Sinh(mylink.mynumber)
```

Racine carrée

Calcule la racine carrée d'un nombre.

Entrée : number (dfloat)
Sortie : result (dfloat)
Exemples : Si mylink.number contient le numéro 450, les deux fonctions suivantes sont équivalentes et renvoient la valeur 21.2132 :
```
Sqrt(450)
Sqrt(mylink.mynumber)
```

Tan

Calcule la tangente trigonométrique d'une expression. L'expression doit générer une valeur numérique qui est l'angle en radians.

Entrée : radians (dfloat)
Sortie : result (dfloat)
Exemples. Si mylink.number contient le numéro 0.7853981, les deux fonctions suivantes sont équivalentes et renvoient la valeur 0.7071 :
```
Tan(0.7853981)
Tan(mylink.mynumber)
```

Tanh

Calcule la tangente hyperbolique d'une expression. L'expression doit être une valeur numérique.

Entrée : number (dfloat)
Sortie : result (dfloat)
Exemples : Si mylink.number contient le numéro 2, les deux fonctions suivantes sont équivalentes et renvoient la valeur 0,964028 :
```
Tanh(2)
Tanh(mylink.mynumber)
```