Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

ProRealTime · ProBuilder

Variables et calculs en ProBuilder : affectation, opérateurs et fonctions

Affecter une variable, exploiter son historique, utiliser MOD, ROUND, ABS ou Highest et éviter les pièges des valeurs nulles et de la division par zéro en ProBuilder.

Mis à jour le 23 octobre 2026Lecture : 7 minPar Alix, OptiBot Trading

En ProBuilder, une variable se crée simplement en lui affectant une valeur : ecart = High - Low. Il n’y a ni déclaration ni type à préciser, toute variable jamais affectée vaut zéro, et chaque variable conserve automatiquement son historique barre par barre, lisible avec ecart[1], ecart[2], etc. Les calculs s’écrivent avec les opérateurs habituels (+, -, *, /, MOD) et une bibliothèque de fonctions mathématiques (ABS, ROUND, MIN, MAX, SQRT, POW, LOG, EXP…).

Cette page détaille ces mécanismes, leurs pièges (division par zéro, valeurs nulles en début d’historique, Undefined) et propose un indicateur complet. Si vous découvrez le langage, lisez d’abord le guide sur la syntaxe de base du ProBuilder ; la vue d’ensemble se trouve sur la page de rubrique Le langage ProBuilder.

Créer et affecter une variable

L’affectation utilise le signe = : à gauche le nom de la variable, à droite l’expression. La variable peut contenir un prix, un résultat d’indicateur, un nombre quelconque ou le résultat d’une comparaison.

milieu = (High + Low) / 2             // un prix calculé
mm50 = Average[50](Close)             // un indicateur prédéfini
hausse = Close > Close[1]             // une comparaison : vaut 1 ou 0

Le dernier cas est très utile. Une comparaison renvoie 1 quand elle est vraie et 0 sinon ; on peut donc la stocker dans une variable, puis l’utiliser telle quelle dans un IF ou l’additionner. Par exemple, Summation[10](hausse) compte le nombre de clôtures en hausse sur les dix dernières barres.

Il n’existe qu’un seul type de variable numérique : vous n’avez pas à choisir entre entier et décimal. Les chaînes de caractères ne se manipulent pas comme dans un langage généraliste ; elles servent essentiellement à l’affichage (noms de courbes, textes dessinés).

La valeur par défaut et Undefined

Toute variable qui n’a pas reçu de valeur vaut zéro. C’est pratique pour les compteurs, mais c’est aussi une source d’erreurs : un niveau de prix jamais défini vaut 0 et peut tracer une ligne au bas du graphique, ou fausser une moyenne.

Pour éviter cela, ProBuilder propose le mot-clé Undefined. Une variable affectée à Undefined n’est pas affichée tant qu’elle ne reçoit pas de vraie valeur. La documentation précise qu’Undefined s’affecte en principe une seule fois, au début du code, et qu’on ne peut pas tester directement si une variable « vaut » Undefined : dans un test, elle se comporte comme 0.

niveau = Undefined                    // rien n'est tracé tant qu'aucun signal n'est apparu
IF Close CROSSES OVER Average[20](Close) THEN
   niveau = Low                       // mémorise le plus bas de la barre de signal
ENDIF
RETURN niveau AS "Niveau du dernier signal"

Notez que niveau garde sa valeur d’une barre à l’autre tant qu’aucun nouveau croisement ne la remplace : une variable non réaffectée conserve sa dernière valeur.

Les opérateurs arithmétiques

OpérateurRôleExemple
+additionHigh + Low
-soustractionClose - Open
*multiplicationatr * 2
/division(Close - Close[1]) / Close[1]
MODreste de la division entièreBarIndex MOD 2

Les parenthèses fixent l’ordre de calcul comme en mathématiques. Dans le doute, ajoutez-les : elles ne coûtent rien et rendent l’intention explicite. MOD est utile pour tester la divisibilité (une valeur MOD 2 égale à 0 indique un nombre pair) ou faire défiler une valeur dans une plage.

Les fonctions mathématiques

La documentation officielle de ProBuilder fournit les fonctions suivantes :

FonctionRésultat
MIN(a, b) / MAX(a, b)minimum / maximum de deux valeurs
ABS(a)valeur absolue
SGN(a)signe : 1 si positif, -1 si négatif, 0 si nul
ROUND(a, n)arrondi avec n décimales
FLOOR(a, n) / CEIL(a, n)arrondi par défaut / par excès avec une précision n
SQUARE(a) / SQRT(a)carré / racine carrée
POW(a, b)a à la puissance b
EXP(a) / LOG(a)exponentielle / logarithme népérien
RANDOM(a, b)entier aléatoire entre a et b inclus

À cela s’ajoutent des fonctions de cumul et de statistique qui travaillent sur l’historique : cumsum(x) (somme depuis le début du graphique), Summation[n](x) (somme des n dernières valeurs), Highest[n](x) et Lowest[n](x) (extrêmes sur n barres), STD[n](x) (écart-type). Ce sont elles qui rendent la plupart des boucles inutiles. Le détail de Summation est présenté dans la rubrique des instructions, page Summation.

Exemple complet : position relative dans le range du jour

L’indicateur suivant calcule où se situe la clôture dans la fourchette des N dernières barres, en pourcentage, puis lisse le résultat. Il illustre les affectations, les fonctions mathématiques, la protection contre la division par zéro et l’usage de l’historique.

// Position de la clôture dans le range des N dernières barres (0 à 100 %)
n = 20                                    // nombre de barres du range
lissage = 5                               // période de lissage

plusHaut = Highest[n](High)               // plus haut sur n barres
plusBas = Lowest[n](Low)                  // plus bas sur n barres
amplitude = plusHaut - plusBas            // largeur du range

IF amplitude > 0 THEN
   pct = (Close - plusBas) / amplitude * 100   // position en %
ELSE
   pct = pct[1]                           // range nul : on garde la valeur précédente
ENDIF

pct = ROUND(pct, 1)                       // une décimale suffit à l'affichage
pctLisse = Average[lissage](pct)          // moyenne mobile de la position
variation = ABS(pctLisse - pctLisse[1])   // vitesse de changement, toujours positive

RETURN pct AS "Position %", pctLisse AS "Position lissée", variation AS "Variation"

Deux détails méritent l’attention. D’abord, le test amplitude > 0 évite une division par zéro, possible sur un marché figé ou une bougie sans mouvement. Ensuite, la ligne pct = ROUND(pct, 1) réaffecte une variable à partir d’elle-même : c’est autorisé, car on modifie la valeur de la barre courante, pas l’historique.

Lire l’historique d’une variable

Toute variable possède un historique lisible avec des crochets : pct[1] est la valeur de la barre précédente, pct[5] celle d’il y a cinq barres. L’indice peut être une variable, ce qui sert notamment dans les boucles (Close[i]).

Trois règles à retenir :

  1. L’historique est en lecture seule. pct[1] = 50 n’est pas valide : on ne réécrit pas le passé.
  2. En début de graphique, l’historique n’existe pas encore. Sur les premières barres, Highest[20](High) ne dispose pas de 20 valeurs ; vérifiez que la période demandée ne dépasse pas l’historique disponible et filtrez les premières barres avec BarIndex (voir ONCE et BarIndex).
  3. Un indice élevé coûte de l’historique. Un calcul qui lit x[200] ne produit de valeurs fiables qu’après 200 barres.

Accumuler une valeur d’une barre à l’autre

Comme une variable non réaffectée conserve sa valeur précédente, on peut construire des cumuls sans boucle. Une ligne comme total = total + Volume ajoute le volume de chaque nouvelle barre au total déjà calculé : sur la dernière barre, total contient la somme de tout l’historique, ce qui revient à cumsum(Volume). Le même mécanisme permet de compter les barres depuis un événement : on remet le compteur à zéro quand l’événement se produit, puis on lui ajoute 1 à chaque barre. Par exemple, IF Close CROSSES OVER mm THEN compteur = 0 ELSE compteur = compteur + 1 ENDIF mesure l’ancienneté du dernier croisement. Ce schéma de « mémoire » est l’une des techniques les plus utiles du langage ; pour une initialisation qui ne doit se produire qu’une seule fois, on le complète avec l’instruction ONCE.

Variables numériques et lisibilité

Il est tentant d’écrire des expressions longues sur une seule ligne. Mieux vaut décomposer : une variable intermédiaire bien nommée documente le calcul, permet de l’afficher avec RETURN pour le vérifier, et évite de recalculer plusieurs fois la même sous-expression. Le coût d’une variable supplémentaire est négligeable, alors qu’une erreur dans une formule compacte peut passer inaperçue pendant longtemps.

Bonnes pratiques pour des calculs fiables

  • Initialisez explicitement les variables qui servent d’accumulateur, en particulier avant une boucle.
  • Protégez chaque division par un test sur le dénominateur.
  • Regroupez les paramètres (périodes, seuils) en début de code ; vous pourrez ensuite les transformer en variables réglables depuis la fenêtre de l’indicateur.
  • Évitez de recalculer plusieurs fois le même indicateur : stockez Average[50](Close) dans une variable et réutilisez-la.
  • Nommez vos variables de façon explicite, sans accents ni caractères spéciaux.

Le prolongement naturel de cette page est l’écriture de conditions sur ces variables, présentée dans le guide IF, ELSE, ENDIF.

FAQ

Quelle est la valeur d’une variable jamais affectée ?

Zéro. ProBuilder initialise implicitement toute variable à 0. Pour qu’une variable ne soit pas tracée tant qu’elle n’a pas de valeur pertinente, affectez-lui Undefined en début de code.

Peut-on modifier la valeur passée d’une variable ?

Non. L’historique d’une variable se lit avec les crochets mais ne se modifie jamais : maVariable[3] = 42 est une instruction invalide. Seule la valeur de la barre courante peut être affectée.

Comment arrondir un résultat à deux décimales ?

Utilisez ROUND(valeur, 2). La documentation officielle décrit ROUND(a, n) comme un arrondi avec une précision de n décimales. FLOOR et CEIL permettent d’arrondir par défaut ou par excès.

Comment éviter une division par zéro ?

Testez le dénominateur avant la division, par exemple IF amplitude > 0 THEN, et prévoyez une valeur de repli dans le ELSE (la valeur précédente ou 0 selon le sens de l’indicateur).

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.