Bli medlem i dag
Instruksjoner/probuilder

RETURN

RETURN outputs the final value of a ProBuilder indicator so ProRealTime™ can plot it on the chart, with optional AS labels, COLOURED and STYLE settings.

Syntaks

probuilder
RETURN expression

Med visningsalternativer og flere verdier:

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

Slik fungerer det

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.

Hvert returnert uttrykk godtar valgfrie visningsklausuler. AS "name" merker kurven i forklaringen og verditabellen. COLOURED(R, G, B) fastsetter linjefargen ut fra RGB-komponenter. STYLE styrer linjetype og tykkelse. Disse klausulene knyttes til hver verdi, så en indikator med to linjer kan stile hver kurve uavhengig.

RETURN belongs to indicator code only. ProOrder and ProBacktest strategies do not plot values through RETURN, they use GRAPH og GRAPHONPRICE for inspection output, and a RETURN statement in strategy code is rejected. ProScreener uses the SCREENER instruksjonen for å sende ut sin resultatkolonne i stedet.

En enkeltstående RETURN uten uttrykk er gyldig og plotter ingenting, noe som er nyttig når skriptet tegner utelukkende gjennom tegnekommandoer som DRAWTEXT og trenger bare et avslutningspunkt.

Når én indikator kaller en annen 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.

Eksempler

Eksempel 1, Returnere en stilsatt RSI-kurve (Indikator)

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

Eksempel 2, Returnere to merkede kurver (Indikator)

probuilder
// 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)

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

Vanlige feil og fallgruver

  • 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.
  • Ikke gyldig i strategier. ProOrder and ProBacktest code cannot use RETURN. Use GRAPH eller GRAPHONPRICE der, og SCREENER instruksjon i ProScreener.
  • Manglende merkelapper ved utdata med flere verdier. Flere returnerte uttrykk uten AS etikettene er vanskelige å skille i forklaringen og verditabellen. Merk hver kurve.
  • Alternativer i feil rekkefølge. Visningsklausuler knyttes til verdien de følger. Å skrive RETURN a, b COLOURED(255,0,0) farger kun b, ikke begge kurvene.
  • AS, merker en returnert verdi i forklaringen og verditabellen.
  • COLOURED, angir fargen på en returnert kurve.
  • STYLE, angir linjetype og tykkelse for en returnert kurve.
  • DRAWTEXT, draws text on the chart independently of RETURN.
  • CALL, kaller en annen indikator og mottar verdiene den returnerer.
  • IF, conditional logic that prepares the value RETURN outputs.
  • GRAPH, motstykket på strategisiden for å plotte feilsøkingsverdier.
  • SCREENER, motstykket på screener-siden som gir ut resultatkolonnen.