RETURN

Syntax

RETURN expression

Mit Anzeigeoptionen und mehreren Werten:

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

So funktioniert es

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.

Jeder zurückgegebene Ausdruck akzeptiert optionale Anzeigeklauseln. AS "name" benennt die Kurve in Legende und Werttabelle. COLOURED(R, G, B) legt die Linienfarbe aus RGB-Komponenten fest. STYLE steuert Linienart und Liniendicke. Diese Klauseln hängen sich pro Wert an, sodass ein zweiliniger Indikator jede Kurve unabhängig gestalten kann.

RETURN belongs to indicator code only. ProOrder and ProBacktest strategies do not plot values through RETURN, they use GRAPH und GRAPHONPRICE for inspection output, and a RETURN statement in strategy code is rejected. ProScreener uses the SCREENER Befehl, stattdessen seine Ergebnisspalte auszugeben.

Ein einfaches RETURN ohne Ausdruck ist gültig und plottet nichts, was nützlich ist, wenn das Skript ausschließlich über Zeichenbefehle zeichnet, etwa DRAWTEXT und benötigt nur einen Abbruchpunkt.

Wenn ein Indikator einen anderen über 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.

Beispiele

Beispiel 1, Eine formatierte RSI-Kurve zurückgeben (Indikator)

// 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".

Beispiel 2, Zwei benannte Kurven zurückgeben (Indikator)

// 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.

Häufige Fehler und Stolperfallen

• 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.
• In Strategien nicht gültig. ProOrder and ProBacktest code cannot use RETURN. Use GRAPH oder GRAPHONPRICE dort, und der SCREENER Befehl in ProScreener.
• Fehlende Bezeichnungen bei Ausgabe mehrerer Werte. Mehrere zurückgegebene Ausdrücke ohne AS Beschriftungen sind in Legende und Wertetabelle schwer zu unterscheiden. Beschriften Sie jede Kurve.
• Optionen in der falschen Reihenfolge. Anzeige-Klauseln beziehen sich auf den Wert, dem sie folgen. Schreibt man RETURN a, b COLOURED(255,0,0) färbt nur b, nicht beide Kurven.

Verwandte Befehle

• AS, benennt einen zurückgegebenen Wert in der Legende und der Wertetabelle.
• COLOURED, legt die Farbe einer zurückgegebenen Kurve fest.
• STYLE, legt Linientyp und Dicke einer zurückgegebenen Kurve fest.
• DRAWTEXT, draws text on the chart independently of RETURN.
• CALL, ruft einen anderen Indikator auf und erhält seine zurückgegebenen Werte.
• IF, conditional logic that prepares the value RETURN outputs.
• GRAPH, Gegenstück auf Strategieseite zum Zeichnen von Debug-Werten.
• SCREENER, Gegenstück auf Screener-Seite, das die Ergebnisspalte ausgibt.