PRINT

Syntaxe

PRINT(variable) AS "Label" COLOURED(R, G, B) FILLCOLOR(bgR, bgG, bgB)

Paramètres

Comment ça marche

PRINT est une instruction de diagnostic. Pour chaque bougie traitée par le script, elle ajoute la valeur actuelle de la variable indiquée à un tableau qui s'ouvre dans sa propre fenêtre, une ligne par barre et une colonne par instruction PRINT. Cela permet d'observer l'évolution des valeurs intermédiaires barre par barre sans les tracer, ce qui est souvent plus clair que de lire une courbe lorsque plusieurs variables interagissent.

Le AS nomme la colonne, ce qui compte dès que plus d'une valeur est affichée. COLOURED et FILLCOLOR contrôlent les couleurs du texte et de l'arrière-plan des cellules, ce qui permet de distinguer visuellement certaines colonnes ou certains états de valeur.

PRINT appartient au code d'indicateur écrit en ProBuilder. Le code de stratégie possède ses propres sorties de débogage, GRAPH et GRAPHONPRICE, qui tracent des valeurs pendant un backtest au lieu de les mettre en tableau. Pour du texte placé directement sur le graphique, DRAWTEXT est l'alternative.

Comme la construction du tableau coûte du temps et de la mémoire à chaque barre, les instructions PRINT doivent être supprimées ou mises en commentaire une fois le débogage terminé. Elles n'apportent rien à un indicateur publié et ralentissent le recalcul sur de longs historiques.

Exemples

Exemple 1, Inspection d'un calcul de corps de bougie (Indicateur)

// Difference between close and open, shown in a debug table
VarA = close - open
R = 255
B = 255
PRINT(VarA) AS "A" COLOURED(R, 0, 0) FILLCOLOR(0, 0, B)
RETURN

Chaque barre ajoute une ligne au tableau sous l'en-tête "A", avec du texte rouge sur fond bleu. L'indicateur lui-même ne renvoie rien, l'intérêt est le tableau.

Exemple 2, Comparaison de deux valeurs intermédiaires côte à côte (Indicateur)

// Watch both moving averages while debugging a crossover
fastMA = average[10](close)
slowMA = average[40](close)
PRINT(fastMA) AS "Fast MA"
PRINT(slowMA) AS "Slow MA"
RETURN fastMA - slowMA AS "MA spread"

Deux instructions PRINT produisent deux colonnes étiquetées, ce qui permet de vérifier la logique de croisement barre par barre pendant que le spread est tracé normalement.

Exemple 3, Mise en évidence des valeurs hors plage (Indicateur)

// Print RSI and flag extreme readings with a distinct background
myRSI = RSI[14](close)
IF myRSI > 70 OR myRSI < 30 THEN
  PRINT(myRSI) AS "RSI14" COLOURED(255, 255, 255) FILLCOLOR(200, 0, 0)
ELSE
  PRINT(myRSI) AS "RSI14"
ENDIF
RETURN myRSI AS "RSI14"

La mise en forme conditionnelle à l'intérieur du bloc IF fait ressortir les lignes de surachat et de survente dans le tableau sans modifier la sortie tracée.

Erreurs et pièges courants

• Laissé dans le code de production. PRINT est réservé au développement. Les instructions oubliées continuent de générer le tableau de débogage à chaque recalcul et dégradent les performances sur de longs historiques.
• Colonnes sans étiquette. Plusieurs appels PRINT sans AS étiquettes produisent un tableau difficile à lire. Nommez chaque colonne lorsque vous affichez plus d'une variable.
• Mauvais outil pour les stratégies. PRINT est une instruction de débogage d'indicateur. Dans du code ProBacktest ou ProOrder, utilisez GRAPH ou GRAPHONPRICE pour inspecter les valeurs pendant un backtest.
• Composantes RGB hors plage. COLOURED et FILLCOLOR attendent chaque composante entre 0 et 255. Les valeurs hors de cette plage ne produisent pas la couleur voulue.

Instructions liées

• GRAPH, trace une valeur dans une fenêtre séparée pendant un backtest.
• GRAPHONPRICE, trace une valeur de backtest directement sur le graphique de prix.
• RETURN, renvoie la valeur finale de l'indicateur au graphique.
• DRAWTEXT, écrit du texte aux coordonnées du graphique.
• COLOURED, applique une couleur aux courbes renvoyées et au texte imprimé.
• FILLCOLOR, définit la couleur de fond des cellules imprimées et des dessins.