RETURN

Syntaxis

RETURN expression

Met weergaveopties en meerdere waarden:

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

Hoe het werkt

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.

Elke teruggegeven expressie accepteert optionele weergaveclausules. AS "name" labelt de curve in de legenda en de waardetabel. COLOURED(R, G, B) zet de lijnkleur vast op basis van RGB-componenten. STYLE bepaalt het lijntype en de dikte. Deze clausules horen per waarde, dus een indicator met twee lijnen kan elke curve apart opmaken.

RETURN belongs to indicator code only. ProOrder and ProBacktest strategies do not plot values through RETURN, they use GRAPH en GRAPHONPRICE for inspection output, and a RETURN statement in strategy code is rejected. ProScreener uses the SCREENER instructie om in plaats daarvan zijn resultaatkolom te geven.

Een losse RETURN zonder expressie is geldig en tekent niets, wat nuttig is wanneer het script uitsluitend tekent via tekencommando's zoals DRAWTEXT en heeft alleen een eindpunt nodig.

Wanneer de ene indicator de andere aanroept 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.

Voorbeelden

Voorbeeld 1, Een gestileerde RSI-curve teruggeven (Indicator)

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

Voorbeeld 2, Twee gelabelde curves teruggeven (Indicator)

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

Veelvoorkomende fouten en valkuilen

• 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.
• Niet geldig in strategieën. ProOrder and ProBacktest code cannot use RETURN. Use GRAPH of GRAPHONPRICE daar, en de SCREENER instructie in ProScreener.
• Ontbrekende labels bij uitvoer met meerdere waarden. Meerdere teruggegeven expressies zonder AS labels zijn moeilijk te onderscheiden in de legenda en de waardetabel. Label elke curve.
• Opties in de verkeerde volgorde. Weergaveclausules horen bij de waarde waar ze op volgen. Het schrijven van RETURN a, b COLOURED(255,0,0) kleurt alleen b, niet beide curves.

Gerelateerde instructies

• AS, labelt een teruggegeven waarde in de legenda en de waardetabel.
• COLOURED, stelt de kleur van een teruggegeven curve in.
• STYLE, stelt het lijntype en de dikte van een teruggegeven curve in.
• DRAWTEXT, draws text on the chart independently of RETURN.
• CALL, roept een andere indicator aan en ontvangt de teruggegeven waarden.
• IF, conditional logic that prepares the value RETURN outputs.
• GRAPH, tegenhanger aan de strategiezijde voor het plotten van debugwaarden.
• SCREENER, tegenhanger aan de screenerzijde die de resultaatkolom uitgeeft.