Bli medlem idag
Instruktioner/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.

Syntax

probuilder
RETURN expression

Med visningsalternativ och flera värden:

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

Så fungerar 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.

Varje returnerat uttryck accepterar valfria visningsklausuler. AS "name" namnger kurvan i förklaringen och värdetabellen. COLOURED(R, G, B) fastställer linjens färg från RGB-komponenter. STYLE styr linjetyp och tjocklek. Dessa klausuler fästs per värde, så en indikator med två linjer kan formatera varje kurva oberoende.

RETURN belongs to indicator code only. ProOrder and ProBacktest strategies do not plot values through RETURN, they use GRAPH och GRAPHONPRICE for inspection output, and a RETURN statement in strategy code is rejected. ProScreener uses the SCREENER instruktionen att i stället skriva ut sin resultatkolumn.

Ett ensamt RETURN utan uttryck är giltigt och ritar ingenting, vilket är användbart när skriptet ritar uteslutande via ritkommandon som DRAWTEXT och behöver bara en avslutningspunkt.

När en indikator anropar en annan 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.

Exempel

Exempel 1, Returnera en formaterad RSI-kurva (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".

Exempel 2, Returnera två märkta kurvor (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.

Vanliga fel och fallgropar

  • 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.
  • Inte giltigt i strategier. ProOrder and ProBacktest code cannot use RETURN. Use GRAPH eller GRAPHONPRICE där, och den SCREENER instruktionen i ProScreener.
  • Saknade etiketter vid utdata med flera värden. Flera returnerade uttryck utan AS etiketter är svåra att skilja åt i förklaringen och värdetabellen. Märk varje kurva.
  • Alternativ i fel ordning. Visningssatser hör till det värde de följer. Att skriva RETURN a, b COLOURED(255,0,0) färgar endast b, inte båda kurvorna.
  • AS, märker ett returnerat värde i legenden och värdetabellen.
  • COLOURED, anger färgen på en returnerad kurva.
  • STYLE, anger linjetyp och tjocklek för en returnerad kurva.
  • DRAWTEXT, draws text on the chart independently of RETURN.
  • CALL, anropar en annan indikator och tar emot dess returnerade värden.
  • IF, conditional logic that prepares the value RETURN outputs.
  • GRAPH, motsvarigheten på strategisidan för att rita ut felsökningsvärden.
  • SCREENER, motsvarigheten på screenersidan som matar ut resultatkolumnen.