Les fonctions arithmétiques effectuent des calculs de base et des opérations mathématiques sur les valeurs des champs d'un journal. Cette rubrique répertorie les fonctions disponibles et les constantes mathématiques par type, et décrit la syntaxe, les paramètres, la valeur de retour ainsi que des exemples pour chaque fonction.
Remarques sur l'utilisation
Les conventions suivantes s'appliquent à toutes les fonctions arithmétiques décrites dans cette rubrique :
Familles de fonctions — Les fonctions dont le nom commence par
op_effectuent des calculs de base. Celles dont le nom commence parmat_réalisent des calculs mathématiques.MATH_PIetMATCH_Esont des constantes mathématiques que vous transmettez à une fonction en tant que valeur.Opérations chevauchantes — Certaines opérations sont disponibles dans les deux familles de fonctions. Par exemple,
op_absetmat_fabscalculent toutes deux une valeur absolue. Comparez les exemples de chaque section pour observer le résultat renvoyé par chaque fonction.Types d'entrée — Le tableau des paramètres de chaque section indique les types acceptés. La plupart des paramètres acceptent un nombre ou une chaîne numérique. Le paramètre
value1deop_mulaccepte également une chaîne, un tuple ou une liste.Unités d'angle —
mat_sin,mat_cosetmat_tanattendent une valeur d'entrée en radians, tandis quemat_acos,mat_asinetmat_atanrenvoient le résultat en radians. Pour convertir des degrés en radians, utilisezmat_radians. Pour convertir des radians en degrés, utilisezmat_degrees.Exemples — Chaque exemple présente le journal brut, la règle de transformation appliquée au journal et le résultat de la transformation.
Pour utiliser une valeur négative, faites appel à la fonction op_neg(valeur positive). Par exemple, pour représenter -1, utilisez op_neg(1).
Liste des fonctions
Le tableau suivant répertorie les fonctions arithmétiques et les constantes mathématiques par type.
|
Type |
Fonction |
Description |
|
Calculs de base |
op_sum |
Calcule la somme des valeurs d'entrée. |
|
op_abs |
Calcule la valeur absolue d'une valeur d'entrée. |
|
|
op_div_floor |
Effectue une division entière sur les valeurs d'entrée. |
|
|
op_div_true |
Effectue une division sur les valeurs d'entrée. |
|
|
op_pow |
Élève une valeur à une puissance spécifiée. |
|
|
op_mul |
Multiplie les valeurs d'entrée. |
|
|
op_neg |
Inverse le signe d'une valeur d'entrée. |
|
|
op_mod |
Effectue une opération modulo sur les valeurs d'entrée. |
|
|
op_sub |
Soustrait une valeur d'entrée d'une autre. |
|
|
op_round |
Arrondit une valeur d'entrée. |
|
|
Calculs mathématiques |
mat_ceil |
Arrondit une valeur d'entrée à l'entier supérieur le plus proche. |
|
mat_exp |
Calcule une fonction exponentielle de base e. |
|
|
mat_fabs |
Calcule la valeur absolue d'une valeur d'entrée. |
|
|
mat_floor |
Arrondit une valeur d'entrée à l'entier inférieur le plus proche. |
|
|
mat_log |
Calcule le logarithme d'une valeur d'entrée. |
|
|
mat_log10 |
Calcule le logarithme en base 10 d'une valeur d'entrée. |
|
|
mat_sqrt |
Calcule la racine carrée d'une valeur d'entrée. |
|
|
mat_degrees |
Convertit des radians en degrés. |
|
|
mat_radians |
Convertit des degrés en radians. |
|
|
mat_sin |
Calcule le sinus d'une valeur d'entrée exprimée en radians. |
|
|
mat_cos |
Calcule le cosinus d'une valeur d'entrée exprimée en radians. |
|
|
mat_tan |
Calcule la tangente d'une valeur d'entrée exprimée en radians. |
|
|
mat_acos |
Calcule l'arccosinus d'une valeur d'entrée. Le résultat est exprimé en radians. |
|
|
mat_asin |
Calcule l'arcsinus d'une valeur d'entrée. Le résultat est exprimé en radians. |
|
|
mat_atan |
Calcule l'arctangente d'une valeur d'entrée. Le résultat est exprimé en radians. |
|
|
mat_atan2 |
Calcule l'arctangente des coordonnées spécifiées. |
|
|
mat_atanh |
Calcule la tangente hyperbolique inverse d'une valeur d'entrée. |
|
|
mat_hypot |
Calcule la norme euclidienne des valeurs d'entrée. |
|
|
Constantes mathématiques |
MATH_PI |
La constante mathématique pi. |
|
MATCH_E |
La constante mathématique e. |
op_sum
Calcule la somme des valeurs d'entrée.
Syntaxe
op_sum(value1, value2, ...)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value1 |
Nombre ou chaîne (numérique) |
Oui |
La valeur à calculer. |
|
value2 |
Nombre ou chaîne (numérique) |
Oui |
La valeur à calculer. |
-
Réponse
La somme des valeurs d'entrée.
-
Exemples
Calculez le prix total à partir des champs course_price et goods_price.
Journal brut
course_price: 12
goods_price: 2
Règle de transformation
e_set("total_price", op_sum(v("course_price"), v("goods_price")))
Résultat
course_price: 12
goods_price: 2
total_price: 14
op_abs
Calcule la valeur absolue d'une valeur d'entrée.
Syntaxe
op_abs(value)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value |
Nombre ou chaîne (numérique) |
Oui |
La valeur à calculer. |
-
Réponse
La valeur absolue de la valeur d'entrée.
-
Exemples
Calculez la valeur absolue du champ course_price.
Journal brut
course_price: -4
Règle de transformation
e_set("op_abs", op_abs(v("course_price")))
Résultat
course_price: -4
op_abs: 4
op_div_floor
Effectue une division entière sur les valeurs d'entrée.
Syntaxe
op_div_floor(value1, value2)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value1 |
Nombre ou chaîne (numérique) |
Oui |
La valeur à calculer. |
|
value2 |
Nombre ou chaîne (numérique) |
Oui |
La valeur à calculer. |
-
Réponse
La partie entière du quotient de value1 divisé par value2.
-
Exemples
Calculez le prix unitaire en fonction des champs course_price et count.
Journal brut
course_price: 4
count: 2
Règle de transformation
e_set("op_div_floor", op_div_floor(v("course_price"), v("count")))
Résultat
course_price: 4
count: 2
op_div_floor: 2
op_div_true
Effectue une division sur les valeurs d'entrée.
Cette fonction convertit automatiquement les types de données. Vous pouvez transmettre des données de type chaîne ou entier.
Syntaxe
op_div_true(value1, value2)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value1 |
Nombre ou chaîne (numérique) |
Oui |
La valeur à calculer. |
|
value2 |
Nombre ou chaîne (numérique) |
Oui |
La valeur à calculer. |
-
Réponse
Le quotient de value1 divisé par value2.
-
Exemples
- Exemple 1 : calculez le prix unitaire en fonction des champs fruit_price et count.
Journal brut
fruit_price: 9
count: 2
Règle de transformation
e_set("op_div_true", op_div_true(v("fruit_price"), v("count")))
Résultat
fruit_price: 9
count: 2
op_div_true: 4.5
Exemple 2 : calculez l'accélération et arrondissez le résultat. La formule est
a = (one_speed-two_speed)/time.Journal brut
one_speed: 9
two_speed: 2
time: 3
Règle de transformation
e_set("a", op_round(op_div_true(op_sub(v("one_speed"), v("two_speed")), v("time")), 2))
Résultat
one_speed: 9
two_speed: 2
time: 3
a: 2.33
op_pow
Élève une valeur à une puissance spécifiée.
Syntaxe
op_pow(value1, value2)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value1 |
Nombre ou chaîne (numérique) |
Oui |
La valeur à calculer. |
|
value2 |
Nombre ou chaîne (numérique) |
Oui |
La valeur à calculer. |
-
Réponse
La valeur de value1 élevée à la puissance value2.
-
Exemples
Calculez la valeur de course élevée à la puissance pow.
Journal brut
course: 100
pow: 2
Règle de transformation
e_set("pow_course", op_pow(v("course"), v("pow")))
Résultat
course: 100
pow: 2
pow_course: 10000
op_mul
Multiplie les valeurs d'entrée.
Syntaxe
op_mul(value1, value2)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value1 |
Nombre, chaîne, tuple, liste, etc. |
Oui |
La valeur à calculer. |
|
value2 |
Nombre |
Oui |
La valeur à calculer. |
-
Réponse
- Si value1 et value2 sont des nombres, la fonction renvoie le produit des deux valeurs.
Si value1 est une chaîne, un tuple ou une liste, la fonction renvoie une valeur du même type répétée value2 fois.
-
Exemples
- Exemple 1 : calculez le prix total en fonction des champs course et price.
Journal brut
course: 10
price: 23
Règle de transformation
e_set("total_price", op_mul(ct_int(v("course")), ct_int(v("price"))))
Résultat
course: 10
price: 23
total_price: 230
Exemple 2 : multipliez la valeur du champ course par 3.
Journal brut
course: "abc"
Règle de transformation
e_set("course", op_mul(v("course"), 3))
Résultat
course: "abcabcabc"
op_neg
Inverse le signe d'une valeur d'entrée.
Syntaxe
op_neg(value)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
-
Réponse
La valeur d'entrée avec son signe inversé.
-
Exemples
- Journal brut
course: -100
Règle de transformation
e_set("account", op_neg(v("course")))
Résultat
course: -100
account: 100
op_mod
Effectue une opération modulo sur les valeurs d'entrée.
Syntaxe
op_mod(value1, value2)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value1 |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
|
value2 |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
-
Réponse
Le reste de la division de value1 par value2.
-
Exemples
- Journal brut
course: 4
count: 3
Règle de transformation
e_set("op_mod", op_mod(v("course"), v("count")))
Résultat
course: 4
count: 3
op_mod: 1
op_sub
Soustrait une valeur d'entrée d'une autre.
Syntaxe
op_sub(value1, value2)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value1 |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
|
value2 |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
-
Réponse
Le résultat de value1 moins value2.
-
Exemples
Calculez le résultat de la soustraction de la valeur count_apple à la valeur count.
Journal brut
count: 6
count_apple: 3
Règle de transformation
e_set("sub_number", op_sub(v("count"),v("count_apple")))
Résultat
count: 6
count_apple: 3
sub_number: 3
op_round
Arrondit une valeur d'entrée.
Syntaxe
op_round(value, number)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
|
number |
Nombre |
Oui |
Nombre de décimales à conserver après l'arrondi. La valeur par défaut est 0. |
-
Réponse
La valeur arrondie.
-
Exemples
Arrondissez la valeur du champ price à une décimale.
Journal brut
price: 4.56
Règle de transformation
e_set("round_price", op_round(v("price"),1))
Résultat
price: 4.56
round_price: 4.6
mat_ceil
Arrondit une valeur d'entrée à l'entier supérieur le plus proche.
Syntaxe
mat_ceil(value)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
-
Réponse
Le plus petit entier supérieur ou égal à la valeur spécifiée.
-
Exemples
- Journal brut
price: 4.1
Règle de transformation
e_set("mat_ceil", mat_ceil(v("price")))
Résultat
price: 4.1
mat_ceil: 5
mat_exp
Calcule une fonction exponentielle de base e.
Syntaxe
mat_exp(value)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
-
Réponse
e élevé à la puissance de la valeur d'entrée.
-
Exemples
- Journal brut
number: 2
Règle de transformation
e_set("e_x", mat_exp(v("number")))
Résultat
number: 2
e_x: 7.38905609893065
mat_fabs
Calcule la valeur absolue d'une valeur d'entrée.
Syntaxe
mat_fabs(value)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
-
Réponse
La valeur absolue de la valeur d'entrée.
-
Exemples
- Journal brut
course_price: -10
Règle de transformation
e_set("mat_fabs", mat_fabs(v("course_price")))
Résultat
course_price: -10
mat_fabs: 10.0
mat_floor
Arrondit une valeur d'entrée à l'entier inférieur le plus proche.
Syntaxe
mat_floor(value)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
-
Réponse
Le plus grand entier inférieur ou égal à la valeur spécifiée.
-
Exemples
- Journal brut
course_price: 4.9
Règle de transformation
e_set("mat_floor", mat_floor(v("course_price")))
Résultat
course_price: 4.9
mat_floor: 4
mat_log
Calcule le logarithme d'une valeur d'entrée.
Syntaxe
mat_log(value1,value2)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value1 |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
|
value2 |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
-
Réponse
Le logarithme de la valeur d'entrée.
-
Exemples
- Journal brut
number1: 100
number2: 10
Règle de transformation
e_set("mat_log", mat_log(v("number1"),v("number2")))
Résultat
number1: 100
number2: 10
mat_log: 2.0
mat_log10
Calcule le logarithme en base 10 d'une valeur d'entrée.
Syntaxe
mat_log10(value)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
-
Réponse
Le logarithme en base 10 de la valeur d'entrée.
-
Exemples
- Journal brut
number: 100
Règle de transformation
e_set("number2", mat_log10(v("number")))
Résultat
number: 100
number2: 2.0
mat_sqrt
Calcule la racine carrée d'une valeur d'entrée.
Syntaxe
mat_sqrt(value)
Paramètres
|
Nom du paramètre |
Type de paramètre |
Obligatoire |
Description |
|
value |
Nombre ou chaîne (numérique) |
Oui |
Valeur à calculer. |
-
Réponse
La racine carrée de la valeur d'entrée.
-
Exemples
- Journal brut
number1: 100
Règle de transformation
e_set("sqrt_account", mat_sqrt(v("number1")))
Résultat
number1: 100
sqrt_account: 10.0
mat_degrees
Convertit des radians en degrés.
Syntaxe
mat_degrees(value)
Paramètres
|
Parameter name |
Parameter type |
Required |
Description |
|
value |
Number or string (numeric) |
Yes |
Valeur à calculer. |
-
Response
Résultat en degrés.
-
Examples
- Journal brut
num: 1
Règle de transformation
e_set("mat_degrees", mat_degrees(v("num")))
Résultat
num: 1
mat_degrees: 57.29577951308232
mat_radians
Convertit des degrés en radians.
Syntaxe
mat_radians(value)
Paramètres
|
Parameter name |
Parameter type |
Required |
Description |
|
value |
Number or string (numeric) |
Yes |
Valeur à calculer. |
-
Response
Résultat en radians.
-
Examples
- Journal brut
rad: 30
Règle de transformation
e_set("mat_radians", mat_radians(v("rad")))
Résultat
rad: 30
mat_radians: 0.5235987755982988
mat_sin
Calcule le sinus d'une valeur d'entrée exprimée en radians.
Syntaxe
mat_sin(value)
Paramètres
|
Parameter name |
Parameter type |
Required |
Description |
|
value |
Number or string (numeric) |
Yes |
Valeur à calculer. |
-
Response
Sinus de la valeur d'entrée.
-
Examples
- Journal brut
sin: 90
Règle de transformation
e_set("mat_sin", mat_sin(v("sin")))
Résultat
sin: 90
mat_sin: 0.8939966636005579
mat_cos
Calcule le cosinus d'une valeur d'entrée exprimée en radians.
Syntaxe
mat_cos(value)
Paramètres
|
Parameter name |
Parameter type |
Required |
Description |
|
value |
Number or string (numeric) |
Yes |
Valeur à calculer. |
-
Response
Cosinus de la valeur d'entrée.
-
Examples
- Journal brut
cos: 30
Règle de transformation
e_set("mat_cos", mat_cos(v("cos")))
Résultat
cos: 30
mat_cos: 0.15425144988758405
mat_tan
Calcule la tangente d'une valeur d'entrée exprimée en radians.
Syntaxe
mat_tan(value)
Paramètres
|
Parameter name |
Parameter type |
Required |
Description |
|
value |
Number or string (numeric) |
Yes |
Valeur à calculer. |
-
Response
Tangente de la valeur d'entrée.
-
Examples
- Journal brut
tan: 30
Règle de transformation
e_set("mat_tan", mat_tan(v("tan")))
Résultat
tan: 30
mat_tan: 1.6197751905438615
mat_acos
Calcule l'arccosinus d'une valeur d'entrée. Le résultat est exprimé en radians.
Syntaxe
mat_acos(value)
Paramètres
|
Parameter name |
Parameter type |
Required |
Description |
|
value |
Number or string (numeric) |
Yes |
Valeur à calculer. |
-
Response
Arccosinus de la valeur d'entrée, en radians.
-
Examples
- Journal brut
acos: 1
Règle de transformation
e_set("mat_acos", mat_acos(v("acos")))
Résultat
acos: 1
mat_acos: 0.0
mat_asin
Calcule l'arcsinus d'une valeur d'entrée. Le résultat est exprimé en radians.
Syntaxe
mat_asin(value)
Paramètres
|
Parameter name |
Parameter type |
Required |
Description |
|
value |
Number or string (numeric) |
Yes |
Valeur à calculer. |
-
Response
Arcsinus de la valeur d'entrée, en radians.
-
Examples
- Journal brut
asin: 1
Règle de transformation
e_set("mat_asin", mat_asin(v("asin")))
Résultat
asin: 1
mat_asin: 1.5707963267948966
mat_atan
Calcule l'arctangente d'une valeur d'entrée. Le résultat est exprimé en radians.
Syntaxe
mat_atan(value)
Paramètres
|
Parameter name |
Parameter type |
Required |
Description |
|
value |
Number or string (numeric) |
Yes |
Valeur à calculer. |
-
Response
Arctangente de la valeur d'entrée, en radians.
-
Examples
- Journal brut
atan: 1
Règle de transformation
e_set("mat_atan", mat_atan(v("atan")))
Résultat
atan: 1
mat_atan: 0.7853981633974483
mat_atan2
Calcule l'arctangente des coordonnées spécifiées.
Syntaxe
mat_atan2(x,y)
Paramètres
|
Parameter name |
Parameter type |
Required |
Description |
|
x |
Number or string (numeric) |
Yes |
Coordonnée x. |
|
y |
Number or string (numeric) |
Yes |
Coordonnée y. |
-
Response
Arctangente des coordonnées spécifiées.
-
Examples
- Journal brut
atan1: 1
atan2: 2
Règle de transformation
e_set("mat_atan2", mat_atan2(v("atan1"),v("atan2")))
Résultat
atan1: 1
atan2: 2
mat_atan2: 0.4636476090008061
mat_atanh
Calcule la tangente hyperbolique inverse d'une valeur d'entrée.
Syntaxe
mat_atanh(value)
Paramètres
|
Parameter name |
Parameter type |
Required |
Description |
|
value |
Number or string (numeric) |
Yes |
Valeur à calculer. |
-
Response
Tangente hyperbolique inverse de la valeur d'entrée.
-
Examples
- Journal brut
atanh: 0.5
Règle de transformation
e_set("mat_atanh", mat_atanh(v("atanh")))
Résultat
atanh: 0.5
mat_atanh: 0.5493061443340548
mat_hypot
Calcule la norme euclidienne des valeurs d'entrée.
Syntaxe
mat_hypot(value1,value2)
Paramètres
|
Parameter name |
Parameter type |
Required |
Description |
|
value1 |
Number or string (numeric) |
Yes |
Coordonnée x. |
|
value2 |
Number or string (numeric) |
Yes |
Coordonnée y. |
-
Response
Norme euclidienne des valeurs d'entrée.
-
Examples
- Journal brut
hypot1: 1
hypot2: 2
Règle de transformation
e_set("mat_hypot", mat_hypot(v("hypot1"),v("hypot2")))
Résultat
hypot1: 1
hypot2: 2
mat_hypot: 2.23606797749979
MATH_PI
Constante mathématique pi.
Journal brut
a: 2
Règle de transformation
e_set("result", op_sum(v("a"), MATH_PI))
Résultat
a: 2
result: 5.141592653589793
MATCH_E
Constante mathématique e.
Journal brut
a: 2
Règle de transformation
e_set("result", op_sum(v("a"), MATCH_E))
Résultat
a: 2
result: 4.718281828459045