Documentation
Table of Contents
6 Fonctions mathématiques
Toutes les fonctions répertoriées ici sont prises en charge dans :
Les fonctions mathématiques sont prises en charge avec les types de valeurs flottantes et entières, sauf indication contraire.
Quelques notes générales sur les paramètres de fonction :
- Les paramètres de fonction sont séparés par une virgule
- Les expressions sont acceptées comme paramètres
- Les paramètres de fonction optionnels (ou parties de paramètre) sont indiqués par
<>
| FONCTION | ||
|---|---|---|
| Description | Paramètres spécifiques à la fonction | Commentaires |
| abs (valeur) | ||
| La valeur absolue d'une valeur. | valeur - valeur à vérifier | Types de valeurs pris en charge : float, int, str, text, log Pour les chaînes de caractères renvoie : 0 - les valeurs sont égales 1 - les valeurs diffèrent Exemple : => abs(last(/host/key))>10 La différence numérique absolue sera calculée, comme on le voit avec ces exemples de valeurs entrantes (valeur 'précédente' and 'dernière' = différence absolue) : '1' and '5' = 4'3' and '1' = 2'0' and '-2.5' = 2.5 |
| acos (valeur) | ||
| L'arc cosinus d'une valeur sous forme d'angle, exprimé en radians. | valeur - valeur à vérifier | La valeur doit être comprise entre -1 et 1. Par exemple, l'arc cosinus d'une valeur '0.5' sera '2.0943951'. Exemple : => acos(last(/host/key)) |
| asin (valeur) | ||
| L'arc sinus d'une valeur sous forme d'angle, exprimé en radians. | valeur - valeur à vérifier | La valeur doit être comprise entre -1 et 1. Par exemple, l'arc sinus d'une valeur '0.5' sera '-0.523598776'. Exemple : => asin(last(/host/key)) |
| atan (valeur) | ||
| L'arc tangente d'une valeur sous forme d'angle, exprimée en radians. | valeur - valeur à vérifier | Par exemple, l'arc tangente d'une valeur '1' sera '0.785398163'. Exemple : => atan(last(/host/key)) |
| atan2 (valeur,abscisse) | ||
| L'arc tangente de l'ordonnée et les coordonnées d'abscisse spécifiées sous forme d'angle, exprimées en radians. | valeur - valeur à vérifier abscisse - valeur d'abscisse |
Par exemple, l'arc tangente des coordonnées d'ordonnée et d'abscisse d'une valeur '1' sera '2.21429744'. Exemple : => atan2(last(/host/key),2) |
| avg (<valeur1>,<valeur2>,...) | ||
| Valeur moyenne des valeurs des éléments référencés. | valeurX - valeur renvoyée par l'une des fonctions d'historique | Exemple : => avg(avg(/host/key),avg(/host2/key2)) |
| cbrt (valeur) | ||
| Cube root of a value. | valeur - valeur à vérifier | Par exemple, la racine cubique de '64' sera '4', celle de '63' sera '3.97905721'. Exemple : => cbrt(last(/host/key)) |
| ceil (valeur) | ||
| Arrondi de la valeur à l'entier supérieur ou égal le plus proche. | valeur - valeur à vérifier | Par exemple, '2.4' sera arrondi à '3'. Exemple : => ceil(last(/host/key)) Voir également floor(). |
| cos (valeur) | ||
| Le cosinus d'une valeur, où la valeur est un angle exprimé en radians. | valeur - valeur à vérifier | Par exemple, le cosinus d'une valeur '1' sera '0.54030230586'. Exemple : => cos(last(/host/key)) |
| cosh (valeur) | ||
| Le cosinus hyperbolique d'une valeur. | valeur - valeur à vérifier | Par exemple, le cosinus hyperbolique d'une valeur '1' sera '1,54308063482'. Renvoie la valeur sous forme de nombre réel, et non sous forme de notation scientifique. Exemple : => cosh(last(/host/key)) |
| cot (valeur) | ||
| La cotangente d'une valeur, où la valeur est un angle, exprimée en radians. | valeur - valeur à vérifier | Par exemple, la cotangente d'une valeur '1' sera '0.54030230586'. <br >Exemple : => cot(last(/host/key)) |
| degrees (valeur) | ||
| Convertit une valeur de radians en degrés. | valeur - valeur à vérifier | Par exemple, une valeur '1' convertie en degrés sera '57.2957795'. Exemple : => degrees(last(/host/key)) |
| e | ||
| Le nombre d'Euler (2.718281828459045). | Exemple : => e() |
|
| exp (valeur) | ||
| Nombre d'Euler à la puissance d'une valeur. | valeur - valeur à vérifier | Par exemple, le nombre d'Euler à la puissance d'une valeur '2' sera '7.38905609893065'. Exemple : => exp(last(/host/key)) |
| expm1 (valeur) | ||
| Nombre d'Euler à une puissance d'une valeur moins 1. | valeur - valeur à vérifier | Par exemple, le nombre d'Euler à une puissance d'une valeur '2' moins 1 sera '6.38905609893065'. Exemple : => expm1(last(/host/key)) |
| floor (valeur) | ||
| Arrondi de la valeur à l'entier inférieur ou égal le plus proche. | valeur - valeur à vérifier | Par exemple, '2.6' sera arrondi à '2'. Exemple : => floor(last(/host/key)) Voir également ceil(). |
| log (valeur) | ||
| Logarithme naturel. | valeur - valeur à vérifier | Par exemple, le logarithme naturel d'une valeur '2' sera '0.69314718055994529'. Exemple : => log(last(/host/key)) |
| log10 (valeur) | ||
| Logarithme décimal. | valeur - valeur à vérifier | Par exemple, le logarithme décimal d'une valeur '5' sera '0.69897000433'. Exemple : => log10(last(/host/key)) |
| max (<valeur1>,<valeur2>,...) | ||
| Valeur la plus élevée des valeurs d'éléments référencés. | valeurX - valeur renvoyée par l'une des fonctions d'historique | Exemple : => max(avg(/host/key),avg(/host2/key2)) |
| min (<valeur1>,<valeur2>,...) | ||
| Valeur la plus basse des valeurs d'éléments référencés. | valeurX - valeur renvoyée par l'une des fonctions d'historique | Exemple : => min(avg(/host/key),avg(/host2/key2)) |
| mod (valeur,dénominateur) | ||
| Reste de division. | valeur - valeur à vérifier dénominateur - dénominateur de division |
Par exemple, le reste de division d'une valeur '5' avec le dénominateur de division '2' sera '1'. Exemple : => mod(last(/host/key),2) |
| pi | ||
| Constante Pi (3.14159265358979). | Exemple : => pi() |
|
| power (valeur,valeur de puissance) | ||
| La puissance d'une valeur. | valeur - valeur à vérifier valeur de puissance - la Nième puissance à utiliser |
Par exemple, la 3ème puissance d'une valeur '2' sera '8' . Exemple : => power(last(/host/key),3) |
| radians (valeur) | ||
| Convertir une valeur de degrés en radians. | valeur - valeur à vérifier | Par exemple, une valeur '1' convertie en radians sera '0.0174532925'. Exemple : => radians(last(/host/key)) |
| rand | ||
| Renvoie une valeur entière aléatoire. | Un nombre généré de manière pseudo-aléatoire utilisant le temps comme base (assez pour des fins mathématiques, mais pas pour la cryptographie). Exemple : => rand() |
|
| round (valeur,décimales) | ||
| Arrondi de la valeur aux décimales. | valeur - valeur à vérifier décimales - spécifie les décimales pour l'arrondi (0 est également possible) |
Par exemple, une valeur '2.5482' arrondie à 2 décimales sera '2.55'. Exemple : => round(last(/host/key),2) |
| signum (valeur) | ||
| Renvoie '-1' si une valeur est négative, '0' si une valeur est nulle, '1' si une valeur est positive. | valeur - valeur à vérifier | Exemple : => signum(last(/host/key)) |
| sin (valeur) | ||
| Le sinus d'une valeur, où la valeur est un angle exprimé en radians. | valeur - valeur à vérifier | Par exemple, le sinus d'une valeur '1' sera '0.8414709848'. Exemple : => sin(last(/host/key)) |
| sinh (valeur) | ||
| Le sinus hyperbolique d'une valeur. | valeur - valeur à vérifier | Par exemple, le sinus hyperbolique d'une valeur '1' sera '1.17520119364'. Exemple : => sinh(last(/host/key)) |
| sqrt (valeur) | ||
| Racine carrée d'une valeur. | valeur - valeur à vérifier | Cette fonction échouera avec une valeur négative. Par exemple, la racine carrée d'une valeur '3.5' sera '1.87082869339'. Exemple : => sqrt(last(/host/key)) |
| sum (<valeur1>,<valeur2>,...) | ||
| Somme des valeurs des éléments référencés. | valeurX - valeur renvoyée par l'une des fonctions d'historique | Exemple : => sum(avg(/host/key),avg(/host2/key2)) |
| tan (valeur) | ||
| La tangente d'une valeur. | valeur - valeur à vérifier | Par exemple, la tangente d'une valeur '1' sera '1.55740772465'. Exemple : => tan(last(/host/key)) |
| truncate (valeur,décimales) | ||
| Tronque la valeur aux décimales. | valeur - valeur à vérifier décimales - spécifie les décimales à tronquer (0 est également possible) |
Exemple : => truncate(last(/host/key),2) |