RETURN

Syntaxe

RETURN expression

Avec options d'affichage et plusieurs valeurs :

RETURN expression1 COLOURED(R, G, B) AS "Label 1", expression2 AS "Label 2"

Comment ça marche

Every custom indicator ends with a RETURN statement. The expressions listed after RETURN become the curves the platform draws, one curve per expression, separated by commas. Execution of the script stops at RETURN, so it is conventionally the last line, and any code after it never runs.

Chaque expression renvoyée accepte des clauses d'affichage optionnelles. AS "name" nomme la courbe dans la légende et le tableau de valeurs. COLOURED(R, G, B) fixe la couleur de la ligne à partir des composantes RGB. STYLE contrôle le type et l'épaisseur du trait. Ces clauses s'attachent par valeur, de sorte qu'un indicateur à deux lignes peut styliser chaque courbe indépendamment.

RETURN belongs to indicator code only. ProOrder and ProBacktest strategies do not plot values through RETURN, they use GRAPH et GRAPHONPRICE for inspection output, and a RETURN statement in strategy code is rejected. ProScreener uses the SCREENER instruction pour émettre sa colonne de résultat à la place.

Un simple RETURN sans expression est valide et ne trace rien, ce qui est utile quand le script dessine exclusivement via des commandes de dessin telles que DRAWTEXT et n'a besoin que d'un point de terminaison.

Lorsqu'un indicateur en appelle un autre via CALL, the values received on the calling side are exactly the expressions the called script listed after its own RETURN, in the same order. Designing the RETURN line of a reusable indicator therefore defines its public interface.

Exemples

Exemple 1, Renvoyer une courbe RSI stylisée (Indicateur)

// 14-period RSI plotted in a custom color with a legend label
myIndicatorToDraw = RSI[14](close)
RETURN myIndicatorToDraw COLOURED(210,105,30) AS "my RSI"

The RSI value is computed, then RETURN plots it as a single curve with a fixed color and the label "my RSI".

Exemple 2, Renvoyer deux courbes nommées (Indicateur)

// Plot a fast and a slow moving average together
fastMA = average[20](close)
slowMA = average[50](close)
RETURN fastMA COLOURED(0,150,0) AS "Fast 20", slowMA COLOURED(150,0,0) AS "Slow 50"

A comma-separated list after RETURN produces two independent curves, each with its own color and legend entry.

Example 3, Bare RETURN with drawing commands (Indicator)

// Mark bullish engulfing bars, no curve needed
IF close > open AND close[1] < open[1] AND close > open[1] AND open < close[1] THEN
  DRAWARROWUP(barindex, low) COLOURED(0, 200, 0)
ENDIF
RETURN

The indicator communicates entirely through drawings, so RETURN carries no expression and simply terminates the script.

Erreurs et pièges courants

• Code after RETURN never runs. RETURN stops execution, so statements below it are dead code. Multiple conditional RETURN lines also mean only the first one reached takes effect on a given bar.
• Non valide dans les stratégies. ProOrder and ProBacktest code cannot use RETURN. Use GRAPH ou GRAPHONPRICE là, et le SCREENER instruction dans ProScreener.
• Libellés manquants sur une sortie à plusieurs valeurs. Plusieurs expressions renvoyées sans AS libellés sont difficiles à distinguer dans la légende et le tableau des valeurs. Nommez chaque courbe.
• Options dans le mauvais ordre. Les clauses d'affichage se rattachent à la valeur qu'elles suivent. Écrire RETURN a, b COLOURED(255,0,0) colore uniquement b, pas les deux courbes.

Instructions liées

• AS, nomme une valeur renvoyée dans la légende et le tableau des valeurs.
• COLOURED, définit la couleur d'une courbe renvoyée.
• STYLE, définit le type et l'épaisseur de ligne d'une courbe renvoyée.
• DRAWTEXT, draws text on the chart independently of RETURN.
• CALL, appelle un autre indicateur et reçoit ses valeurs renvoyées.
• IF, conditional logic that prepares the value RETURN outputs.
• GRAPH, équivalent côté stratégie pour tracer des valeurs de débogage.
• SCREENER, équivalent côté screener qui produit la colonne de résultat.