powerlanguage keyword reference - multicharts · magenta margin market marketposition...

PowerLanguage Keyword Reference

KeywordAlphabeticalIndex

A-DE-NO-ST-Z

#BeginCmtry#Events#ReturnAAbortAboveAbsValueAgoAlertAlertEnabledAllAllowSendOrdersAlwaysAnAndArcTangentArrayArray_CompareArray_ContainsArray_CopyArray_GetBooleanValueArray_GetFloatValueArray_GetIntegerValueArray_GetMaxIndexArray_GetStringValueArray_GetTypeArray_IndexOfArray_SetBooleanValueArray_SetFloatValueArray_SetIntegerValue

Array_SetMaxIndexArray_SetStringValueArray_SetValRangeArray_SortArray_SumArraysArraySizeArrayStartAddrArw_Anchor_to_BarsArw_DeleteArw_Get_Anchor_to_BarsArw_GetActiveArw_GetBarNumberArw_GetColorArw_GetDateArw_GetDirectionArw_GetFirstArw_GetLockArw_GetNextArw_GetSizeArw_GetStyleArw_GetTextArw_GetTextAttributeArw_GetTextBGColorArw_GetTextColorArw_GetTextFontNameArw_GetTextSizeArw_GetTimeArw_GetTime_DTArw_GetTime_sArw_GetValArw_LockArw_NewArw_New_BNArw_New_DT

Arw_New_sArw_New_selfARW_New_Self_BNArw_New_Self_DTArw_New_self_sArw_SetBarNumberArw_SetColorArw_SetLocationArw_SetLocation_BNArw_SetLocation_DTArw_SetLocation_sArw_SetSizeArw_SetStyleArw_SetTextArw_SetTextAttributeArw_SetTextBGColorArw_SetTextColorArw_SetTextFontNameArw_SetTextSizeAskSizeAtAtCommentaryBarAUDAutoSessionAvgBarsEvenTradeAvgBarsLosTradeAvgBarsWinTradeAvgEntryPriceAvgEntryPrice_at_BrokerAvgEntryPrice_at_Broker_for_The_StrategyAvgListBarBarIntervalBars

BarsSinceEntryBarsSinceEntry_CheckedBarsSinceExitBarsSinceExit_CheckedBarStatusBarTypeBarType_exBasedBaseDataNumberBeginBelowBidSizeBigPointValueBlackBlueBoolBoxSizeBreakBuyBuyToCoverByByteCCADCallCancelAlertcaseCategoryCeilingChangeMarketPositionCharCheckAlertCheckCommentaryCHFClearDebug

ClearPrintLog

CloseCommandLineCommentaryCommentaryCLCommentaryEnabledCommissionComputerDateTimeContractContractProfitContractsConvert_CurrencyCosineCotangentCoverCrossCrossesCurrentBarCurrentContractsCurrentDataNumberCurrentDateCurrentEntriesCurrentOpenIntCurrentSharesCurrentTimeCurrentTime_sCyanDDailyCloseDailyHighDailyLimitDailyLowDailyOpenDailyVolume

DarkBlueDarkBrown

DarkCyanDarkGrayDarkGreenDarkMagentaDarkRedDarkYellowDataDataCompressionDateDateTimeDatetime_bar_updateDateTime2ELTimeDateTime2ELTime_sDateTimeToStringDateTimeToString_MsDateToJulianDateToStringDayDayFromDateTimeDayOfMonthDayOfWeekDayOfWeekFromDateTimeDaysDefaultDefineDLLFuncDescriptionDoesDOM_AskPriceDOM_AsksCountDOM_AskSizeDOM_BidPriceDOM_BidsCount

DOM_BidSizeDOM_IsConnectedDouble

DoubleQuoteDownTicksDownToDWORD

A-DE-NO-ST-Z

El_DateStrEl_DateToDateTimeEL_TimeToDateTimeEL_TimeToDateTime_sELDateToDateTimeElseELTimeToDateTimeELTimeToDateTime_sEncodeDateEncodeTimeEndEntryEntryDateEntryDate_CheckedEntryDateTimeEntryDateTime_CheckedEntryNameEntryPriceEntryPrice_CheckedEntryTimeEntryTime_CheckedEURExchListedExecOffsetExitDateExitDate_CheckedExitDateTimeExitDateTime_CheckedExitName

ExitPriceExitPrice_CheckedExitTimeExitTime_CheckedExpirationDateExpirationDateFromVendorExpValueExternalFalseFileFileAppendFileDeleteFill_ArrayFloatFloorForFormatDateFormatTimefpcExactAccuracyfpcHighAccuracyfpcLowAccuracyfpcMedAccuracyfpcVeryHighAccuracyfpcVeryLowAccuracyFracPortionFridayFromGBPGetAccountGetAccountIDGetAppInfoGetBackgroundColorGetBValueGetCDRomDriveGetCountry

GetCurrencyGetExchangeNameGetGValueGetNumAccountsGetNumPositionsGetPlotBGColorGetPlotColorGetPlotWidthGetPositionAveragePriceGetPositionOpenPLGetPositionQuantityGetPositionSymbolGetPositionTotalCostGetRTAccountEquityGetRTAccountNetWorthGetRTSymbolNameGetRTUnrealizedPLGetRValueGetStrategyNameGetSymbolNameGetUserIDGetUserNameGradientColorGreenGrossLossGrossProfitHHighHigherHKDHoursFromDateTimeIi_AvgEntryPricei_AvgEntryPrice_at_Broker

i_AvgEntryPrice_at_Broker_for_The_Strategyi_ClosedEquityi_CurrentContractsi_CurrentSharesI_getplotvaluei_MarketPositioni_MarketPosition_at_Brokeri_MarketPosition_at_Broker_for_The_Strategyi_OpenEquityI_setplotvalueiEasyLanguageObjectIfIncMonthInitialCapitalInputInputsInsideAskInsideBidInStrIntInt64IntervalTypeIntervalType_exIntPortionIntraBarOrderGenerationIntraBarPersistIsJPYJulianToDateLLargestLosTradeLargestWinTradeLastLastCalcDateTimeLastCalcJDate

LastCalcMMTime

LastCalcmSTimeLastCalcSSTimeLeftStrLegacyColorToRGBLegacyColorValueLightGrayLimitLogLongLowLowerLowerStrLPBoolLPByteLPDoubleLPDWORDLPFloatLPIntLPLongLPSTRLPWORDMagentaMarginMarketMarketPositionMarketPosition_at_BrokerMarketPosition_at_Broker_for_The_StrategyMarketPosition_CheckedMaxBarsBackMaxBarsForwardMaxConsecLosersMaxConsecWinnersMaxContractProfit

MaxContractProfit_CheckedMaxContracts

MaxContracts_CheckedMaxContractsHeldMaxEntriesMaxEntries_CheckedMaxIDDrawDownMaxListMaxList2MaxPositionLossMaxPositionLoss_CheckedMaxPositionProfitMaxPositionProfit_CheckedMaxPositionsAgoMaxSharesMaxShares_CheckedMaxSharesHeldMC_Arw_GetActiveMC_Text_GetActiveMC_TL_GetActiveMC_TL_NewMC_TL_New_BNMC_TL_New_DTMC_TL_New_SelfMC_TL_New_Self_BNMC_TL_New_Self_DTMessageLogMethodMidStrMillisecondsFromDateTimeMinListMinList2MinMoveMinutesFromDateTime

ModMondayMonth

MonthFromDateTimeMouseClickBarNumberMouseClickCtrlPressedMouseClickDataNumberMouseClickDateTimeMouseClickPriceMouseClickShiftPressedNegNetProfitNewLineNextNOKNoneNoPlotNotNthMaxListNthMinListNumericNumericArrayNumericArrayRefNumericRefNumericSeriesNumericSimpleNumEvenTradesNumLosTradesNumToStrNumWinTradesNZD

A-DE-NO-ST-Z

OOfOnOnCreateOnDestroyOpenOpenEntriesCountOpenEntryComissionOpenEntryContractsOpenEntryDateOpenEntryMaxProfitOpenEntryMaxProfitPerContractOpenEntryMinProfitOpenEntryMinProfitPerContractOpenEntryPriceOpenEntryProfitOpenEntryProfitPerContractOpenEntryTimeOpenIntOpenPositionProfitOptionTypeOrOverPercentProfitPlacePlaceMarketOrderPlaySoundPlotPlotPaintBar

PlotPBpmm_get_global_named_numpmm_get_global_named_strpmm_get_my_named_numpmm_get_my_named_strpmm_set_global_named_numpmm_set_global_named_strpmm_set_my_named_numpmm_set_my_named_strpmm_set_my_statuspmms_get_strategy_named_numpmms_get_strategy_named_strpmms_set_strategy_named_numpmms_set_strategy_named_strpmms_strategies_allow_entries_allpmms_strategies_countpmms_strategies_deny_entries_allpmms_strategies_get_by_symbol_namepmms_strategies_in_long_countpmms_strategies_in_positions_countpmms_strategies_in_short_countpmms_strategies_pause_allpmms_strategies_resume_allpmms_strategies_set_status_for_allpmms_strategy_allow_entriespmms_strategy_allow_exit_from_longpmms_strategy_allow_exit_from_shortpmms_strategy_allow_exitspmms_strategy_allow_long_entriespmms_strategy_allow_short_entriespmms_strategy_close_positionpmms_strategy_currentcontractspmms_strategy_deny_entriespmms_strategy_deny_exit_from_longpmms_strategy_deny_exit_from_short

pmms_strategy_deny_exitspmms_strategy_deny_long_entriespmms_strategy_deny_short_entriespmms_strategy_entrypricepmms_strategy_get_entry_contractspmms_strategy_is_pausedpmms_strategy_marketpositionpmms_strategy_maxiddrawdownpmms_strategy_netprofitpmms_strategy_openprofitpmms_strategy_pausepmms_strategy_resumepmms_strategy_riskcapitalpmms_strategy_set_entry_contractspmms_strategy_set_statuspmms_strategy_symbolPointPointsPointValuePortfolio_CalcMaxPotentialLossForEntryPortfolio_CurrencyCodePortfolio_CurrentEntriesPortfolio_GetMarginPerContractPortfolio_GetMaxPotentialLossPerContractPortfolio_GrossLossPortfolio_GrossProfitPortfolio_InvestedCapitalPortfolio_MaxIDDrawdownPortfolio_MaxOpenPositionPotentialLossPortfolio_MaxRiskEquityPerPosPercentPortfolio_NetProfitPortfolio_NumLossTradesPortfolio_NumWinTradesPortfolio_OpenPositionProfit

Portfolio_PercentProfitPortfolio_SetMaxPotentialLossPerContractPortfolio_StrategyDrawdownPortfolio_TotalMaxRiskEquityPercentPortfolio_TotalTradesPortfolioEntriesPriorityPosPositionProfitPositionProfit_CheckedPosTradeCommissionPosTradeCountPosTradeEntryBarPosTradeEntryCategoryPosTradeEntryDateTimePosTradeEntryNamePosTradeEntryPricePosTradeExitBarPosTradeExitCategoryPosTradeExitDateTimePosTradeExitNamePosTradeExitPricePosTradeIsLongPosTradeIsOpenPosTradeProfitPosTradeSizePowerPrevClosePriceScalePrintProcessMouseEventsPutq_Askq_asksizeq_Bidq_bidsize

q_BigPointValue

q_Dateq_ExchangeListedq_Lastq_OpenInterestq_PreviousCloseq_Timeq_Time_Dtq_Time_sq_TotalVolumeq_tradevolumeRaiseRunTimeErrorRandomRecalcLastBarAfterRecalcPersistReCalculateRedRegularSessionRevSizeRGBRGBToLegacyColorRightStrRoundRTSymbolRTSymbolNameSameExitFromOneEntryOnceSaturdayScrollToBarSecondsFromDateTimeSEKSelfSellSellShortSess1EndTime

Sess1FirstBarTimeSess1StartTime

Sess2EndTimeSess2FirstBarTimeSess2StartTimeSessionCountSessionCountMSSessionEndDaySessionEndDayMSSessionEndTimeSessionEndTimeMSSessionLastBarSessionStartDaySessionStartDayMSSessionStartTimeSessionStartTimeMSSetBreakEvenSetBreakEven_ptSetCustomFitnessValueSetDollarTrailingSetExitOnCloseSetFPCompareAccuracySetMaxBarsBackSetPercentTrailingSetPercentTrailing_ptSetPlotBGColorSetPlotColorSetPlotWidthSetProfitTargetSetProfitTarget_ptSetStopContractSetStopLossSetStopLoss_ptSetStopPosition

SetStopShareSetTrailingStop_ptSGD

ShareSharesShortSignSineSlippageSpacesSquareSquareRootStopStrikeStringStringArrayStringArrayRefStringRefStringSeriesStringSimpleStringToDateStringToDateTimeStringToDTFormattedStringToTimeStrLenStrToNumSumListSundayswitchSymbolSymbol_CloseSymbol_CurrentBarSymbol_DateSymbol_DownTicks

Symbol_HighSymbol_LengthSymbol_LowSymbol_Open

Symbol_OpenIntSymbol_TickIDSymbol_TicksSymbol_TimeSymbol_Time_SSymbol_UpTicksSymbol_VolumeSymbolCurrencyCodeSymbolName

A-DE-NO-ST-Z

TTangentTextText_Anchor_to_BarsText_DeleteText_Get_Anchor_to_BarsText_GetActiveText_GetAttributeText_GetBarNumberText_GetBGColorText_GetBorderText_GetColorText_GetDateText_GetFirstText_GetFontNameText_GetHStyleText_GetLockText_GetNextText_GetSizeText_GetStringText_GetTimeText_GetTime_DTText_GetTime_sText_GetValueText_GetVStyleText_LockText_NewText_New_BNText_New_Dt

Text_New_sText_New_selfText_New_Self_BNText_New_Self_DTText_New_self_sText_SetAttributeText_SetBarNumberText_SetBGColorText_SetBorderText_SetColorText_SetFontNameText_SetLocationText_SetLocation_BNText_SetLocation_DTText_SetLocation_sText_SetSizeText_SetStringText_SetStyleThanTheThenThisThreadSafeThursdayTickIDTicksTimeTime_sTime_s2TimeTime2Time_sTimeToStringTL_Anchor_to_BarsTL_DeleteTL_Get_Anchor_to_BarsTL_GetActive

TL_GetAlertTL_GetBegin_BNTL_GetBegin_DtTL_GetBeginDateTL_GetBeginTimeTL_GetBeginTime_sTL_GetBeginValTL_GetColorTL_GetEnd_BNTL_GetEnd_DtTL_GetEndDateTL_GetEndTimeTL_GetEndTime_sTL_GetEndValTL_GetExtLeftTL_GetExtRightTL_GetFirstTL_GetLockTL_GetNextTL_GetSizeTL_GetStyleTL_GetValueTL_GetValue_BNTL_GetValue_DtTL_GetValue_sTL_LockTL_NewTL_New_BNTL_New_DtTL_New_sTL_New_selfTL_New_Self_BNTL_New_Self_DtTL_New_Self_s

TL_SetAlertTL_SetBeginTL_SetBegin_BNTL_SetBegin_DTTL_SetBegin_sTL_SetColorTL_SetEndTL_SetEnd_BNTL_SetEnd_DtTL_SetEnd_sTL_SetExtLeftTL_SetExtRightTL_SetSizeTL_SetStyleToTodayTool_DashedTool_Dashed2Tool_Dashed3Tool_DottedTool_SolidTotalTotalBarsEvenTradesTotalBarsLosTradesTotalBarsWinTradesTotalTradesTradeDateTradeTimeTradeVolumeTrueTrueFalseTrueFalseArrayTrueFalseArrayRefTrueFalseRefTrueFalseSeries

TrueFalseSimple

TRY_TuesdayUnderUnsignedUpperStrUpTicksUSDVVarVariableVariablesVarsVarSizeVarStartAddrVoidVolumeWasWednesdayWhileWhiteWORDYearYearFromDateTimeYellowYesterdayZAR

GetAccount

Returnstheaccountnumberfortheaccountataspecificlocationinthelistofaccounts.

IfthevaluereturnedbyGetNumAccountsisanon-zero,then:

for1<=AccountLoc<=GetNumAccounts,thefunctionreturnstheaccountnumber.

Forothersequencenumbersanemptystring("")isreturned.

GetAccount(AccountLoc)

Where:AccountLoc-thesequencenumberoftheaccountinthelistofaccounts.

ThisfunctioncanbeusedalongwithGetNumAccounts,toenumerateavailableaccountsreturnedbybroker.

Example

Thebrokerreturnedthefollowinglistofaccounts:"DU12345","DU23456","DU34567","DU45678".

GetAccount(3)willreturn"DU34567".

GetAccount(5)willreturn"".

GetAccountID

Returnstheaccountnumberwhichisusedforautotradingonthechart,wherethestrategyisapplied.

GetAccountID()

Example

GetAccountID()willreturn"DU34567"iftheaccountnumberwhichisusedforautotradingonthechart,wherethestrategyisapplied,isDU12345.

GetNumAccounts

Returnsthenumberofaccountsinthelistofaccountsobtainedfrombroker.

Ifthelistisempty,an"N/A"value,i.e.0,isreturned.

GetNumAccounts

Example

Thebrokerreturnedthefollowinglistofaccounts:"DU12345","DU23456","DU34567","DU45678".GetNumAccountswillreturnavalueof4.

GetNumPositions

ReturnsthenumberofpositionsinMultiChartsOrderandPositionTracker(nottheactualamountatthebroker).

GetNumPositions(Account)

Where:Account-accountnumberatbroker.

Example

GetNumPositions("DU12345")willreturnavalueof3ifthetotalnumberofopenpositionsinMultiChartsOrderandPositionTrackeris3.

GetPositionAveragePrice

Returnsaveragepriceoftheposition.

GetPositionAveragePrice(Symbol,Account)

Where:Symbol-thenameoftheinstrument.Account-accountnumberatbroker.

Example

Willreturnavalueof1.3456iftheaverageentrypricefortheposition,definedbyspecifiedaccount/symbolpairis1.3456.

GetPositionOpenPL

ReturnsOpenPLvaluein:

SymbolcurrencyforAvanza(calculatedonMultiChartsside)AccountcurrencyforAvaTrade(calculatedonthebroker'sside)SymbolcurrencyforCQG(calculatedonthebroker'sside)SymbolcurrencyforDukascopy(calculatedonMultiChartsside)AccountcurrencyforFXCM(calculatedonthebroker'sside)SymbolcurrencyforInteractiveBrokers(calculatedonMultiChartsside)SymbolcurrencyforLMAX(calculatedonthebroker'sside)SymbolcurrencyforMBTrading(calculatedonMultiChartsside)SymbolcurrencyforOpenECry(calculatedonthebroker'sside)SymbolcurrencyforPatsystems(calculatedonthebroker'sside)SymbolcurrencyforTradingTechnologies(calculatedonMultiChartsside)SymbolcurrencyforWeBank(calculatedonMultiChartsside)SymbolcurrencyforRithmic(calculatedonthebroker'sside)

GetPositionOpenPL(Symbol,Account)

Example

Willreturn15ifthecurrentvaluein"OpenPL"columnin"OrderandPositionTracker"windowfortheaccountis15unitsoftheselectedcurrency.

GetPositionQuantity

Returnsthesizeoftheposition,definedbyspecifiedaccount/symbolpair.

GetPositionQuantity(Symbol,Account)

Example

GetPositionQuantity("ESZ1","DU12345")willreturnavalueof1000ifthesizeoftheposition,definedbyspecifiedaccount/symbolpairpositionis¤1000.

GetPositionSymbol

Returnsthesymbolassociatedwiththepositionataspecificlocation(PositionLoc)inthelistofpositionsforthespecifiedaccount.

GetPositionSymbol(Account,PositionLoc)

Where:Account-accountnumberatbroker.1<=PositionLoc<=GetNumPositions-thesequencenumberofthepositioninthepositionlistforthespecifiedaccount.

Example

GetPositionSymbol("DU12345",3)willreturn"ESZ1"ifthepositionwiththesequencenumber3inthepositionlistforaccountDU12345isopenedonESZ1.

GetPositionTotalCost

Calculatedwiththefollowingformula:

PTC(PositionTotalCost)=AEP(AverageEntryPrice)xTMP(TotalMarketPosition).

GetPositionTotalCost(Symbol,Account)

Example

GetPositionTotalCost("ESZ1","DU12345")willreturntotalpositioncostforESZ1onaccountDU1234.

GetRTAccountEquity

ReturnsregularAccountEquityatbroker.

GetRTAccountEquity(Account)

Where:Account-accountnameatbroker.

Example

GetRTAccountEquity("DU12345")willreturnavalueof100000iftheAccountEquityatbrokerforDU12345accountis¤100000.

GetRTAccountNetWorth

ReturnsAccountNetLiquidationvalueatbroker.

GetRTAccountNetWorth(Account)

Where:Account-accountnameatbroker.

Example

GetRTAccountNetWorth("DU12345")willreturnavalueof100000iftheAccountNetLiquidityatbrokerforDU12345accountis100000inbasecurrency.

GetRTUnrealizedPL

ReturnstheUnrealized/OpenP&L;forthespecifiedaccount.

GetRTUnrealizedPL(Account)

Where:Account-accountnumberatbroker.

Example

Willreturnavalueof5000ifUnrealized(Open)P&L;fortheaccountatbrokeris¤5000.

InitialCapital

Returnsanumericalvalue,indicatingtheamountofinitialcapitalsetinthestrategyproperties.

InitialCapital

Example

InitialCapitalwillreturn10000ifInitialCapitalamountwassetto10000intheStrategyProperties.

AlertTriggersanalertwindowwherethenecessarytextcanbecreated.Thetextcanbedynamic,staticorabsent.

Ifthetextisn'tsetinthealertthenSource,Symbol,Resolution,Priceisdisplayed

Alertsareshownonthelastbaronly

Detailedinformationofalerts'settingsisavailableinFormattingStudies>Alerts

Example

Thisstatementwillcallanalertwithouttextmessage:

Alert;

Thisstatementcreatesadynamicalerttextanddisplaysthenumberoftheweekday:

Alert(Text("Dayofweekis",DayOfWeek(Date)));

Thisstatementwillshowstatictext:

IfClose>Close[1]ThenAlert(Text("Priceturningup"))

AlertEnabledReturnsTrueifthealertshavebeenturnedoninFormatStudy>Alerts.Thisinformationcanmakescriptexecutionmoreefficientbydiscardingredundantcalculations.Thisfunctioncanalsobeusedtonotifytheuserthathewillnotseethealertsuntiltherelevantoptionisturnedon.

AlertEnabled

Alertsareonlygeneratedforthelastbar

ThereisadifferencebetweenAlertEnabledandCheckAlert:AlertEnabledreturnsTrue/FalseforallthebarsonthechartwhileCheckAlertdoessoforthelastbaronly

AlertEnabledwillreturnTrueifalertshavebeenenabled

Example

Theexamplebelowshowshowausercanbenotifiedthathehasforgottentoturnonthealerts:

Variable:ID(-1);

IfAlertEnabled=FalseAndLastBarOnChart_S=TrueThen

ID=Text_New_S(Date,Time_S,Low,"Alertsaredisabled.SeeFormatStudy>Properties>Alerts");

CancelAlertTheexpressiondeactivatesalerts.Thisisnecessaryifascriptcontainsmultiplealertstatementsandtheyneedtobeturnedoffundercertainconditions.

CancelAlert

Alertsareonlygeneratedforthelastbar

Example

Theexampleshowshowallalertscanbeturnedoffdependingontime.Thealertswillnotbedisplayedafter10:00pm.

IfClose>Close[1]ThenAlert("Priceisgoingup");IfVolume>Volume[1]ThenAlert("Volumeisincreasing");IfVolatility(5)>Volatility(5)[1]ThenAlert("Volatilityisrising");IfOpenInt>OpenInt[1]ThenAlert("Openinterestisgrowing");IfTime>=2200ThenCancelAlert;

CheckAlertReturnsTrueifthealertshavebeenturnedoninFormattingStudies>Alerts.

True/Falseisreturnedonthelastbaronly.

ForthebarsotherthanthelastFalseisalwaysreturned.

CheckAlert

ThereisadifferencebetweenAlertEnabledandCheckAlert.AlertEnabledchecksthestatusonallthebarswhileCheckAlertdoessoforthelastbaronly.Alertsareonlygeneratedforthelastbar.

Example

TheexamplebelowshowshowCheckAlertcanhelpeliminateredundantcalculationsonhistoricbarsaswellasincaseswhenalertsarenotturnedon:

IfCheckAlertThenBeginIfVolume>=2*Average(Volume,10)ThenAlert("Volumeisgoingup");End;

Arw_Anchor_to_Bars

Anchorsthecorrespondingarrowdrawingtothevisiblebarindex;returnsavalueof0iftheoperationwasperformedsuccessfully,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

Arw_Anchor_to_Bars(ArrowID,LogicalExpression)

Where:ArrowIDisanumericalexpressionspecifyingthearrowdrawingIDnumberLogicalExpressionisalogicalvalue;True=addoptionandFalse=removeoption

ArrowIDnumberisreturnedbyArw_Newwhenthearrowdrawingiscreated.

Example

AnchorthearrowdrawingwithanIDnumberof5tothevisiblebarindex:

Value1=Arw_Anchor_to_Bars(5,true);

Arw_Delete

RemovesanarrowobjectwiththespecifiedIDnumberfromachart;returnsavalueof0iftheobjectwassuccessfullyremoved,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_Delete(ObjectID)

Where:ObjectID-anumericalexpressionspecifyingtheobjectIDnumber

Anobject-specificIDnumberisreturnedbyArw_Newwhenthearrowobjectiscreated.

Example

RemovethearrowobjectwithanIDnumberof3:

Value1=Arw_Delete(3);

Arw_GetActive

ReturnsanumericalvalueindicatingtheobjectIDnumberofthecurrentlyselectedarrowobject;returnsavalueof-1ifnoarrowobjectsarecurrentlyselected.

Arw_GetActive

Anobject-specificIDnumberisassignedbyArw_Newwhenthearrowobjectiscreated.

Example

Assignavalue,indicatingtheobjectIDnumberofthecurrentlyselectedarrowobject,toValue1variable:

Value1=Arw_GetActive;

Arw_GetBarNumber

ReturnsanumericalvaluerepresentingthebarnumberofthearrowobjectwithaspecifiedID;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_GetBarNumber(ref)

Parameters:

ref-IDofthearrowobject

Example

GetthenumberofthebarwherethearrowobjectwithID=1isplaced:

Arw_GetBarNumber(1);

Arw_GetColor

ReturnsanRGBcolornumberoralegacycolorvaluethatcorrespondtothecolorofthearrowcontainedinanarrowobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_GetColor(ObjectID)

Example

AssignanRGBcolornumber,correspondingtothecolorofthearrowcontainedinanarrowobjectwiththeIDnumberof3,toValue1variable:

Value1=Arw_GetColor(3);

Assignalegacycolorvalue,correspondingtothecolorofthearrowcontainedinanarrowobjectwiththeIDnumberof3,toValue1variable:

[LegacyColorValue=True];Value1=Arw_GetColor(3);

Arw_GetDate

Returnsanumericalvalue,indicatingthedateofthebaratwhichanarrowobjectwiththespecifiedIDnumberhasbeenplaced;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

ThedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

Arw_GetDate(ObjectID)

Example

Assignavalue,indicatingthedateofthebaratwhichanarrowobjectwiththeIDnumberof3hasbeenplaced,toValue1variable:

Value1=Arw_GetDate(3);

Arw_GetDirection

ReturnsalogicalvalueindicatingthedirectionofthearrowcontainedinanarrowobjectwiththespecifiedIDnumber;returnsavalueofTrueforDownarrow,andavalueofFalseforUparroworifthespecifiedobjectIDnumberisinvalid.

Arw_GetDirection(ObjectID)

Example

Assignatrue/falsevalue,indicatingthedirectionofthearrowcontainedinanarrowobjectwiththeIDnumberof3,toDownArrowvariable:

Variable:DownArrow(False);DownArrow=Arw_GetDirection(3);

Arw_GetFirst

Returnsanumericalvalue,indicatingtheobjectIDnumberoftheoldest(thefirsttobeaddedtothecurrentchart)arrowobjectofthespecifiedorigin;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_GetFirst(Origin)

Parameters

Origin-anumericalexpressionspecifyingtheoriginofthearrowobject:

1-addedbythecurrentstudy2-addedbyastudyotherthenthecurrentstudy,ordrawnmanuallybytheuser3-addedbyanystudy,ordrawnmanuallybytheuser4-addedbythecurrentstudy,ordrawnmanuallybytheuser5-addedbyastudyotherthenthecurrentstudy6-addedbyanystudy7-addedmanuallybytheuser

Iftheoldest(thefirstadded)arrowobjectisdeleted,thenextoldest(thesecondadded)arrowobjectbecomestheoldest(thefirstadded)arrowobject.

Example

Assignavalue,indicatingtheobjectIDnumberoftheoldestarrowobjectaddedtothechartbythecurrentstudy,toValue1variable:

Value1=Arw_GetFirst(1);

Arw_GetLock

Lockedarrowdrawingscannotbemovedmanually.KeywordreturnsavalueofTrueforlockeddrawings,andavalueofFalseforunlocked.

Arw_GetLock(ArrowID)

Where:ArrowID-anumericalexpressionspecifyingthearrowdrawingIDnumber

AnarrowIDnumberisreturnedbyArw_Newwhenthearrowdrawingiscreated.

Example

AssignLockpropertyofthearrowdrawingwithanIDnumberof3toCondition1variable:

Condition1=Arw_GetLock(3);

Arw_GetNext

ReturnstheIDnumberofthefirstexistingarrowobjectaddedsubsequenttoanarrowobjectwiththespecifiedIDnumber,withbothobjectsofaspecifiedorigin;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_GetNext(ObjectID,Origin)

Parameters

ObjectID-anumericalexpressionspecifyingtheobjectIDnumber

Origin-anumericalexpressionspecifyingtheoriginofthearrowobjects:

Example

AssignavaluetoValue1variable,indicatingtheIDnumberofthefirstexistingarrowobjectaddedsubsequenttoanarrowobjectwiththeIDnumberof3,withbothobjectsaddedbythecurrentstudy:

Value1=Arw_GetNext(3,1);

Arw_GetSize

ReturnsanumericalvalueindicatingthesizeofthearrowcontainedinanarrowobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_GetSize(ObjectID)

Example

Assignavalue,indicatingthesizeofthearrowinanarrowobjectwiththeIDnumberof3,toValue1variable:

Value1=Arw_GetSize(3);

Arw_GetStyle

Returnsanumericalvalue,indicatingthestyleofthearrowinanarrowobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_GetStyle(ObjectID)

Example

Assignavalue,indicatingthestyleofthearrowinanarrowobjectwiththeIDnumberof3,toValue1variable:

Value1=Arw_GetStyle(3);

Arw_GetText

ReturnsastringexpressioncorrespondingtothetextcontainedinanarrowobjectwiththespecifiedIDnumber.

Arw_GetText(ObjectID)

Example

Arw_GetText(3)willreturnastringexpressioncorrespondingtothetextcontainedinanarrowobjectwiththeIDnumberof3

Arw_GetTextAttribute

ReturnsalogicalvalueindicatingthesettingforanattributeofthetextinanarrowobjectwiththespecifiedIDnumber;returnsavalueofTrueiftheattributeissettoon,andavalueofFalseiftheattributeissettoofforifthespecifiedobjectIDnumberisinvalid.

Thesettingsofthefollowingattributescanbereturned:border,bold,italic,strike-out,andunderline.

Arw_GetTextAttribute(ObjectID,Attribute)

Parameters

Attribute-anumericalexpressionspecifyingtheattribute:

0-border1-bold2-italic3-strike-out4-underline

Anobject-specificIDnumberisassignedbyArw_Newwhenthearrowobjectiscreated.

Example

Assignatrue/falsevalue,indicatingthesettingof"bold"attributeforthearrowobjectwithanIDnumberof3,toArwTxtBoldvariable:

Variable:ArwTxtBold(False);ArwTxtBold=Arw_GetTextAttribute(3,1);

Arw_GetTextBGColor

ReturnsanRGBcolornumberoralegacycolorvaluethatcorrespondtothetextbackgroundcolorofanarrowobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_GetTextBGColor(ObjectID)

Example

AssignanRGBcolornumber,correspondingtothetextbackgroundcolorofanarrowobjectwiththeIDnumberof3,toValue1variable:

Value1=Arw_GetTextBGColor(3);

Assignalegacycolorvalue,correspondingtothetextbackgroundcolorofanarrowobjectwiththeIDnumberof3,toValue1variable:

[LegacyColorValue=True];Value1=Arw_GetTextBGColor(3);

Arw_GetTextColor

ReturnsanRGBcolornumberoralegacycolorvaluethatcorrespondtothecolorofthetextcontainedinanarrowobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_GetTextColor(ObjectID)

Example

AssignanRGBcolornumber,correspondingtothecolorofthetextcontainedinanarrowobjectwiththeIDnumberof3,toValue1variable:

Value1=Arw_GetTextColor(3);

Assignalegacycolorvalue,correspondingtothecolorofthetextcontainedinanarrowobjectwiththeIDnumberof3,toValue1variable:

[LegacyColorValue=True];Value1=Arw_GetTextColor(3);

Arw_GetTextFontName

ReturnsastringexpressioncorrespondingtothenameofthetextfontassignedtoanarrowobjectwiththespecifiedIDnumber.

Arw_GetTextFontName(ObjectID)

Example

Arw_GetTextFontName(3)willreturnastringexpressioncorrespondingtothenameofthetextfontassignedtoanarrowobjectwiththeIDnumberof3

Arw_GetTextSize

ReturnsanumericalvalueindicatingthefontsizeassignedtothetextofanarrowobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_GetTextSize(ObjectID)

Example

Assignavalue,indicatingthefontsizeofthetextinanarrowobjectwiththeIDnumberof3,toValue1variable:

Value1=Arw_GetTextSize(3);

Arw_GetTime

Returnsanumericalvalue,indicatingthetimeofthebaratwhichanarrowobjectwiththespecifiedIDnumberhasbeenplaced;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

Arw_GetTime(ObjectID)

Example

Assignavalue,indicatingthetimeofthebaratwhichanarrowobjectwiththeIDnumberof3hasbeenplaced,toValue1variable:

Value1=Arw_GetTime(3);

Arw_GetTime_DT

Returnsadouble-precisiondecimalDateTimevalueindicatingthetimeofthebaratwhichanarrowobjectwiththespecifiedIDnumberhasbeenplaced;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

ThetimeisindicatedintheDateTimeformat,wheretheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.DateTimeisafloatingpointvaluewithhighprecision.Itallowsaccessingmillisecondtimestampsofthebar.

Arw_GetTime_DT(ObjectID)

Anobject-specificIDnumberisreturnedbyArw_New_dtwhenthearrowobjectiscreated.

Example

Value1=Arw_GetTime_DT(3);

Arw_GetTime_s

Returnsanumericalvalueindicatingthetimeofthebar,includingseconds,atwhichanarrowobjectwiththespecifiedIDnumberhasbeenplaced;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Thetimeisindicatedinthe24-hourHHmmssformat,where130000=1:00:00PM.

Arw_GetTime_s(ObjectID)

Anobject-specificIDnumberisreturnedbyArw_New_swhenthearrowobjectiscreated.

Example

Value1=Arw_GetTime_s(3);

Arw_GetVal

Returnsthepricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart),atwhichanarrowobjectwiththespecifiedIDnumberhasbeenplaced;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_GetVal(ObjectID)

Example

Assignavalue,indicatingthepricevalueatwhichanarowobjectwiththeIDnumberof3hasbeenplaced,toValue1variable:

Value1=Arw_GetVal(3);

Arw_Get_Anchor_to_Bars

Returnsthevalueof"anchortobar"optionofthearrowdrawingwithaspecifiedID.

Arw_Get_Anchor_to_Bars(ArrowID)

Where:ArrowIDisanumericalexpressionspecifyingthearrowdrawingIDnumber

Example

Assign"anchortobars"optionofthearrowdrawingwithanIDnumberof3totheCondition1variable:

Condition1=Arw_Get_Anchor_to_Bars(3);

Arw_Lock

Lockscorrespondingarrowdrawingsoitcannotbemovedmanually;returnsavalueof0iftheoperationwasperformedsuccessfully,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

Arw_Lock(ArrowID,LogicalExpression)

Where:ArrowID-anumericalexpressionspecifyingthearrowdrawingIDnumberLogicalExpression-alogicalvalue;True=AddandFalse=Remove

Example

LockthearrowdrawingwithanIDnumberof3:

Value1=Arw_Lock(3,True);

UnlockthearrowdrawingwithanIDnumberof5:

Value1=Arw_Lock(5,False);

Arw_New

Displaysanobject,consistingofanuporadownarrowlocatedatthespecifiedbarandspecifiedpricevalue,onthechartthatthestudyisbasedon;returnsanobject-specificIDnumber,requiredtomodifytheobject.

Arw_New(BarDate,BarTime,PriceValue,Direction)

Parameters

BarDate-anumericalexpressionspecifyingthedateofthebaratwhichtheobjectistobeplaced;thedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth

BarTime-anumericalexpressionspecifyingthetimeofthebaratwhichtheobjectistobeplaced;thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM

PriceValue-anumericalexpressionspecifyingthepricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart),wheretheobjectistobeplaced

Direction-alogicalexpressionspecifyingthedirectionofthearrow;True=DownandFalse=Up

Example

Place,onthechartthatthestudyisbasedon,anuparrowatthetopofabariftheOpenpricehasincreasedincrementallyoverthelastthreebars:

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Arw_New(Date,Time,High,False);

Arw_New_BN

Displaysanobjectconsistingofanuporadownarrowlocatedatthespecifiedbarandspecifiedpricevalueonthechartthatthestudyisbasedon;returnsanobject-specificIDnumberrequiredtomodifytheobject.

Arw_New_BN(BarNumber,PriceValue,Direction)

Parameters

BarNumber-anumericalexpressionspecifyingthebarnumberatwhichtheobjectistobeplaced.

PriceValue-anumericalexpressionspecifyingthepricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart),wheretheobjectshouldbeplaced.

Example

Onthechartthatthestudyisbasedon,placeanuparrowatthetopofacurrentbariftheOpenpricehasincreasedincrementallyoverthelastthreebars:

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Arw_New_BN(currentbar,High,False);

Arw_New_DT

Arw_New_DT(Bar_DateTime,PriceValue,Direction)

Parameters

Bar_DateTime-anumericalexpressionspecifyingthedateandtimeofthebaratwhichtheobjectistobeplaced.ThedateandtimeareindicatedintheDateTimeformat,wheretheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.DateTimeisafloatingpointvaluewithhighprecision.Itallowsaccessingmillisecondtimestampsofthebar.

PriceValue-anumericalexpressionspecifyingthepricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart),wheretheobjectistobeplaced.

Example

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Arw_New_DT(DateTime,High,False);

Arw_New_s

Arw_New_s(BarDate,BarTime_s,PriceValue,Direction)

Parameters

BarTime_s-anumericalexpressionspecifyingthetimeofthebar,includingseconds,atwhichtheobjectistobeplaced;thetimeisindicatedinthe24-hourHHmmssformat,where130000=1:00:00PM

Example

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Arw_New_s(Date,Time_s,High,False);

Arw_New_self

Displaysanobject,consistingofanuporadownarrowlocatedatthespecifiedbarandspecifiedpricevalue,ontheSubChartcontainingthestudy;returnsanobject-specificIDnumber,requiredtomodifytheobject.

Arw_New_self(BarDate,BarTime,PriceValue,Direction)

Parameters

Example

Place,ontheSubChartcontainingthestudy,anuparrowatthetopofabariftheOpenpricehasincreasedincrementallyoverthelastthreebars:

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Arw_New_self(Date,Time,High,False);

ARW_New_Self_BNThesameasArw_New_BN.Difference:DisplaysaarrowontheSubChartcontainingthestudy.

Arw_New_Self_DT

Arw_New_Self_DT(Bar_DateTime,PriceValue,Direction)

Parameters

Example

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Arw_New_Self_DT(DateTime,High,False);

Arw_New_self_s

Arw_New_self_s(BarDate,BarTime_s,PriceValue,Direction)

Parameters

Example

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Arw_New_self_s(Date,Time_s,High,False);

Arw_SetBarNumber

AssignsthespecifiedbarnumbertothearrowobjectwiththespecifiedIDnumber;returnsavalueof0ifthebarnumberwassuccessfullyassigned,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_SetBarNumber(ref,Barnumber)

Parameters:

ref-IDofthearrowobjectBarnumber-thenewbarnumberthatistobeassignedtothespecifiedobject.

Example

Assignthenewbarnumbervalueof100tothearrowobjectwithID=1:

Arw_SetBarNumber(1,100);

Arw_SetColor

AssignsthespecifiedcolortothearrowcontainedinanarrowobjectwiththespecifiedIDnumber;returnsavalueof0ifthecolorwassuccessfullyassigned,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_SetColor(ObjectID,ArrowColor)

Parameters

ArrowColor-anexpressionspecifyingthecolorofthearrow

ThecolorcanbespecifiedbyanumericalexpressionrepresentinganRGBcolornumberoralegacycolorvalue,orbyoneof17basecolorwords.

Example

AssignthecolorbluetothearrowcontainedinanarrowobjectwiththeIDnumberof3:

Value1=Arw_SetColor(3,Blue);

AssigntheRGBcolor2138336(Orange)tothearrowcontainedinanarrowobjectwiththeIDnumberof3:

Value1=Arw_SetColor(3,2138336);

Assignthelegacycolor4(Green)tothearrowcontainedinanarrowobjectwiththeIDnumberof3:

[LegacyColorValue=True];Value1=Arw_SetColor(3,4);

Arw_SetLocation

ModifiesthelocationofanarrowobjectwiththespecifiedIDnumber;returnsavalueof0ifthelocationoftheobjectwassuccessfullymodified,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_SetLocation(ObjectID,BarDate,BarTime,PriceValue)

Parameters

Example

MovethearrowobjectwithanIDnumberof3tothetopofthecurrentbar:

Value1=Arw_SetLocation(3,Date,Time,High);

Arw_SetLocation_BN

ModifieslocationofanarrowobjectwiththespecifiedIDnumber;returnsavalueof0iflocationoftheobjectwassuccessfullymodified,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_SetLocation_BN(ObjectID,BarNumber,PriceValue)

Parameters

ObjectID-anumericalexpressionspecifyingtheobjectIDnumber.

Anobject-specificIDnumberisreturnedbyArw_New_Dtwhenthearrowobjectiscreated.

Example

Value1=Arw_SetLocation_BN(3,currentbar,High);

Arw_SetLocation_DT

Arw_SetLocation_DT(ObjectID,Bar_DateTime,PriceValue)

Parameters

Anobject-specificIDnumberisreturnedbyArw_New_Dtwhenthearrowobjectiscreated.

Example

Value1=Arw_SetLocation_DT(3,DateTime,High);

Arw_SetLocation_s

Arw_SetLocation_s(ObjectID,BarDate,BarTime_s,PriceValue)

Parameters

Anobject-specificIDnumberisreturnedbyArw_New_swhenthearrowobjectiscreated.

Example

Value1=Arw_SetLocation_s(3,Date,Time_s,High);

Arw_SetSize

AssignsthespecifiedsizetothearrowcontainedinanarrowobjectwiththespecifiedIDnumber;returnsavalueof0ifthesizewassuccessfullyassigned,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_SetSize(ObjectID,ArrowSize)

Where:ObjectID-anumericalexpressionspecifyingtheobjectIDnumberArrowSize-anumericalexpressionspecifyingthearrowsize

Example

Assignanarrowsizeof10tothearrowobjectwithanIDnumberof3:

Value1=Arw_SetSize(3,10);

Arw_SetStyle

AssignsthespecifiedstyletothearrowofanarrowobjectwiththespecifiedIDnumber;returnsavalueof0ifthearrowstylewassuccessfullymodified,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_SetStyle(ObjectID,ArrowStyle)

Where:ObjectID-anumericalexpressionspecifyingtheobjectIDnumberArrowStyle-anumericalexpressionspecifyingthearrowstyle;arrowstylesrangefrom0to13

Example

Assignthearrowstyleof5toanarrowobjectwiththeIDnumberof3:

Value1=Arw_SetStyle(3,5);

Arw_SetText

Addstextto,orreplacestheexistingtextcontainedinanarrowobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_SetText(ObjectID,"Text")

Where:ObjectID-anumericalexpressionspecifyingtheobjectIDnumberText-thestringexpressiontobedisplayedinthearrowobject

Example

Addtext"MyArrow"tothearrowobjectwithanIDnumberof3:

Value1=Arw_SetText(3,"MyArrow");

ReplacetextcontainedinthearrowobjectwithanIDnumberof3withthestringexpression"NewText":

Value1=Arw_SetText(3,"NewText");

Arw_SetTextAttribute

SetsanattributeofthetextinanarrowobjectwiththespecifiedIDnumber;returnsavalueof0iftheattributewassuccessfullyset,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Thefollowingtextattributescanbeset:border,bold,italic,strike-out,andunderline.

Arw_SetTextAttribute(ObjectID,Attribute,LogicalExpression)

Parameters

LogicalExpression-alogicalvalue;True=onandFalse=off

Example

Settheattribute"bold"toonforthetextinanarrowobjectwiththeIDnumberof3:

Value1=Arw_SetTextAttribute(3,1,True);

Arw_SetTextBGColor

AssignsthespecifiedbackgroundcolortothetextofanarrowobjectwiththespecifiedIDnumber;returnsavalueof0ifthecolorwassuccessfullyassigned,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_SetTextBGColor(ObjectID,TextBGColor)

Parameters

TextBGColor-anexpressionspecifyingthetextbackgroundcolor

Example

AssignthecolorbluetothetextbackgroundofanarrowobjectwiththeIDnumberof3:

Value1=Arw_SetTextBGColor(3,Blue);

AssigntheRGBcolor2138336(Orange)tothetextbackgroundofanarrowobjectwiththeIDnumberof3:

Value1=Arw_SetTextBGColor(3,2138336);

Assignthelegacycolor4(Green)tothetextbackgroundofanarrowobjectwiththeIDnumberof3:

[LegacyColorValue=True];Value1=Arw_SetTextBGColor(3,4);

Arw_SetTextColor

AssignsthespecifiedcolortothetextcontainedinanarrowobjectwiththespecifiedIDnumber;returnsavalueof0ifthecolorwassuccessfullyassigned,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_SetTextColor(ObjectID,TextColor)

Parameters

TextColor-anexpressionspecifyingthecolorofthetext

Example

AssignthecolorbluetothetextcontainedinanarrowobjectwiththeIDnumberof3:

Value1=Arw_SetTextColor(3,Blue);

AssigntheRGBcolor2138336(Orange)tothetextcontainedinanarrowobjectwiththeIDnumberof3:

Value1=Arw_SetTextColor(3,2138336);

Assignthelegacycolor4(Green)tothetextcontainedinanarrowobjectwiththeIDnumberof3:

[LegacyColorValue=True];Value1=Arw_SetTextColor(3,4);

Arw_SetTextFontName

AssignsthespecifiedfonttothetextofanarrowobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

AnyfontintheFontsfoldercanbeused;thefolderisaccessiblefromtheControlPanelinWindowsXPoperatingsystem.

Arw_SetTextFontName(ObjectID,"FontName")

Where:ObjectID-anumericalexpressionspecifyingtheobjectIDnumberFontName-astringexpressionspecifyingthefontname

Example

AssignfontVerdanatothetextofanarrowobjectwiththeIDnumberof3:

Value1=Arw_SetTextFontName(3,"Verdana");

Arw_SetTextSize

AssignsthespecifiedfontsizetothetextofanarrowobjectwiththespecifiedIDnumber;returnsavalueof0ifthefontsizewassuccessfullyassigned,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Arw_SetTextSize(ObjectID,FontSize)

Where:ObjectID-anumericalexpressionspecifyingtheobjectIDnumberFontSize-anumericalexpressionspecifyingthefontsize

Example

Assignthefontsizeof16tothetextofanarrowobjectwiththeIDnumberof3:

Value1=Arw_SetTextSize(3,16);

MC_Arw_GetActiveReturnsanumericalvalueindicatingthearrowIDnumberofthecurrentlyselectedarrow;returnsavalueof-1ifnoarrowsarecurrentlyselected.

MC_Arw_GetActive

Example

Assignavalue,indicatingthearrowIDnumberofthecurrentlyselectedarrow,toValue1variable:Value1=MC_Arw_GetActive;

AllowSendOrdersAlways

AttributesettoTrueallowsordergenerationevenwhenbarstatusisnotdefined(-1willbereturned).

[AllowSendOrdersAlways=LogicalValue]

Where:LogicalValue-atrue/falsevalue;True=Enable;False=Disable

IftheattributeissettoFalse,ornotpresentinthestudy'scode,itdoesn'tallowordergenerationwhenbarstatusisnotdefined.

IftheattributeissettoTrue,thenallowsgenerationevenwhenbarstatus=-1.

Example

EnableAllowSendOrdersAlwaysvalue:

[AllowSendOrdersAlways=True];

IntraBarOrderGeneration

Togglesintra-barordergenerationflagonoroff.

[IntrabarOrderGeneration=LogicalValue]

Iftheattributeisnotpresentinthestudy'scode,intra-barordergenerationcanbesetbytheuserintheCalculationstaboftheFormatSignalwindow.

IfsettoTrue,"Enableintra-barordergenerationandcalculation"checkboxwillbecheckedandgrayedout,andtheradiobuttonswillbeavailable.

IfsettoFalse,"Enableintra-barordergenerationandcalculation"checkboxwillbeuncheckedandgrayedout,andtheradiobuttonsdisabled.

Attributesareappliedatthetimeofcompilationandcannotbechangedatrun-time.

Example

Enableintra-barordergeneration:

[IntrabarOrderGeneration=True];

LegacyColorValue

Specifiesthecolordesignationschemetobeusedforinterpretationofnumericalcolorvalues.

[LegacyColorValue=LogicalValue]

IftheattributeissettoFalse,ornotpresentinthestudy'scode,theRGB(new)16Mcolorschemewillbeused.

IfLegacyColorValuetheattributeissettoTrue,thelegacy(old)16-bit,16-colorschemewillbeused.

Whenacolornameisconvertedtoanumericalcolorvalue,thespecifiedschemewillbefollowed.

Toensurecompatibility,theattribute[LegacyColorValue=True]isinsertedautomaticallywhenolderversions,priortov8.1,ofEasyLanguagestudiesareimported.

Example

Enablelegacycolorvalueinterpretation:

[LegacyColorValue=True];

CreateaGreencolorplotusingthelegacycolorscheme:

Plot1(Open);

SetPlotColor(1,4);

CreateaGreencolorplotusingtheRGBcolorscheme:

[LegacyColorValue=False];

Plot1(Open);

SetPlotColor(1,65280);

Assignavalue,representingthecolorGreenunderthelegacycolorscheme,toValue1(Value1willbeassignedavalueof4):

Value1=Green;

Assignavalue,representingthecolorGreenundertheRGBcolorscheme,toValue1(Value1willbeassignedavalueof65280):

[LegacyColorValue=False];

Value1=Green;

ProcessMouseEvents

Declaresthatthestudyprocessesmouseevents.

[ProcessMouseEvents=LogicalValue]

Ifthisattributeisnotpresentinthestudy'scode,theindicatorbasedinthemouseeventswillnotbecalculated.Canbeusedonlyinsignalsandindicators

Example

[ProcessMouseEvents=True];

SameExitFromOneEntryOnce

AttributedefinespossibilityofpositionExitusingoneandthesameorder.Ifitisnotspecifiedinthescript,thensettoTruebydefault.

[SameExitFromOneEntryOnce=LogicalValue]

IftheattributeissettoTrue,ornotpresentinthestudy'scode,thenexitfromthespecifiedpositionusingoneandthesameorderisnotpossible.

IftheattributeissettoFalse,thenspecifiedpositioncanbeclosedusingoneandthesameorderunlimitedly.

Example

DisableSameExitFromOneEntryOncevalueinterpretation:

[SameExitFromOneEntryOnce=False];

buy5contractsnextbarmarket;

sell1contractsnextbarmarket;

WhenbacktestingthegivenstrategyoneandthesameExitorder(generatedbysellnextbarmarketcommand)isappliedforpartialpositionclose5times.

Commentingoutthefirstscriptlinedefaultbehaviorwillbeobtained.Exitorderwilltriggeronlyonce.

Constant,usedtodesignatethecolorBlack.

Thebase17colorscanbedesignatedbyconstants.

Example

CreateaplotusingthecolorBlack:

Plot1(Open);SetPlotColor(1,Black);

Constant,usedtodesignatethecolorBlue.

Example

CreateaplotusingthecolorBlue:

Plot1(Open);SetPlotColor(1,Blue);

Constant,usedtodesignatethecolorCyan.

Example

CreateaplotusingthecolorCyan:

Plot1(Open);SetPlotColor(1,Cyan);

DarkBlue

Constant,usedtodesignatethecolorDarkBlue.

DarkBlue

Example

CreateaplotusingthecolorDarkBlue:

Plot1(Open);SetPlotColor(1,DarkBlue);

DarkBrown

Constant,usedtodesignatethecolorDarkBrown.

DarkBrown

Example

CreateaplotusingthecolorDarkBrown:

Plot1(Open);SetPlotColor(1,DarkBrown);

DarkCyan

Constant,usedtodesignatethecolorDarkCyan.

DarkCyan

Example

CreateaplotusingthecolorDarkCyan:

Plot1(Open);SetPlotColor(1,DarkCyan);

DarkGray

Constant,usedtodesignatethecolorDarkGray.

DarkGray

Example

CreateaplotusingthecolorDarkGray:

Plot1(Open);SetPlotColor(1,DarkGray);

DarkGreen

Constant,usedtodesignatethecolorDarkGreen.

DarkGreen

Example

CreateaplotusingthecolorDarkGreen:

Plot1(Open);SetPlotColor(1,DarkGreen);

DarkMagenta

Constant,usedtodesignatethecolorDarkMagenta.

DarkMagenta

Example

CreateaplotusingthecolorDarkMagenta:

Plot1(Open);SetPlotColor(1,DarkMagenta);

DarkRed

Constant,usedtodesignatethecolorDarkRed.

DarkRed

Example

CreateaplotusingthecolorDarkRed:

Plot1(Open);SetPlotColor(1,DarkRed);

DarkYellow

Constant,usedtodesignatethecolorDarkYellow.

DarkYellow

Example

CreateaplotusingthecolorDarkYellow:

Plot1(Open);SetPlotColor(1,DarkYellow);

GetBValueReturnstheBluecolorcomponentvalueofanRGBcolornumber;thevaluerangesfrom0to255.

GetBValue(BigRGBValue)

Where:BigRGBValue-anRGBcolornumberfrom0to16777215

Example

Assignavalue,representingtheBluecolorcomponentoftheRGBcolornumber2138336(Orange),toValue1(Value1willbeassignedavalueof32):

Value1=GetBValue(2138336);

GetGValueReturnstheGreencolorcomponentvalueofanRGBcolornumber;thevaluerangesfrom0to255.

GetGValue(BigRGBValue)

Example

Assignavalue,representingtheGreencolorcomponentoftheRGBcolornumber2138336(Orange),toValue1(Value1willbeassignedavalueof160):

Value1=GetGValue(2138336);

GetRValueReturnstheRedcolorcomponentvalueofanRGBcolornumber;thevaluerangesfrom0to255.

GetRValue(BigRGBValue)

Example

Assignavalue,representingtheRedcolorcomponentoftheRGBcolornumber2138336(Orange),toValue1(Value1willbeassignedavalueof224):

Value1=GetRValue(2138336);

GradientColorReturnsanRGBcolornumber,representingashadeofcolorfromwithinadefinedcolorrange.Thegradientshadeofcolorisdeterminedbythevalueofthespecifiednumericalexpressioninrelationtothedefinedvaluerange.

Forexample,ifthecolorrangeisdefinedasWhitetoBlack,andthevaluerangeisdefinedfrom0to2,GradientColorwillreturnanRGBcolornumberrepresentingWhiteforthevalueof0,Grayforthevalueof1,andBlackforthevalueof2.Whitewillbereturnedforallvalues<0,andBlackforallvalues>2.

GradientColor(Value,Min,Max,StartColor,EndColor)

Where:ValuethespecifiednumericalexpressionMintheminimumvalueofthevaluerange;ifValue=Min,StartColorisreturnedMaxthemaximumvalueofthevaluerange;ifValue=Max,EndColorisreturnedStartColorthestartingcolorofthecolorrangeEndColortheendingcolorofthecolorrange

Example

PlotanADXindicatorinGradientColor,whereMagentagraduallychangesintoWhitefortheindicatorvaluesfrom5to50:

Variable:ADXValue(0);ADXValue=ADX(14);Plot1(ADXValue,"ADXValue");SetPlotColor(1,GradientColor(ADXValue,5,50,Magenta,White));

Constant,usedtodesignatethecolorGreen.

Example

CreateaplotusingthecolorGreen:

Plot1(Open);SetPlotColor(1,Green);

LegacyColorToRGBReturnsanRGBcolornumberthatcorrespondstothespecifiedlegacycolorvalue;thenumberrangesfrom0to16777215.

LegacyColorToRGB(LegacyColorValue)

Where:LegacyColorValue-alegacycolorvaluefrom1to16

Example

Assignavalue,representingthecolor4(Green)underthelegacycolorscheme,toValue1(Value1willbeassignedavalueof65280):

Value1=LegacyColorToRGB(4);

LightGray

Constant,usedtodesignatethecolorLightGray.

LightGray

Example

CreateaplotusingthecolorLightGray:

Plot1(Open);SetPlotColor(1,LightGray);

Magenta

Constant,usedtodesignatethecolorMagenta.

Magenta

Example

CreateaplotusingthecolorMagenta:

Plot1(Open);SetPlotColor(1,Magenta);

Constant,usedtodesignatethecolorRed.

Example

CreateaplotusingthecolorRed:

Plot1(Open);SetPlotColor(1,Red);

RGBReturnsanRGBcolornumberthatcorrespondstothespecifiedcombinationofred,green,andbluecomponentcolorvalues;thenumberrangesfrom0to16777215andrepresentsoneof16Mcolors.

RGB(Red,Green,Blue)

Where:Redanumericalvaluefrom0to255,specifyingtheRedcomponentoftheRGBcolorGreenanumericalvaluefrom0to255,specifyingtheGreencomponentoftheRGBcolorBlueanumericalvaluefrom0to255,specifyingtheBluecomponentoftheRGBcolor

Example

CreateanOrangecolorplotusingtheRGBcolorcombination:

Plot1(Open);SetPlotColor(1,RGB(224,160,32));

RGBToLegacyColorReturnsthelegacycolorvaluethatmostcloselymatchesthespecifiedRGBcolornumber;thevaluerangesfrom0to16.

RGBToLegacyColor(RGBColorValue)

Where:RGBColorValue-anRGBcolornumberfrom0to16777215

Example

Assignavalue,representingthecolor65280(Green)undertheRGBcolorscheme,toValue1(Value1willbeassignedavalueof4):

Value1=RGBToLegacyColor(65280);

Constant,usedtodesignatethecolorWhite.

Example

CreateaplotusingthecolorWhite:

Plot1(Open);SetPlotColor(1,White);

Yellow

Constant,usedtodesignatethecolorYellow.

Yellow

Example

CreateaplotusingthecolorYellow:

Plot1(Open);SetPlotColor(1,Yellow);

AboveUsedincombinationwithCrosstospecifythedirectionofthecross.

Abovespecifiesanupward(lessertoagreatervalue)direction.

TheplotofAisdefinedashavingcrossedAbovetheplotofBifthevalueofAisgreaterthanthevalueofBandoneofthefollowingistrue:

a)ThevalueofAwaslessthanthevalueofBonthebarimmediatelyprecedingthecurrentbar

b)ThevaluesofAandBwereequalforaconsecutivesequenceofoneormorebarsimmediatelyprecedingthecurrentbarandthevalueofAwaslessthanthevalueofBonthebarimmediatelyprecedingthissequenceofbars.

FormoreinformationseeCross.

E1CrossAboveE2

Plot1CrossAbovePlot2

Where:E-anumericalexpression

Example

TriggeranalertonthebarwheretheClosepricecrossesabove1350.00:

Plot1(Close);IfPlot1CrossAbove1350.50ThenAlert("Pricehascrossedabove1350.00");

AndAlogical(Boolean)operatorthatreturnsTrueonlyifbothofitsoperandsaretrue.Logicaloperatorsareusedinlogical(Boolean)expressionsthatoperatewithtrue/falsevalues.

E1AndE2

Where:E-true/falseexpressions

Example

2=1And2=2willreturnavalueofFalse

TrueAndTrueAndTruewillreturnavalueofTrue

BeginUsedincombinationwithEndtogroupinstructionsforconditionalexecution;aBeginmustalwaysbefollowedbyanEnd.

BeginandEndcanbeusedwithThen,Else,For,andWhileconditionalstatements.

Beginshouldnotbefollowedbyasemicolon(;),codelineswithinaninstructiongroupshouldendwithasemicolon(;),andonlythelastinstanceofEndwithinthesameconditionalexecutionstatementshouldbefollowedbyasemicolon(;).

CSBeginI1;I2;

Where:CS-conditionalstatementI-conditionalinstructions

Example

IfUpTrendistruethenbuy,otherwisesellshort:

IfUpTrendThenBeginBuyNextBarMarket;End

ElseBegin

SellShortNextBarMarket;End;

BelowUsedincombinationwithCrosstospecifythedirectionofthecross.

Belowspecifiesadownward(greatertoalesservalue)direction.

TheplotofAisdefinedashavingcrossedBelowtheplotofBifthevalueofAislessthanthevalueofBandoneofthefollowingistrue:

a)ThevalueofAwasmorethanthevalueofBonthebarimmediatelyprecedingthecurrentbar,

b)ThevaluesofAandBwereequalforaconsecutivesequenceofoneormorebarsimmediatelyprecedingthecurrentbarandthevalueofAwasmorethanthevalueofBonthebarimmediatelyprecedingthissequenceofbars.

FormoreinformationseeCross.

E1CrossBelowE2

Plot1CrossBelowPlot2

Where:E-anumericalexpression

Example

TriggeranalertonthebarwheretheClosepricecrossesbelow1350.00:

Plot1(Close);IfPlot1CrossBelow1350.50ThenAlert("Pricehascrossedbelow1350.00");

BreakBreakstheloopexecution.

Break;

Example

Forvalue1=0to10BeginIf(close[value1]=open[value1])thenBreak;End;Ifvalue1<=10thenprint("Open=Close",value1:0:0,"barsago.");

casePartofswitch-caseoperator.

Seeinexample

Example

switchgetplotcolor(1)begincasegreen:print("Indicatoringreenzoneonbar",currentbar);casered:print("Indicatorinredzoneonbar",currentbar);casered:print("Indicatorisneutralonbar",currentbar);end;

CrossReturnsavalueofTrueif,onthecurrentbar,theplotofanumericalexpressionAcrossedtheplotofanumericalexpressionBinthespecifieddirection.

Above,Over,Below,orUnderparametersspecifythedirectionofthecross;AboveandOveraretransposableandspecifyanupward(lessertoagreatervalue)direction,andBelowandUnderaretransposableandspecifyadownward(greatertoalesservalue)direction.

TheplotofAisdefinedashavingcrossedAboveorOvertheplotofBifthevalueofAisgreaterthanthevalueofBandoneofthefollowingistrue:

a)ThevalueofAwaslessthanthevalueofBonthebarimmediatelyprecedingthecurrentbar

b)ThevaluesofAandBwereequalforaconsecutivesequenceofoneormorebarsimmediatelyprecedingthecurrentbarandthevalueofAwaslessthanthevalueofBonthebarimmediatelyprecedingthissequenceofbars.

TheplotofAisdefinedashavingcrossedBeloworUndertheplotofBifthevalueofAislessthanthevalueofBandoneofthefollowingistrue:

a)ThevalueofAwasmorethanthevalueofBonthebarimmediatelyprecedingthecurrentbar,

b)ThevaluesofAandBwereequalforaconsecutivesequenceofoneormorebarsimmediatelyprecedingthecurrentbarandthevalueofAwasmorethanthevalueofBonthebarimmediatelyprecedingthissequenceofbars.

E1CrossDirectionE2

Plot1CrossDirectionPlot2

Where:E-anumericalexpressionDirection-arequiredparameter;specifiesthedirectionofthecross

Example

TriggeranalertonthebarwheretheClosepricecrossesabove1350.00:

Plot1(Close);IfPlot1CrossAbove1350.50ThenAlert("Pricehascrossedabove1350.00");

CrossesSameasCross

DownToUsedincombinationwithFortoformaloopstatementthatwillexecuteasetofinstructionsrepeatedlyuntiltheloopcountreachesthespecifiedfinalvalue.

DownTospecifiesthatthevalueofthecountervariableistobedecreasedbyoneonthecompletionofeachloop.

FormoreinformationseeFor.

ForCounter=IValueDownToFValueBeginI1;I2;

Where:Counter-anumericalvariableusedstoretheloopcountIValue-anumericalexpressionspecifyingtheinitialcountervalueFValue-anumericalexpressionspecifyingthefinalcountervalue

Example

Addthehighpricesofthelast10barstotheHighPriceSumvariable:

ForBarBackNo=9DownTo0BeginHighPriceSum=HighPriceSum+High[BarBackNo];End;

ElseUsedincombinationwithIfandThentoformaconditionalstatementthatexecutesspecificinstructionsifalogicalexpressionisfalse.

TheconditionalexecutionstatementmustcontainbothIfandTheninadditiontoElse.

FormoreinformationseeIf.

IfEThenI1ElseI2

Where:E-atrue/falseexpressionI-conditionalinstructions

Example

IfUpTrendistruethenbuyandifUpTrendisfalsethensellshort:

IfUpTrendThenBuyNextBarMarketElseSellShortNextBarMarket;

EndUsedincombinationwithBegintogroupinstructionsforconditionalexecution;anEndmustalwaysbeprecededbyaBegin.BeginandEndcanbeusedwithThen,Else,For,andWhileconditionalstatements.

OnlythelastinstanceofEndwithinthesameconditionalexecutionstatementshouldbefollowedbyasemicolon(;).

CSBeginI1;I2;

Where:CS-conditionalstatementI-conditionalinstructions

Example

ElseBegin

FalseAlogical(Boolean)value.Logicalvaluesareusedinlogical(Boolean)expressionsandfortrue/falseinputs.

Example

FalseAndTruewillreturnavalueofFalse

2=1willreturnavalueofFalse

DeclareLogicalVarasatrue/falsevariablewiththeinitialvalueoffalse:

Variable:LogicalVar(False);

DeclareOvernightasatrue/falseinputwiththedefaultvalueoffalse:

Input:Overnight(False);

ForUsedincombinationwithToorDownTotoformaloopstatementthatwillexecuteasetofinstructionsrepeatedlyuntiltheloopcountreachesthespecifiedfinalvalue.

Theloopstatementspecifiesanumericalvariablethatholdstheloopcount,aswellasinitialandfinalcountervalues.Tospecifiesthatthevalueofthecountervariableistobeincreasedbyoneonthecompletionofeachloop,whileDownTospecifiesthatthevalueofthecountervariableistobedecreasedbyoneonthecompletionofeachloop.

TheuseofBeginandEndstatementsisrequiredtogrouptheinstructionsforexecutionwithintheloop;aBeginmustalwaysbefollowedbyanEnd.

Beginshouldnotbefollowedbyasemicolon(;),codelineswithinaninstructiongroupshouldendwithasemicolon(;),andEndshouldbefollowedbyasemicolon(;).

ForCounter=IValueToFValueBeginI1;I2;

ForCounter=IValueDownToFValueBeginI1;

Example

ForBarBackNo=0To9Begin

HighPriceSum=HighPriceSum+High[BarBackNo];End;

ForBarBackNo=9DownTo0BeginHighPriceSum=HighPriceSum+High[BarBackNo];End;

IfUsedincombinationwithThentoformaconditionalstatementthatexecutesspecificinstructionsifalogicalexpressionistrue,andwithElsetoformaconditionalstatementthatexecutesspecificinstructionsifalogicalexpressionisfalse.

TheconditionalexecutionstatementmustcontainbothIfandThen;Elseisoptional.

BeginandEndstatementsareusedtogroupinstructionsforconditionalexecution;aBeginmustalwaysbefollowedbyanEnd.

Beginshouldnotbefollowedbyasemicolon(;),codelineswithinaninstructiongroupshouldendwithasemicolon(;),andonlythelastinstanceofEndwithinthesameconditionalexecutionstatementshouldbefollowedbyasemicolon(;).

IfEThenI1ElseI2

IfEThenBeginI1;I2;

ElseBegin

Example

IfUpTrendisfalsethensell:

IfUpTrend=FalseThenSellNextBarMarket;

IfUpTrendThenBuyNextBarMarketElseSellShortNextBarMarket;

ElseBegin

NotUsedinTrue/Falsestatements:negative

Example

Condition1=True;

Condition2=NotCondition1;

AssignstoCondition2valueoppositetoCondition1.

OrAlogical(Boolean)operatorthatreturnsTrueifoneorbothofitsoperandsaretrue.Logicaloperatorsareusedinlogical(Boolean)expressionsthatoperatewithtrue/falsevalues.

E1OrE2

Where:E-true/falseexpressions

Example

2=1Or2>2willreturnavalueofFalse

TrueOrFalseOrFalsewillreturnavalueofTrue

OverSameasAbove

switchPartofswitch-caseoperator.

Seeinexample

Example

switchgetplotcolor(1)begincasegreen:print("Indicatoringreenzoneonbar",currentbar);casered:print("Indicatorinredzoneonbar",currentbar);casered:print("Indicatorisneutralonbar",currentbar);end;

ThenUsedincombinationwithIftoformaconditionalstatementthatexecutesspecificinstructionsifalogicalexpressionistrue.

FormoreinformationseeIf.

IfEThenI

Example

IfUpTrendisfalsethensell:

IfUpTrend=FalseThenSellNextBarMarket;

ToUsedincombinationwithFortoformaloopstatementthatwillexecuteasetofinstructionsrepeatedlyuntiltheloopcountreachesthespecifiedfinalvalue.

Tospecifiesthatthevalueofthecountervariableistobeincreasedbyoneonthecompletionofeachloop.

FormoreinformationseeFor.

ForCounter=IValueToFValueBeginI1;I2;

Example

ForBarBackNo=0To9BeginHighPriceSum=HighPriceSum+High[BarBackNo];End;

TrueAlogical(Boolean)value.Logicalvaluesareusedinlogical(Boolean)expressionsandfortrue/falseinputs.

Example

TrueOrFalsewillreturnavalueofTrue

2=2willreturnavalueofTrue

DeclareLogicalVarasatrue/falsevariablewiththeinitialvalueoftrue:

Variable:LogicalVar(True);

DeclareOvernightasatrue/falseinputwiththedefaultvalueoftrue:

Input:Overnight(True);

UnderSameasBelow

WhileUsedincombinationwithBeginandEndtoformaconditionalloopstatementthatwillexecuteasetofinstructionsrepeatedlyaslongasalogicalexpressionistrue.Ifthelogicalexpressionisnottrue,theinstructionswillnotbeexecuted.

BeginandEndstatementsareusedtogroupinstructionsforconditionalexecution;aBeginmustalwaysbefollowedbyanEnd.

Beginshouldnotbefollowedbyasemicolon(;),codelineswithinaninstructiongroupshouldendwithasemicolon(;),andEndshouldbefollowedbyasemicolon(;).

WhileEBeginI1;I2;

Example

BarBackNo=0;WhileBarBackNo<10BeginHighPriceSum=HighPriceSum+High[BarBackNo];BarBackNo=BarBackNo+1;End;

Constantusedtodesignatethecurrency"AustralianDollar".

Thebase14currenciescanbedesignatedbyconstants.

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"AustralianDollar".

condition1=SymbolCurrencyCode=AUD;

Constantusedtodesignatethecurrency"CanadianDollar".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"CanadianDollar".

condition1=SymbolCurrencyCode=CAD;

Constantusedtodesignatethecurrency"SwissFranc".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"SwissFranc".

condition1=SymbolCurrencyCode=CHF;

Convert_Currency

ReturnstheSrcMoneysum,setintheSrcCurrencycurrency,intheDstCurrencycurrencyusingthecross-rateattheDateTimedateandtime.

Convert_Currency(DateTime,SrcCurrency,DstCurrency,SrcMoney);

Where:

DateTime-dateandtimesetintheDateTimeformat

SrcCurrency-initialcurrencyusedforconversion

DstCurrency-currencytowhichthesumwillbeconvertedto

SrcMoney-fundsininitialcurrency(SrcCurrency)tobeconvertedtoDstCurrency

Example

Convert_Currency(39448.25000000,GBP,USD,12.34);willreturn24.48,whichmeansthat:on1/1/2008:12.34GBPwasequalto24.48USD.

Constantusedtodesignatethecurrency"Euro".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"Euro".

condition1=SymbolCurrencyCode=EUR;

Constantusedtodesignatethecurrency"BritishPound".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"BritishPound".

condition1=SymbolCurrencyCode=GBP;

Constantusedtodesignatethecurrency"HongKongDollar".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"HongKongDollar".

condition1=SymbolCurrencyCode=HKD;

Constantusedtodesignatethecurrency"JapaneseYen".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"JapaneseYen".

condition1=SymbolCurrencyCode=JPY;

Constantusedtodesignatethecurrency"NorwegianKrone".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"NorwegianKrone".

condition1=SymbolCurrencyCode=NOK;

Constantusedtodesignatethatcurrencywasnotindicated.

Example

ChecksifthecurrencyofthesymbolusedforthecalculationisnotindicatedinQuoteManagersettings.

condition1=SymbolCurrencyCode=None;

Constantusedtodesignatethecurrency"NewZealandDollar".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"NewZealandDollar".

condition1=SymbolCurrencyCode=NZD;

Portfolio_CurrencyCode

ReturnscurrencycodefromPortfoliosettings(View->PortfolioSettings)

Portfolio_CurrencyCode

Example

ChecksifthecurrencyofportfolioaccountusedforcalculationisUSDollar.

condition1=Portfolio_CurrencyCode=USD;

Constantusedtodesignatethecurrency"SwedishKrona".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"SwedishKrona".

condition1=SymbolCurrencyCode=SEK;

Constantusedtodesignatethecurrency"SingaporeDollar".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"SingaporeDollar".

condition1=SymbolCurrencyCode=SGD;

SymbolCurrencyCode

ReturnscurrencycodefromQuoteManagersymbolsettings(EditSymbol...->Settings->Currency)

SymbolCurrencyCode

Example

ChecksifthecurrencyofthesymbolusedforcalculationisUSDollar.

condition1=SymbolCurrencyCode=USD;

Constantusedtodesignatethecurrency"TurkishLira".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"TurkishLira".

condition1=SymbolCurrencyCode=TRY_;

Constantusedtodesignatethecurrency"USDollar".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"USDollar".

condition1=SymbolCurrencyCode=USD;

Constantusedtodesignatethecurrency"SouthAfricanRand".

Example

Checksifthecurrencyofthesymbolusedforthecalculationis"SouthAfricanRand".

condition1=SymbolCurrencyCode=ZAR;

AgoUsedincombinationwithBarorBarsandanumericalexpressiontoreferencethebaraspecifiednumberofbarsbackfromthecurrentbar.

BarsAgocanalsobespecifiedbyusingthebaroffsetnotationthatconsistsofanumericalexpressionenclosedinsquarebrackets.

NBarsAgo

Where:N-anumericalexpressionspecifyingthenumberofbarsbacktoreference

Example

Plottheclosingpriceofthepreviousbar:

Plot1(CloseOf1BarAgo,"Previousbar'sclose");

Plottheclosingpriceoftwobarsago:

Plot1(Close[2],"Close2barsago");

BarUsedincombinationwithThis,Next,orAgotoreferenceaspecificbar.

Example

CloseOf1BarAgowillreturntheclosingpriceofthepreviousbar

Buyauser-setnumberofsharesoncloseofthisbar:

BuyThisBarOnClose;

Buyauser-setnumberofsharesonopenofnextbar:

BuyNextBarOnOpen;

BarInterval

Returnsanumericalvalue,indicatingthenumberofresolutionunits(barinterval)ofthedataseriesthatthestudyisappliedto.

ReturnsthenumberofTicks,Contracts,Points,Changes,Seconds,Minutes,Hours,Days,Weeks,Months,Quarters,orYears,dependingonthechartresolution;avalueof5willbereturnedfora5-secondaswellasfora5-tickchart.

BarInterval

Example

Assignavalue,indicatingthenumberofresolutionunits(barinterval)ofthedataseriesthatthestudyisappliedto,toValue1variable:

Value1=BarInterval;

BarsSameasBar

BarStatusReturnsanumericalvalue,indicatingthestatusofthemostrecenttickinthecurrentbarofthespecifieddataseries.

Avalueof0indicatesthatthetickistheopeningtickofthebar,1indicatesthatthetickiswithinthebar,and2indicatesthatthetickistheclosingtickofthebar.

BarStatus(DataNum)

Where:DataNum-anumericalexpressionspecifyingthedatanumberoftheseries

IfDataNumisnotspecified,avalueforthecurrentdataserieswillbereturned.

Example

BarStatus(1)willreturnavalueof2ifthecurrenttickinthedataserieswiththedatanumber1istheclosingtickofabar

BarType

Returnsanumericalvalue,indicatingtheresolutionunitsofthedataseriesthatthestudyisappliedto.

BarTypeThefollowingvaluesarereturnedforeachtypeofresolutionunits:

0Ticks(Ticks&Contracts)1Intra-Day(Seconds,Minutes,&Hours)2Days3Weeks4Months,Quarters,&Years5Points,Changes,Point&Figure6(Reservedforfutureuse)7(Reservedforfutureuse)8Kagi9(Reservedforfutureuse)10LineBreak11(Reservedforfutureuse)12(Reservedforfutureuse)13Renko256-HeikinAshi

Example

Assignavalue,indicatingtheresolutionunitsofthedataseriesthatthestudyisappliedto,toValue1variable:

Value1=BarType;

BarType_ex

AnextendedversionofBarType.Indicatestheresolutionunitsmorespecifically.

Returnsanumericalvalue,indicatingtheresolutionunitsofthedataseriesthatthestudyisappliedto.

BarType_exThefollowingvaluesarereturnedforeachtypeofresolutionunits:

1Ticks2Minutes3Hours4Days5Weeks6Months7Years8Volume9Seconds10Quarters11Points12Change13Points(Original)14-Point&Figure15-Kagi16-LineBreak17-Renko18-HeikinAshi

Example

Assignavalue,indicatingtheresolutionunitsofthedataseriesthatthestudyisappliedto,toValue1variable:

Value1=BarType_ex;

BigPointValueReturnsanumericalvalue,indicatingthecurrencyvalueofasinglewholeunitpricechangeforthedataseriesthatthestudyisappliedto.

BigPointValue

BigPointValue=PointValue×PriceScale

Example

BigPointValuewillreturn1forGoogle

BigPointValuewillreturn50forE-miniS&P;500

BoxSize

Returnstheprice-basedintervalsettingassociatedwiththespecifiedprice-basedcharttypeanindicatororsignalisappliedto.

ThisvalueissetintheChartTypesectionoftheSettingstabwithintheFormatInstrumentdialogforachart.

BoxSize

Parameters

ChartType ValueReturnedPoint&Figure BoxSizevaluePoint PointvalueRenko BoxSizevalue

Example

Boxsizewillreturnavalueof3forRenkochartwiththeBoxSizeequal3.

Boxsizewillreturnavalueof0forKagiorregularresolutionscharts.

CSameasClose

ConstantusedtodesignatetheCalloptioninstrument.

ThePutoptionscouldbedesignatedbythePutconstant.

Example

ChecksifthesymbolusedforthecalculationisaCalloption.

condition1=OptionType=Call;

Category

Thefollowingvaluesarereturnedforeachcategory:

0Future1FutureOption2Stock3StockOption4Index5CurrencyOption6MutualFund7MoneyMarketFund8IndexOption9Cash10Bond11Spread12Forex14Composite

Example

Assignavalue,indicatingthetypeofsymbolthatthestudyisappliedto,toValue1variable:

Value1=Category;

CloseReturnstheclosingprice.

TherangeofreturnedvaluesislimitedbytheMaxBarsBacksetting.

Example

Plottheclosingpriceofthecurrentbar:

Plot1(Close,"Close");

CurrentBarReturnsthenumberofthecurrentbar.

Eachbar,subsequenttotheinitialnumberofbarsspecifiedbytheMaximumBarsBacksetting,isassignedasequentialnumber;theinitialbarsspecifiedbythesettingarenotnumbered.

Forexample,ifMaximumBarsBackissetto20,the21stbarwillbeassignedanumberof1.

CurrentBar

Example

CurrentBarwillreturnthenumberofthecurrentbar

DSameasDate

DailyLimitRetainedforbackwardcompatibility.

DataUsedtospecifyaparticulardataseriesinamulti-symbolchart;eachdataseriesinamulti-symbolcharthasauniqueDataNumber.

Where:N-theDataNumberofthedataseries

Data(N)

Where:N-anumericalexpressionspecifyingtheDataNumberofthedataseries

Example

HighOfData2willreturnthehighpriceofabarinthedataserieswiththeDataNumberof2

HighOfData(2)willreturnthehighpriceofabarinthedataserieswiththeDataNumberof2

DataCompressionSameasBarType

Returnsanumericalvalueindicatingtheclosingdateofabar.ThedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

Example

Datewillreturnavalueof1071030forOctober30th,2007

Datewillreturnavalueof990402forApril2th,1999

DateTime

TheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.

DateTimeisadouble-precisiondecimalvalue.Itallowsaccessingmillisecondtimestampsofthebar.

DateTime

Example

DateTimewillreturn41422.74for5/28/201308:41:11.813

DateTimebarupdate

ReturnstimeofthelastupdateofthecurrentbarifBarMagnifiermodeison.

IfBarMagnifiermodeisoff,returnsthetimeofthecurrentbar(astheTimeproperty).

datetime_bar_update(data_stream)

Example

BarMagnifiermodeison.Timeanddateofthelastupdateofthecurrentbarare29.04.201310:53:59.154

print(datetime_bar_update:15:8)willreturn41393.45415687.

print(datetimetostring_ms(datetime_bar_update))willreturn"29.04.201310:53:59.154".

DayRetainedforbackwardcompatibility;replacedwithBar.

DaysRetainedforbackwardcompatibility;replacedwithBar.

DownTicksReturnsthetotalnumberofDownticksforthecurrentbarifBuildVolumeOnissettoTickCount.

ReturnsthetotalDownvolumeforthecurrentbarifBuildVolumeOnissettoTradeVolume.

Adowntickisatickwiththepricelowerthentheprecedingtick,anddownvolumeisthevolumetradedondownticks.

WithBuildVolumeOnissettoTickCount:

-thevalueof1willbereturnedfor1-tickcharts-thetotalnumberofDownticksinthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

WithBuildVolumeOnissettoTradeVolume:

-theDownvolumeofthecurrenttickwillbereturnedfor1-tickcharts-thetotalDownvolumeofthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

Pleasenotethatmostdatafeedsprovideonlyalimitedhistoryoftickandvolumedata;storingreal-timefeeddatawillensuretheavailabilityofhistoricaltickandvolumedata.

DownTicks

Example

PlotthenumberofDownticksinthecurrentbar(BuildVolumeOnissettoTickCount):

Plot1(DownTicks,"DownTicks");

PlottheDownvolumeofthecurrentbar(BuildVolumeOnissettoTradeVolume):

Plot1(DownTicks,"DownVolume");

ExpirationDate

Returnsanumericalvalue,indicatingtheexpirationdateofthefinancialinstrumentthestudyisappliedto.ThedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

Forexample,thevaluereturnedforthedateofOctober30th,2008willbe1081030,andforApril2nd,1999willbe990402.

ExpirationDate

Avalidexpirationdatewillbereturnedforfuturesoroptionsonly.

Example

ExpirationDatewillreturnavalueof1081030forOctober30th,2008

ExpirationDatewillreturnavalueof990402forApril2nd,1999

ExpirationDateFromVendor

Returnsanumericalvalue,indicatingtheexpirationdateofthefinancialinstrumentthestudyisappliedto.ThedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

Forexample,thevaluereturnedforthedateofOctober30th,2008willbe1081030,andforApril2nd,1999willbe990402.

ExpirationDateFromVendor

Avalidexpirationdatewillbereturnedforfuturesoroptionsonly.

Example

ExpirationDateFromVendorwillreturnavalueof1081030forOctober30th,2008

ExpirationDateFromVendorwillreturnavalueof990402forApril2nd,1999

GetExchangeNameReturnsastringexpressioncontainingtheexchangenameforthesymbolthatthestudyisappliedto.

GetExchangeName

Example

GetExchangeNamewillreturn"NASD"forGoogle

GetExchangeNamewillreturn"CME"forE-miniS&P;500

GetRTSymbolNameReturnsastringexpressioncontainingthenameofthereal-timesymbolthatthestudyisappliedtoincasethemergingoptionisenabled.IfthemergingoptionisdisabledreturnsthesamevalueastheNameproperty.Incaseofacustomfuturesinstrumentthenameofthelastcontractisreturned.

GetRTSymbolName

Example

GetRTSymbolNamewillreturn"GOOG"forGoogleifthemergingoptionisenabledandGoogleisconfiguredasthereal-timeinstrument.

GetSymbolNameReturnsastringexpressioncontainingthenameofthesymbolthatthestudyisappliedto.

GetSymbolName

Example

GetSymbolNamewillreturn"GOOG"forGoogle

HSameasHigh

HighReturnsthehighprice.

Example

Plotthehighpriceofthecurrentbar:

Plot1(High,"High");

Plotthehighpriceofthepreviousbar:

Plot1(HighOf1BarAgo,"Previousbar'shigh");

Plotthehighpriceoftwobarsago:

Plot1(High[2],"High2Barsago");

ISameasOpenInt

IntervalType

Returnsanumericalvalue,indicatingtheresolutionintervalsofthedataseriesthatthestudyisappliedto.

IntervalType

Thefollowingvaluesarereturnedforeachtypeofresolutionunits:

0-Ticks(Ticks&Contracts)1-Intra-Day(Seconds,Minutes,&Hours)2-Days3-Weeks4-Months,Quarters,Years5-Points,Changes0-4-Point&Figure0-4-Kagi0-4-LineBreak0-Renko

Example

Toassignavalue,indicatingtheresolutionunitsofthedataseriesthestudyisappliedto,toValue1variable:

Value1=IntervalType;

IntervalType_ex

AnextendedversionofIntervalType.

Indicatestheresolutionintervalsmorespecifically.

Returnsanumericalvalue,indicatingtheresolutionintervalsofthedataseriesthatthestudyisappliedto.

IntervalType_ex

Thefollowingvaluesarereturnedforeachtypeofresolutionunits:

1-Ticks2-Minutes3-Hours4-Days5-Weeks6-Months7-Years8-Volume9-Seconds10-Quarters11-Points12-Change13-Points(original)1-7,9,10-Point&Figure1-7,9,10-Kagi1-7,9,10-LineBreak1-Renko

Example

Toassignavalue,indicatingtheresolutionunitsofthedataseriesthestudyisappliedto,toValue1variable:

Value1=IntervalType_ex;

LSameasLow

LowReturnsthelowprice.

Example

Plotthelowpriceofthecurrentbar:

Plot1(Low,"Low");

Plotthelowpriceofthepreviousbar:

Plot1(LowOf1BarAgo,"Previousbar'slow");

Plotthelowpriceoftwobarsago:

Plot1(Low[2],"Low2barsago");

MinMoveReturnsanumericalvalue,indicatingtheminimumfractionalunitpricechangeforthedataseriesthatthestudyisappliedto.

MinMove

Example

MinMovewillreturn1forGoogle

MinMovewillreturn25forE-miniS&P;500

MinMove*PointValuewillreturnthecurrencyvalue,correspondingtotheminimumpricemoveofashareorcontract

NextUsedincombinationwithBartoreferencethenextbar.

NextBar

Example

Buyauser-setnumberofsharesatMarketpriceonopenofnextbar:

BuyNextBarAtMarket;

OSameasOpen

OpenReturnsanumericalvalueindicatingtheopenopenprice.

Example

Plottheopenpriceofthecurrentbar:

Plot1(Open,"Open");

Plottheopenpriceofthepreviousbar:

Plot1(OpenOf1BarAgo,"Previousbar'sopen");

Plottheopenpriceoftwobarsago:

Plot1(Open[2],"Open2barsago");

OpenIntReturnstheopeninterestofthecurrentbarfortime-basedchartswithresolutionsof1dayormore.

Fortickandvolume-basedchartsandfortime-basedchartswithresolutionsof24hoursorless,OpenIntreturns:

-thevolumetradedonDowntickswillbereturnedifBuildVolumeOnissettoTradeVolume-thenumberofDownticksinthecurrentbarwillbereturnedifBuildVolumeOnissettoTickCount

OpenInt

OpenIntissupportedfortime-basedchartswithresolutionsof1dayormore.

Mostdatafeedsprovideonlyalimitedhistoryofvolumeandtickdata;storingreal-timefeeddatawillensuretheavailabilityofhistoricalvolumeandtickdata.

Example

Plottheopeninterestofthecurrentbar:

Plot1(OpenInt,"Openinterest");

Plottheopeninterestofthepreviousbar:

Plot1(OpenIntof1BarAgo,"Previousbar'sopeninterest");

Plottheopeninterestoftwobarsago:

Plot1(OpenInt[2],"Openinterest2barsago");

OptionTypeReturnsthenumericalvalue,indicatingthePutorCallvalueforthedataseriesthatthestudyisappliedto.Iftheinstrumentisnotanoptioncontractthekeywordreturns0.

OptionType

Example

OptionTypewillreturn0forGoogle,sinceitisnotanoptioninstrument

OptionTypewillreturnthevalueofthePutconstantforanyPutoption,andthevalueoftheCallconstantforanyCalloption

PointReturnsadecimalnumericalvalue,equivalenttoasinglefractionalpriceunitforthedataseriesthatthestudyisappliedto.

Point=1/PriceScale

Example

1Pointwillreturn0.01forGoogle

8Pointwillreturn0.08forE-miniS&P;500

8Pointwillreturn0.25forT-BondFutures

PointsSameasPoint

PointValueReturnsanumericalvalue,indicatingthecurrencyvalueofasinglefractionalunitpricechangeforthedataseriesthatthestudyisappliedto.

PointValue

PointValue=BigPointValue/PriceScale

Example

PointValuewillreturn0.01forGoogle

PointValuewillreturn0.50forE-miniS&P;500

PriceScaleReturnsanumericalvalue,indicatingthefractionalunitequivalentofasinglewholeunitpricechangeforthedataseriesthatthestudyisappliedto.

PriceScale

PriceScale=BigPointValue/PointValue

Example

PriceScalewillreturn100forGoogle

PriceScalewillreturn32forT-BondFutures

ConstantusedtodesignatethePutoptioninstrument.

TheCalloptionscouldbedesignatedbytheCallconstant.

Example

ChecksifthesymbolusedforthecalculationisaPutoption.

condition1=OptionType=Put;

RevSize

ReturnstheReversalofaPoint&Figurechart,theReversalofaKagichart,orthenumberofLineBreaksinaLineBreakchart.

ThisvalueissetintheChartTypesectionoftheSettingstabwithintheFormatInstrumentdialogforachart.

Example

RevSizereturns2ifthereversalsizeofaP&F;chartissetto2.

RevSizereturns5ifthenumberoflinebreaksforaLineBreakchartissetto5.

RevSizereturns4ifthereversalsizeofaKagichartissetto4%.

ScrollToBarCentersthechartonthespecifiedbar.

ScrollToBar(intDataN,intBarN)

Where:DataN-dataseriesnumber

BarN-barnumber

Example

ScrollToBar(2,98);

Willcenterthechartonthe98thbaroftheseconddataseries.

SessionLastBar

Returnsalogicalvalueindicatingwhetherthecurrentbaristhelastbarofthesession;returnsavalueofTrueifthecurrentbaristhelastbarofthesession,andavalueofFalseifthecurrentbarisnotthelastbarofthesession.

SessionLastBar

Example

Assignatrue/falsevalue,indicatingwhetherthecurrentbaristhelastbaronthechart,toLastBarvariable:

Variable:LastBar(False);LastBar=SessionLastBar;

StrikeReturnsthenumericalvalue,indicatingthestrikepriceforthedataseriesthatthestudyisappliedto.Iftheinstrumentisnotanoptioncontractthekeywordreturns0.

Strike

Example

Strikewillreturn0forGoogle,sinceitisnotanoptioninstrument

Strikewillreturn65fortheJanuary2012PutoptionforJohnson&Johnson(JNJ)atthestrikepriceis$65(JNJ120121P00065000)

Symbol_Close

Returnstheclosingpriceofthebar.

Symbol_Close

TherangeofreturnedvaluesisnotlimitedbytheMaxBarsBacksetting.Thiskeywordcanreturnthevalueofanybarofthedataseries.

Example

Plottheclosingpriceofthecurrentbar:

Plot1(Symbol_Close,"Close");

Plot1(Symbol_Closeof1BarAgo,"PreviousBar'sClose");

Plot1(Symbol_Close[2],"Close2barsago");

Symbol_CurrentBar

ReturnsanumericalvalueindicatingthenumberofthecurrentbarplusMaximumBarsBacksettingforthestudy.

Symbol_CurrentBar

Eachbar,subsequenttotheinitialnumberofbarsspecifiedbytheMaximumBarsBacksetting,isassignedasequentialnumber;theinitialbarsspecifiedbythesettingarenotnumbered.

Forexample,ifMaximumBarsBackissetto20,the21stbarwillbeassignedanumberof1.

Example

Symbol_CurrentBar

WillreturnthenumberofthecurrentbarplusMaximumBarsBacksettingforthestudy.

Symbol_Date

Returnsanumericalvalueindicatingtheclosingdateofabar.ThedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

Symbol_Date

Example

Symbol_Datewillreturnavalueof1071030forOctober30th,2007

Symbol_Datewillreturnavalueof990402forApril2th,1999

Symbol_DownTicks

ReturnsthetotalnumberofDownticksforthecurrentbarifBuildVolumeOnissettoTickCount.

ReturnsthetotalDownvolumeforthecurrentbarifBuildVolumeOnissettoTradeVolume.

Adowntickisatickwiththepricelowerthantheprecedingtick,anddownvolumeisthevolumetradedondownticks.

-thevalueof1willbereturnedfor1-tickcharts-thetotalnumberofDownticksinthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

-theDownvolumeofthecurrenttickwillbereturnedfor1-tickcharts-thetotalDownvolumeofthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

Symbol_DownTicks

Mostdatafeedsprovideonlyalimitedhistoryoftickandvolumedata;storingreal-timefeeddatawillensuretheavailabilityofhistoricaltickandvolumedataTherangeofreturnedvaluesisnotlimitedbytheMaxBarsBacksetting.Thiskeywordcanreturnthevalueofanybarofthedataseries.

Example

PlotthenumberofDownticksinthecurrentbar(BuildVolumeOnissettoTickCount):

Plot1(Symbol_DownTicks,"DownTicks");

PlottheDownvolumeofthecurrentbar(BuildVolumeOnissettoTradeVolume):

Plot1(Symbol_DownTicks,"DownVolume");

Symbol_High

Returnsthehighpriceofthebar

Symbol_High

Example

Plotthehighpriceofthecurrentbar:

Plot1(Symbol_High,"High");

Plotthehighpriceofthepreviousbar:

Plot1(Symbol_Highof1BarAgo,"PreviousBar'shigh");

Plotthehighpriceoftwobarsago:

Plot1(Symbol_High[2],"High2BarsAgo");

Symbol_Length

Returnsanumericalvalueindicatingtheactualnumberofbarsofadataseriesonchart.

Symbol_Length

Iftheseriesisnotupdatinginreal-time(nonewbarsappear),thekeywordreturnsthesamevalueoneachcalculation.Ifthechartupdatesinreal-timethekeywordreturnsthenumberofbarsavailablebythemomentscriptreferencesthekeyword.Itmeansthatthekeywordpossiblycanreturndifferentvaluesevenduringcalculationwithinthesamebar.

Example

Plot1(Symbol_Length,"Lengthofseries");

Plotsavalueof500ifthenumberofbarsofdataseriesis500andthereisnonewbarsappearPlotsavalueof501ifthenumberofbarsofdataseriesbecomes501becausenewbarappeared

Symbol_Low

Returnsthelowpriceofthebar

Symbol_Low

Example

Plotthelowpriceofthecurrentbar

Plot1(Symbol_Low,"Low");

Plotthelowpriceofthepreviousbar:

Plot1(Symbol_Lowof1BarAgo,"PreviousBar'slow");

Plotthelowpriceoftwobarsago:

Plot1(Symbol_Low[2],"Low2barsago");

Symbol_Open

Returnsanumericalvalueindicatingtheopenpriceofthebar.

Symbol_Open

Example

Plottheopenpriceofthecurrentbar:

Plot1(Symbol_Open,"Open");

Plottheopenpriceofthepreviousbar:

Plot1(Symbol_Openof1BarAgo,"Previousbar'sopen");

Plottheopenpriceoftwobarsago:

Plot1(Symbol_Open[2],"Open2barsago");

Symbol_OpenInt

Returnstheopeninterestofthecurrentbarfortickandvolume-basedcharts,andfortime-basedchartswithresolutionsof24hoursorless:

-thevolumetradedonDowntickswillbereturnedifBuildVolumeOnissettoTradeVolume-thenumberofDownticksinthecurrentbarwillbereturnedifBuildVolumeOnissettoTickCount

OpenIntissupportedfortime-basedchartswithresolutionsof1dayormore.

Symbol_OpenInt

Mostdatafeedsprovideonlyalimitedhistoryofvolumeandtickdata;storingreal-timefeeddatawillensuretheavailabilityofhistoricalvolumeandtickdata.TherangeofreturnedvaluesisnotlimitedbytheMaxBarsBacksetting.Thiskeywordcanreturnthevalueofanybarofthedataseries.

Example

Plottheopeninterestofthecurrentbar:

Plot1(Symbol_OpenInt,"OpenInterest");

Plottheopeninterestofthepreviousbar:

Plot1(Symbol_OpenIntof1BarAgo,"PreviousBar'sOpenInterest");

Plottheopeninterestoftwobarsago:

Plot1(Symbol_OpenInt[2],"OpenInterest2barsago");

Symbol_TickIDThiskeywordcanbeusedtodistinguishbetweenthebarswiththesamedateandtimestamps.

Fortickandvolume-basedchartsreturnsthetickindexwithinasecond.Forresolutionshigherthan1Tickreturnstheindexofthelasttickwithinthebar.

Fortime-basedchartswithresolutionsof1secormorenotsupported.Returns0.

Realtimeticksstoredinthedatabasearebeingassignedthelast31bit-theidentifierofrealtimeaffiliation.InordertogettheSymbol_TickIDvaluewithoutrealtimeidentifieroneneedstocalculatetheremainderfromSymbol_TickIDvaluedivisionby2147483648.

value1=Mod(Symbol_TickID,2147483648);

Symbol_TickID

Example

Plotsthetickindex(TickID)ofthelasttickwithinthecurrentbar:

Plot1(Symbol_TickID,"SymTickID");

Symbol_Ticks

ReturnsthetotalnumberofticksforthecurrentbarifBuildVolumeOnissettoTickCount.

ReturnsthetotalvolumeforthecurrentbarifBuildVolumeOnissettoTradeVolume.

-thevalueof1willbereturnedfor1-tickcharts-thetotalnumberofticksinthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

-thevolumeofthecurrenttickwillbereturnedfor1-tickcharts-thetotalvolumeofthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

Symbol_Ticks

Example

Plotthenumberofticksinthecurrentbar(BuildVolumeOnissettoTickCount):

Plot1(Symbol_Ticks,"Ticks");

Plotthevolumeofthecurrentbar(BuildVolumeOnissettoTradeVolume):

Plot1(Symbol_Ticks,"Volume");

Symbol_Time

Returnsanumericalvalueindicatingtheclosingtimeofthecurrentbar.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

Symbol_Time

Example

Symbol_Timewillreturnavalueof1015for10:15AM

Symbol_Timewillreturnavalueof1545for3:45PM

Symbol_Time_S

Returnsanumericalvalueindicatingtheclosingtime,includingseconds,ofthecurrentbar.

Thetimeisindicatedinthe24-hourHHmmssformat,where130000=1:00:00PM

Symbol_Time_S

Example

Symbol_Time_Swillreturnavalueof101525for10:15:25AM

Symbol_Time_Swillreturnavalueof154500for3:45:00PM

Symbol_UpTicks

ReturnsthetotalnumberofUpticksforthecurrentbarifBuildVolumeOnissettoTickCount.

ReturnsthetotalUpvolumeforthecurrentbarifBuildVolumeOnissettoTradeVolume.

Anuptickisatickwiththepricehigherthentheprecedingtick,andupvolumeisthevolumetradedonupticks.

-thevalueof1willbereturnedfor1-tickcharts-thetotalnumberofUpticksinthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

-theUpvolumeofthecurrenttickwillbereturnedfor1-tickcharts-thetotalUpvolumeofthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

Symbol_UpTicks

Example

PlotthenumberofUpticksinthecurrentbar(BuildVolumeOnissettoTickCount):

Plot1(Symbol_UpTicks,"UpTicks");

PlottheUpvolumeofthecurrentbar(BuildVolumeOnissettoTradeVolume):

Plot1(Symbol_UpTicks,"UpVolume");

Symbol_Volume

Returnsthevolumeofthecurrentbar.

Fortickandvolume-basedcharts,andtime-basedchartswithresolutionsof24hoursorless:

-thevolumetradedonUptickswillbereturnedifBuildVolumeOnissettoTradeVolume-thenumberofUpticksinthecurrentbarwillbereturnedifBuildVolumeOnissettoTickCount

Fortime-basedchartswithresolutionsof1dayormore:

-thetotalvolumetradedwillbereturnedifBuildVolumeOnissettoTradeVolume-thetotalnumberofticksinthecurrentbarwillbereturnedifBuildVolumeOnissettoTickCount

Symbol_Volume

Mostdatafeedsprovideonlyalimitedhistoryofvolumeandtickdata;storingreal-timefeeddatawillensuretheavailabilityofhistoricalvolumeandtickdata.TherangeofreturnedvaluesisnotlimitedbytheMaxBarsBacksetting.Thiskeywordcanreturnthevalueofanybarofthedataseries.

Example

Plotthevolumeofthecurrentbar

Plot1(Symbol_Volume,"Volume");

Plotthevolumeofthepreviousbar:

Plot1(Symbol_Volumeof1BarAgo,"PreviousBar'sVolume");

Plotthevolumeoftwobarsago:

Plot1(Symbol_Volume[2],"Volume2barsago");

TSameasTime

ThisUsedincombinationwithBartoreferencethecurrentbar.

ThisBar

Example

BuyThisBarOnClose;

TickIDThiskeywordcanbeusedtodistinguishbetweenthebarswiththesamedateandtimestamps.

Fortickandvolume-basedchartsreturnsthetickindexwithinasecond.Forresolutionshigherthan1Tickreturnstheindexofthelasttickwithinthebar.

Fortime-basedchartswithresolutionsof1secormorenotsupported.Returns0.

Realtimeticksstoredinthedatabasearebeingassignedthelast31bit-theidentifierofrealtimeaffiliation.InordertogettheTickIDvaluewithoutrealtimeidentifieroneneedstocalculatetheremainderfromTickIDvaluedivisionby2147483648.

value1=Mod(TickID,2147483648);

TickID

Example

Plotsthetickindex(TickID)ofthelasttickwithinthecurrentbar:

Plot1(TickID,"TickID");

TicksReturnsthetotalnumberofticksforthecurrentbarifBuildVolumeOnissettoTickCount.

ReturnsthetotalvolumeforthecurrentbarifBuildVolumeOnissettoTradeVolume.

-thevalueof1willbereturnedfor1-tickcharts-thetotalnumberofticksinthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

-thevolumeofthecurrenttickwillbereturnedfor1-tickcharts-thetotalvolumeofthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

Example

Plotthenumberofticksinthecurrentbar(BuildVolumeOnissettoTickCount):

Plot1(Ticks,"Ticks");

Plotthevolumeofthecurrentbar(BuildVolumeOnissettoTradeVolume):

Plot1(Ticks,"Volume");

Returnsanumericalvalueindicatingtheclosingtimeofthecurrentbar.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

Example

Timewillreturnavalueof1015for10:15AM

Timewillreturnavalueof1545for3:45PM

Time_s

Returnsanumericalvalueindicatingtheclosingtime,includingseconds,ofthecurrentbar.Thetimeisindicatedinthe24-hourHHmmssformat,where130000=1:00:00PM.

Time_s

Example

Time_swillreturnavalueof101525for10:15:25AM

Time_swillreturnavalueof154500for3:45:00PM

TodayRetainedforbackwardcompatibility;replacedwithThisBar

UpTicksReturnsthetotalnumberofUpticksforthecurrentbarifBuildVolumeOnissettoTickCount.

ReturnsthetotalUpvolumeforthecurrentbarifBuildVolumeOnissettoTradeVolume.

Anuptickisatickwiththepricehigherthentheprecedingtick,andupvolumeisthevolumetradedonupticks.

Withbuildvolumeonissettotickcount:

-thevalueof1willbereturnedfor1-tickcharts-thetotalnumberofUpticksinthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

Withbuildvolumeonissettotradevolume:

-theUpvolumeofthecurrenttickwillbereturnedfor1-tickcharts-thetotalUpvolumeofthecurrentbarwillbereturnedformulti-tick,volume,andtime-basedcharts

UpTicks

Example

PlotthenumberofUpticksinthecurrentbar(BuildVolumeOnissettoTick

Count):

Plot1(UpTicks,"UpTicks");

PlottheUpvolumeofthecurrentbar(BuildVolumeOnissettoTradeVolume):

Plot1(UpTicks,"UpVolume");

VSameasVolume

VolumeReturnsthevolumeofthecurrentbar.

Fortickandvolume-basedcharts,andtime-basedchartswithresolutionsof24hoursorless:

-thevolumetradedonUptickswillbereturnedifBuildVolumeOnissettoTradeVolume-thenumberofUpticksinthecurrentbarwillbereturnedifBuildVolumeOnissettoTickCount

Fortime-basedchartswithresolutionsof1dayormore:

-thetotalvolumetradedwillbereturnedifBuildVolumeOnissettoTradeVolume-thetotalnumberofticksinthecurrentbarwillbereturnedifBuildVolumeOnissettoTickCount

Pleasenotethatmostdatafeedsprovideonlyalimitedhistoryofvolumeandtickdata;storingreal-timefeeddatawillensuretheavailabilityofhistoricalvolumeandtickdata.

Volume

Example

Plotthevolumeofthecurrentbar:

Plot1(Volume,"Volume");

Plotthevolumeofthepreviousbar:

Plot1(VolumeOf1BarAgo,"Previousbar'svolume");

Plotthevolumeoftwobarsago:

Plot1(Volume[2],"Volume2barsago");

YesterdayRetainedforbackwardcompatibility.

ComputerDateTime

Returnsadouble-precisiondecimalDateTimevalueindicatingthecomputer'scurrentdateandtime.

ComputerDateTime

Example

ComputerDateTimewillreturnavalueof39448.25000000for6:00AMonJanuary1st,2008

CurrentDate

Returnsanumericalvalueindicatingthecomputer'scurrentdate.ThedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

Forexample,thevaluereturnedforthedateofOctober30th,2008willbe1081030.

CurrentDate

Example

CurrentDatewillreturnavalueof1081030forOctober30th,2008

CurrentTime

Returnsanumericalvalue,indicatingthecomputer'scurrenttime.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

CurrentTime

Example

CurrentTimewillreturnavalueof1015for10:15AM

CurrentTimewillreturnavalueof1545for3:45PM

CurrentTime_s

Returnsanumericalvalueindicatingthecomputer'scurrenttime,includingseconds.Thetimeisindicatedinthe24-hourHHmmssformat,where130000=1:00:00PM.

CurrentTime_s

Example

CurrentTime_swillreturnavalueof101525for10:15:25AM

CurrentTime_swillreturnavalueof154500for3:45:00PM

DateTime2ELTime

ReturnsanumericalvalueindicatingthetimefromthespecifiedDateTimevalue.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

TheintegerportionoftheDateTimevaluespecifiesthenumberofdayssinceJanuary1st,1900,andthefractionalportionoftheDateTimevaluespecifiesthefractionofthedaysincemidnight.

DateTime2ELTime(DateTime)

Where:DateTime-adouble-precisiondecimalDateTimevalue

Example

DateTime2ELTime(39449.65625000)willreturnavalueof1545,indicating3:45PM

DateTime2ELTime_s

Returnsanumericalvalueindicatingthetime,includingseconds,fromthespecifiedDateTimevalue.Thetimeisindicatedinthe24-hourHHmmssformat,where130000=1:00:00PM.

DateTime2ELTime_s(DateTime)

Example

DateTime2ELTime_s(39449.646354167)willreturnavalueof153045,indicating3:30:45PM

DateTimeToString

ReturnsastringexpressioncorrespondingtothespecifiedDateTimevalue.

DateTimeToString(DateTime)

Where:DateTime-adouble-precisiondecimalDateTimevaluetobeconvertedtoastringexpression

TheoutputexampleisinthedefaultUSregionaldateandtimeformat.DateandtimeformatsarecontrolledbytheRegionalOptionssettingsthatcanbeaccessedfromtheControlPaneloftheWindowsXPoperatingsystem.

Example

DateTimeToString(39448.25000000)willreturnthestring"1/1/20086:00:00AM"

DateTimeToString_Ms

Returnsastringvalueindicatingdateandtimeofabarwithmillisecondprecision.

DateTimeToString_Ms(DT)

Where:DTisDateTimevalue.

Example

DateTimeToString_Ms(DateTime)willreturnastringvaluecorrespondingtothetimeandtimeofthecurrentbar

"5/28/201308:41:11.871".

DateToJulian

ReturnsanumericalvaluecorrespondingtotheJulianDateequivalentofthespecifieddate.

ThedateisspecifiedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

JulianDateindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900.

DateToJulian(YYYMMdd)

Where:YYYMMdd-anumericalexpression,specifyingthedateinYYYMMddformat

Example

DateToJulian(1080101)willreturnavalueof39448,correspondingtothespecifieddateofJanuary1st,2008

DateToJulian(990402)willreturnavalueof36252,correspondingtothespecifieddateofApril2nd,1999

DateToString

Returnsastringexpressioncorrespondingtothedate(integer)portionofthespecifiedDateTimevalue.

DateToString(DateTime)

Where:DateTime-adouble-precisiondecimalDateTimevaluetobeconvertedtoastringexpressionrepresentingthedate

TheoutputexampleisinthedefaultUSregionaldateformat.DateformatiscontrolledbytheRegionalOptionssettingsthatcanbeaccessedfromtheControlPaneloftheWindowsXPoperatingsystem.

Example

DateToString(39448.25000000)willreturnthestring"1/1/2008".

DayFromDateTime

ReturnsanumericalvalueindicatingthedayofthemonthforthespecifiedDateTimevalue.

DayFromDateTime(DateTime)

Example

DayFromDateTime(39449.25000000)willreturnavalueof2,indicatingthe2nddayofthemonthofJanuary,2008

DayOfMonth

Returnsanumericalvalue,indicatingthedayofthemonthofthespecifieddate.

ThedateisspecifiedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

DayOfMonth(YYYMMdd)

Example

DayOfMonth(1080101)willreturnavalueof1,indicatingthe1stdayofthemonthofJanuary,2008

DayOfMonth(990605)willreturnavalueof5,indicatingthe5thdayofthemonthofJune,1999

DayOfWeek

Returnsanumericalvalue,indicatingthedayoftheweekcorrespondingtothespecifieddate,where0=Sunday,1=Monday,etc.

TheDateisspecifiedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

DayOfWeek(YYYMMdd)

Example

DayOfWeek(1080101)willreturnavalueof2,indicatingTuesday,forJanuary1st,2008

DayOfWeek(990603)willreturnavalueof4,indicatingThursday,forJune3rd,1999

DayOfWeekFromDateTime

Returnsanumericalvalue,indicatingthedayoftheweekcorrespondingtothespecifiedDateTimevalue,where0=Sunday,1=Monday,etc.

DayOfWeekFromDateTime(DateTime)

Example

DayOfWeekFromDateTime(39448.25000000)willreturnavalueof2,indicatingTuesday,forJanuary1st,2008

ELDateToDateTime

Returnstheintegerportionofadouble-precisiondecimalDateTimevaluecorrespondingtothespecifiedELDate.

ELDateisspecifiedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

ELDateToDateTime(YYYMMdd)

Where:YYYMMdd-anumericalexpression,specifyingthedateinELYYYMMddformat

Example

ELDateToDateTime(1080101)willreturnavalueof39448.00000000,correspondingtothespecifieddateofJanuary1st,2008

ELDateToDateTime(990402)willreturnavalueof36252.00000000,correspondingtothespecifieddateofApril2nd,1999

ELTimeToDateTime

Returnsthefractionalportionofadouble-precisiondecimalDateTimevaluecorrespondingtothespecifiedtime.Thetimeisspecifiedinthe24-hourHHmmformat,where1300=1:00PM.

ELTimeToDateTime(HHmm)

Where:HHmm-anumericalexpressionspecifyingthetime

Example

ELTimeToDateTime(1015)willreturnavalueof0.42708333,correspondingtothespecifiedtimeof10:15AM

ELTimeToDateTime(1545)willreturnavalueof0.65625000,correspondingtothespecifiedtimeof3:45PM

ELTimeToDateTime_s

Returnsthefractionalportionofadouble-precisiondecimalDateTimevaluecorrespondingtothespecifiedtime,includingseconds.Thetimeisspecifiedinthe24-hourHHmmssformat,where130000=1:00:00PM.

ELTimeToDateTime_s(HHmmss)

Where:HHmmss-anumericalexpressionspecifyingthetime

Example

ELTimeToDateTime_s(101525)willreturnavalueof0.427372685,correspondingtothespecifiedtimeof10:15:25AM

ELTimeToDateTime_s(154500)willreturnavalueof0.656250000,correspondingtothespecifiedtimeof3:45:00PM

El_DateStr

Returnsan8-characternumericalstringcorrespondingtothespecifieddate.ThestringisintheyyyyMMddformat,whereyyyyisthefour-digityear,MMisthemonth,andddisthedayofthemonth.

El_DateStr(dd,MM,yyyy)

Where:dd-anumericalexpressionspecifyingthedayofthemonthMM-anumericalexpressionspecifyingthemonthyyyy-afour-digitnumericalexpressionspecifyingtheyear

Example

El_DateStr(02,04,2008)willreturnthestring"20080402",correspondingtothespecifieddateofApril2nd,2008.

El_DateToDateTimeSameastheElDateToDateTime

EL_TimeToDateTimeSameastheElTimeToDateTime

EL_TimeToDateTime_sSameasElTimeToDateTime_s

EncodeDate

Returnstheintegerportionofadouble-precisiondecimalDateTimevaluecorrespondingtothespecifieddate.

EncodeDate(yy,MM,dd)

Where:yy-anumericalexpressionspecifyingthetwo-digityearMM-anumericalexpressionspecifyingthemonthdd-anumericalexpressionspecifyingthedayofthemonth

Example

EncodeDate(08,01,01)willreturnavalueof39448.00000000,correspondingtothespecifieddateofJanuary1st,2008

EncodeTime

Returnsthefractionalportionofadouble-precisiondecimalDateTimevaluecorrespondingtothespecifiedtime.

EncodeTime(HH,mm,ss,mmm)

Where:HH-anumericalexpressionspecifyingthehoursin24-hourformatmm-anumericalexpressionspecifyingtheminutesss-anumericalexpressionspecifyingthesecondsmmm-anumericalexpressionspecifyingthemilliseconds

Example

EncodeTime(16,29,55,500)willreturnavalueof0.6874479167,correspondingtothespecifiedtimeof16:29:55.500

FormatDate

Returnsaformatedstringexpressioncorrespondingtothedate(integer)portionofthespecifiedDateTimevalue.

Theformatofthestringexpression,includingtheabbreviationsandseparators,isdefinedbythespecifiedformatstring.Theformatstringconsistsofoneormoreelementsarrangedinthedesiredorder.Eachelementrepresentsaparticularpartofthedateinaspecificformat.Spacesandseparatorcharacterstobeusedcanbeinsertedwithintheformatstring.

FormatDate("FormatString",DateTime)

Parameters

FormatString-aformatstring,specifyingtheformatoftheoutputstringexpressionrepresentingthedate

Thefollowingelementscanbeusedintheformatstring:

d Dayofmonthasdigitswithnoleadingzeroforsingle-digitdaysdd Dayofmonthasdigitswithleadingzeroforsingle-digitdaysddd Dayofweekasathree-letterabbreviationdddd DayofweekasitsfullnameM Monthasdigitswithnoleadingzeroforsingle-digitmonthsMM Monthasdigitswithleadingzeroforsingle-digitmonthsMMM Monthasathree-letterabbreviationMMMMMonthasitsfullnamey Yearaslasttwodigits,butwithnoleadingzeroforyearslessthan10yy Yearaslasttwodigits,butwithleadingzeroforyearslessthan10

yyyy Yearrepresentedbyfullfourdigits

DateTime-adouble-precisiondecimalDateTimevaluetobeconvertedtoastring

expressionrepresentingthedate

Example

FormatDate("dddd,MMMMdd,yyyy.",39469.250)willreturnthestring"Tuesday,January22,2008."

FormatDate("M/d/y",39469.250)willreturnthestring"1/22/8"

FormatDate("dd-MM-yy",39469.250)willreturnthestring"22-01-08"

FormatDate("Nextdddis:MMMdd",39469.250)willreturnthestring"NextTueis:Jan22"

FormatTime

Returnsaformatedstringexpressioncorrespondingtothetime(fractional)portionofthespecifiedDateTimevalue.

Theformatofthestringexpression,includingseparators,isdefinedbythespecifiedformatstring.Theformatstringconsistsofoneormoreelementsarrangedinthedesiredorder.Eachelementrepresentsaparticularunitoftimeinaspecificformat.Spacesandseparatorcharacterstobeusedcanbeinsertedwithintheformatstring.

FormatTime("FormatString",DateTime)

Parameters

FormatString-aformatstring,specifyingtheformatoftheoutputstringexpressionrepresentingthetime

h Hoursin12-hourAM/PMformatwithnoleadingzeroforsingle-digithourshh Hoursin12-hourAM/PMformatwithleadingzeroforsingle-digithoursH Hoursin24-hourformatwithnoleadingzeroforsingle-digithoursHH Hoursin24-hourformatwithleadingzeroforsingle-digithoursm Minuteswithnoleadingzeroforsingle-digitminutesmmMinuteswithleadingzeroforsingle-digitminutess Secondswithnoleadingzeroforsingle-digitsecondsss Secondswithleadingzeroforsingle-digitsecondst OnecharacterAM/PMdesignatortt MulticharacterAM/PMdesignator

DateTime-adouble-precisiondecimalDateTimevaluetobeconvertedtoastringexpressionrepresentingthetime

Example

FormatTime("hh:mm:sst",39469.6674)willreturnthestring"04:01:03P"

FormatTime("htt",39469.6674)willreturnthestring"4PM"

FormatTime("HH:mm",39469.6674)willreturnthestring"16:01"

FormatTime("mMINsSEC",39469.6674)willreturnthestring"1MIN3SEC"

Friday

Returnsanumericalvalueof5,correspondingtoFriday.

Friday

Example

Fridaywillreturnavalueof5

HoursFromDateTime

ReturnsanumericalvalueindicatingthehoursfromthespecifiedDateTimevalue.Thehoursareindicatedinthe24-hourformat,where13=1PM.

HoursFromDateTime(DateTime)

Example

HoursFromDateTime(39449.85000000)willreturnavalueof20,indicating8PM

IncMonth

ReturnsanumericalvaluecorrespondingtoaJuliandatethatisafterorbeforethespecifiedJuliandatebyaspecifiednumberofcalendarmonths.

IncMonth(JulianDate,M)

Where:JulianDate-anumericalexpressionspecifyingtheJulianDateM-anumericalexpressionspecifyingthenumberofcalendarmonthsfromthespecifiedJuliandate;ifthevalueofMis;positive,adateafterthespecifieddatewillbereturned;ifthevalueofMis;negative,adatebeforethespecifieddatewillbereturned

Example

IncMonth(39417,1)willreturnavalueof39448,correspondingtoJanuary1st,2008,onecalendarmonthafterthespecifieddateofDecember1st,2007

IncMonth(36252,-2)willreturnavalueof36193,correspondingtoFebruary2nd,1999,twocalendarmonthsbeforethespecifieddateofApril2nd,1999

JulianToDate

ReturnsanumericalvaluecorrespondingtotheELDateequivalentofthespecifiedJulianDate.

ELDateisintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

JulianToDate(JulianDate)

Where:JulianDate-anumericalexpressionspecifyingtheJulianDate

Example

JulianToDate(39448)willreturnavalueof1080101,correspondingtothespecifieddateofJanuary1st,2008

JulianToDate(36252)willreturnavalueof990402,correspondingtothespecifieddateofApril2nd,1999

LastCalcDateTime

ReturnsanumericalvalueindicatingtheclosingDateTimeofthelastcompletedbar.

LastCalcDateTime

Example

LastCalcDateTimewillreturnavalueof41871.83333forthelastbarcompletionat08/20/20148:00PM

LastCalcJDate

ReturnsanumericalvalueindicatingtheJuliandateforthelastcompletedbar.

LastCalcJDate

Example

LastCalcJDatewillreturnavalueof39448forthelastbarcompletiondateofJanuary1st,2008

LastCalcMMTime

Returnsanumericalvalueindicatingtheclosingtimeofthelastcompletedbar.Thetimeisindicatedasthenumberofminutesthathavepassedsincemidnight.

LastCalcMMTime

Example

LastCalcMMTimewillreturnavalueof850forthelastbarcompletiontimeof2:10PM

LastCalcmSTime

Returnsanumericalvalueindicatingtheclosingtimeofthelastcompletedbar.Thetimeisindicatedasthenumberofmillisecondsthathavepassedsincemidnight.

LastCalcmSTime

Example

LastCalcmSTimewillreturnavalueof51030150forthelastbarcompletiontimeof2:10:30.150PM

LastCalcSSTime

Returnsanumericalvalueindicatingtheclosingtimeofthelastcompletedbar.Thetimeisindicatedasthenumberofsecondsthathavepassedsincemidnight.

LastCalcSSTime

Example

LastCalcSSTimewillreturnavalueof51030forthelastbarcompletiontimeof2:10:30PM

MilliSecondsFromDateTime

ReturnsanumericalexpressionindicatingthemillisecondstampofDateTimevalue.

MilliSecondsFromDateTime(DT)

Where:DT-isaDateTimevalue.

Example

MillisecondsFromDateTime(DateTtime)willreturn687.00ifthetimestampofthecurrentbaris11:57:07.687

MinutesFromDateTime

ReturnsanumericalvalueindicatingtheminutesfromthespecifiedDateTimevalue.

MinutesFromDateTime(DateTime)

Example

MinutesFromDateTime(39449.35000000)willreturnavalueof24,indicating24minutesafter8AM

Monday

Returnsanumericalvalueof1,correspondingtoMonday.

Monday

Example

Mondaywillreturnavalueof1

Returnsanumericalvalue,indicatingthemonthofthespecifiedELDate.

Month(YYYMMdd)

Example

Month(1080101)willreturnavalueof1,indicatingthemonthofJanuary

Month(990605)willreturnavalueof6,indicatingthemonthofJune

MonthFromDateTime

ReturnsanumericalvalueindicatingthemonthforthespecifiedDateTimevalue.

MonthFromDateTime(DateTime)

Example

MonthFromDateTime(39600.25000000)willreturnavalueof6,indicatingthemonthofJune

Saturday

Returnsanumericalvalueof6,correspondingtoSaturday.

Saturday

Example

Saturdaywillreturnavalueof6

SecondsFromDateTime

ReturnsanumericalvalueindicatingthesecondsfromthespecifiedDateTimevalue.

SecondsFromDateTime(DateTime)

Example

SecondsFromDateTime(39449.35440000)willreturnavalueof20,indicating20secondsfrom8:30:20AM

StringToDate

Returnstheintegerportionofadouble-precisiondecimalDateTimevalue,correspondingtothespecifieddate.Thedateisspecifiedbyastringexpression"MM/dd/yy"*or"MM/dd/yyyy"*,whereMM*isthemonth,dd*istheday,andyyoryyyyisatwo-digitorfour-digityear.

StringToDate("MM/dd/yy")

StringToDate("MM/dd/yyyy")

Where:MM-month*dd-dayofthemonth*yy-atwo-digityearyyyy-afour-digityear

*DescribedusageandexamplesareforthedefaultUSregionaldateformat.IfthedefaultUKregionalformatisselected,thedateswillbeindd/MM/yyanddd/MM/yyyyformatinstead.DateformatiscontrolledbytheRegionalOptionssettingsthatcanbeaccessedfromtheControlPaneloftheWindowsXPoperatingsystem.

Example

StringToDate("01/01/2008")willreturnavalueof39448.00000000,correspondingtothespecifieddateofJanuary1st,2008

StringToDate("04/04/99")willreturnavalueof36254.00000000,correspondingtothespecifieddateofApril4th,1999

StringToDateTime

Returnsadouble-precisiondecimalDateTimevaluecorrespondingtothespecifieddateandtime.Thedateandtimearespecifiedbyastringexpression"MM/dd/yyhh:mm:sstt"*or"MM/dd/yyyyhh:mm:sstt"*,whereMM*isthemonth,dd*istheday,yyoryyyyisatwo-digitorfour-digityear,hhisthehoursin12-hourAM/PMformat,mmistheminutes,ssistheseconds,andttistheAM/PMdesignator.

StringToDateTime("MM/dd/yyhh:mm:sstt")

StringToDateTime("MM/dd/yyyyhh:mm:sstt")

Where:MM-month*dd-dayofthemonth*yy-atwo-digityearyyyy-afour-digityearhh-hoursmm-minutesss-secondstt-AM/PMdesignator

*DescribedusageandexamplesareforthedefaultUSregionaldateandtimeformats.IfthedefaultUKregionalformatisselected,thedateswillbeindd/MM/yyanddd/MM/yyyyformatinstead.DateandtimeformatsarecontrolledbytheRegionalOptionssettingsthatcanbeaccessedfromtheControlPaneloftheWindowsXPoperatingsystem.

Example

StringToDateTime("01/01/200808:00:00AM")willreturnavalueof39448.33333333,correspondingto08:00:00AMonJanuary1st,2008

StringToDateTime("04/04/9904:48:00PM")willreturnavalueof36254.70000000,correspondingto04:48:00PMonApril4th,1999

StringToDTFormatted

ReturnstheDateTimevalueforthestringinaparticularformat.Theformatofthestringexpression,includingtheabbreviationsandseparators,isdefinedbythespecifiedformatstring.Theformatstringconsistsofoneormoreelementsarrangedinthedesiredorder.Eachelementrepresentsaparticularpartofthedateinaspecificformat.Spacesandseparatorcharacterstobeusedcanbeinsertedwithintheformatstring.

StringToDTFormatted("DateTimeString","FormatString")

Parameters

DateTimeString-timeanddatevalueinstringformat.

FormatString-aformatstring,specifyingtheformatoftheoutputstringexpressionrepresentingthedateandtime.

d-dayofmonthasdigitswithnoleadingzeroforsingle-digitdaysdd-dayofmonthasdigitswithleadingzeroforsingle-digitdaysddd-dayofweekasathree-letterabbreviationdddd-dayofweekasitsfullnameM-monthasdigitswithnoleadingzeroforsingle-digitmonthsMM-onthasdigitswithleadingzeroforsingle-digitmonthsMMM-monthasathree-letterabbreviationMMMM-monthasitsfullnamey-yearaslasttwodigits,butwithnoleadingzeroforyearslessthan10yy-yearaslasttwodigits,butwithleadingzeroforyearslessthan10yyyy-yearrepresentedbyfullfourdigitsh-hoursin12-hourAM/PMformatwithnoleadingzeroforsingle-digithourshh-hoursin12-hourAM/PMformatwithleadingzeroforsingle-digithoursH-hoursin24-hourformatwithnoleadingzeroforsingle-digithours

HH-hoursin24-hourformatwithleadingzeroforsingle-digithoursm-minuteswithnoleadingzeroforsingle-digitminutesmm-minuteswithleadingzeroforsingle-digitminutess-secondswithnoleadingzeroforsingle-digitsecondsss-secondswithleadingzeroforsingle-digitsecondst-onecharacterAM/PMdesignatortt-multicharacterAM/PMdesignator

Returnvalue

DateTime-adouble-precisiondecimalDateTimevalue,correspondingtothefirststringparameterwithasecondstringparameterformatappliedtoit.

Attention!Checkifthereturnedvalueiscorrect!Ifconversionfails,thefunctionreturns-1.

Example

StringToDTFormatted("22/11/201315:35","dd/MM/yyyHH:mm")willreturn41600.649305555555,whichrepresentsNovember22nd2013,3:35PM.

StringToDTFormatted("02/17/11","MM/dd/yy")willreturn40591,whichrepresentsFebruary17th2011.

StringToDTFormatted("17/02/11","MM/dd/yy")willreturn-1,stringconversiontoDateTimeformatfailed.

StringToDTFormatted("4:00PM","h:mmtt")willreturn2.666666666666667,whichrepresentstheminimumvalueofJulianDate=January1st1900,4:00PM.

StringToTime

Returnsthefractionalportionofadouble-precisiondecimalDateTimevalue,correspondingtothespecifiedtime.

Thetimeisspecifiedbyastringexpression"hh:mm:sstt",wherehhisthehoursinthe12-hourAM/PMformat,mmistheminutes,ssistheseconds,andttistheAM/PMdesignator.

StringToTime("hh:mm:sstt")

Where:hh-hoursinthe12-hourAM/PMformatmm-minutesss-secondstt-AM/PMdesignator

DescribedusageandexamplesareforthedefaultUSregionaltimeformat.TimeformatiscontrolledbytheRegionalOptionssettingsthatcanbeaccessedfromtheControlPaneloftheWindowsXPoperatingsystem.

Example

StringToTime("08:00:00AM")willreturnavalueof0.33333333

StringToTime("04:48:00PM")willreturnavalueof0.70000000

Sunday

Returnsanumericalvalueof0,correspondingtoSunday.

Sunday

Example

Sundaywillreturnavalueof0

Thursday

Returnsanumericalvalueof4,correspondingtoThursday.

Thursday

Example

Thursdaywillreturnavalueof4

Time2Time_s

ReturnsanumericalvalueindicatingthetimeintheHHmmssformat,correspondingtothespecifiedtimeintheHHmmformat.

Thetimeisreturnedinthe24-hourHHmmssformat,where130000=1:00:00PM,andspecifiedinthe24-hourHHmmformat,where1300=1:00PM.

Time2Time_s(HHmm)

Where:HHmm-anumericalexpressionspecifyingthetime

Example

Time2Time_s(1015)willreturnavalueof101500

Time2Time_s(1545)willreturnavalueof154500

TimeToString

Returnsastringexpressioncorrespondingtothetime(fractional)portionofthespecifiedDateTimevalue.

TimeToString(DateTime)

Where:DateTime-adouble-precisiondecimalDateTimevaluetobeconvertedtoastringexpressionrepresentingthetime

TheoutputexampleisinthedefaultUSregionaltimeformat.TimeformatiscontrolledbytheRegionalOptionssettingsthatcanbeaccessedfromtheControlPaneloftheWindowsXPoperatingsystem.

Example

TimeToString(39448.75000000)willreturnthestring"6:00PM"

Time_s2Time

ReturnsanumericalvalueindicatingthetimeintheHHmmformat,correspondingtothespecifiedtimeintheHHmmssformat;thesecondsaretruncated.

Thetimeisreturnedinthe24-hourHHmmformat,where1300=1:00PM,andspecifiedinthe24-hourHHmmssformat,where130000=1:00:00PM.

Time_s2Time(HHmmss)

Where:HHmmss-anumericalexpressionspecifyingthetime

Example

Time_s2Time(101520)willreturnavalueof1015

Time_s2Time(154548)willreturnavalueof1545

Tuesday

Returnsanumericalvalueof2,correspondingtoTuesday.

Tuesday

Example

Tuesdaywillreturnavalueof2

Wednesday

Returnsanumericalvalueof3,correspondingtoWednesday.

Wednesday

Example

Wednesdaywillreturnavalueof3

Returnsanumericalvalue,indicatingtheyearofthespecifiedELDate.

Year(YYYMMdd)

Example

Year(1080101)willreturnavalueof108,indicatingtheyearof2008

Year(990605)willreturnavalueof99,indicatingtheyearof1999

YearFromDateTime

ReturnsanumericalvalueindicatingtheyearforthespecifiedDateTimevalue.

YearFromDateTime(DateTime)

Example

YearFromDateTime(39449.25000000)willreturnavalueof2008,indicatingtheyearof2008

ArrayDeclaresoneormorenamesasarrays,containingmultiplevariabledataelements;specifiesthearraystructure,dataelementstypeandinitialvalue,updatebasis,anddatanumber,foreachofthearrays.

Dataelementstypecanbenumerical,string,ortrue/false.

Thenumberofelementsinanarraycanbefixedordynamic(unlimited).

Inarrayswithafixednumberofelements,theelementscanbearrangedinsingleormultipledimensions.Aone-dimensional10-elementarraycontains10elements,atwo-dimensional10-elementby10-elementarraycontains100elements,athree-dimensional10by10by10elementarraycontains1000elements,afour-dimensional10by10by10by10elementarraycontains10000elements,etc.ThemaximumnumberofarraydimensionsinPowerLanguageis9.

Eachelementinanarrayisreferencedbyoneormoreindexnumbers,oneforeachofthedimensions.Indexingstartsat0foreachofthedimensions.

Dynamicarrays(arrayswithanunlimitednumberofelements)areone-dimensional,andareinitializedatdeclarationashavingonlyoneelement.DeclareddynamicarrayscanberesizedusingArray_SetMaxIndex.

Elementscanbemanipulatedindividuallyorasagroup,inallorpartofanarray.

Array:<IntraBarPersist>ArrayName1[D1,D2,D3,etc.](InitialValue1<,DataN>),<IntraBarPersist>ArrayName2[D1,D2,D3,etc.](InitialValue2<,DataN>),etc.

Parametersinsidetheangledbracketsareoptional

Parameters

IntraBarPersist-anoptionalparameter;specifiesthatthevalueofthearrayelementsistobeupdatedoneverytickIfthisparameterisnotspecified,thevaluewillbeupdatedatthecloseofeachbar.

ArrayName-anexpressionspecifyingthearrayname

Thenamecanconsistofletters,underscorecharacters,numbers,andperiods.Thenamecannotbeginwithanumberoraperiodandisnotcase-sensitive.

D-anumericalexpressionspecifyingthearraysizeinelements,startingat0,foreachofthedimensions;asingleexpressionspecifiesaone-dimensionalarray,twoexpressionsspecifyatwo-dimensional(D1byD2)array,threeexpressionsspecifyathree-dimensional(D1byD2byD3)array,etc.Adynamicarray,withanunlimitednumberofelements,isspecifiedbytheemptysquarebrackets:[]andwillbeaone-dimensionalarray.

InitialValue-anexpression,specifyingtheinitialvalueanddefiningthedatatypeforalloftheelementsinthearrayThevaluecanbeanumerical,string,ortrue/falseexpression;thetypeoftheexpressiondefinesthedatatype.

DataN-anoptionalparameter;specifiestheDataNumberofthedataseriesthearrayistobetiedtoIfthisparameterisnotspecified,thearraywillbetiedtothedefaultdataseries.

Example

DeclareLengthandSFactoras9-elementone-dimensionalnumericalarrayswithdataelements'initialvaluesof0:

Array:Length[8](0),SFactor[8](0);

DeclareMax_Priceasa24-elementby60-elementtwo-dimensionalnumericalarray,updatedoneverytick,tiedtotheserieswithData#2,andwithdataelements'initialvaluesequaltothevalueofClosefunction:

Array:IntraBarPersistMax_Price[23,59](Close,Data2);

DeclareHighs2asadynamicnumericalarraywithdataelements'initialvaluesof0:

Array:Highs2[](0);

ArraysSameastheArray

InputDeclaresoneormorenamesasinputs;specifiesthedefaultvalueanddefinestheinputtypeforeachinput.

Inputscanbenumerical,string,ortrue/false.Oncedeclared,thevalueoftheinputcannotbemodifiedbythestudy'scode.

Input:InputName1(DefaultValue1),InputName2(DefaultValue2),etc.

Parameters

InputName-anexpressionspecifyingtheinputname

Thenamecanconsistofletters,underscorecharacters,numbers,andperiods.Thenamecannotbeginwithanumberoraperiodandisnotcase-sensitive.

DefaultValue-anexpressionspecifyingthedefaultvalueanddefiningtheinputtype

Theexpressioncanbenumerical,string,ortrue/false;thetypeoftheexpressiondefinestheinputtype.

Example

DeclareLengthasanumericalinputwiththedefaultvalueof20:

Input:Length(20);

DeclarePriceasanumericalinputwiththedefaultvalueequaltothevalueofClosefunction,andNameasacharacterstringinputwiththedefaultvalueof"LastClose":

Input:Price(Close),Name("LastClose");

DeclareDraw_Lineasatrue/falseinputwiththedefaultvalueofTrue:

Input:Draw_Line(True);

InputsSameastheInput

IntraBarPersistUsedinvariableandarraydeclarationstatements,beforeavariableorarrayname,tospecifythatthevalueofthevariableorarrayelementsaretobeupdatedoneverytick.

IfIntraBarPersistisnotspecified,thevaluewillbeupdatedatthecloseofeachbar.

Declaration:[IntraBarPersist]Name(InitialValue1)

Example

DeclareMaxasanumericalvariable,updatedoneverytick,withtheinitialvalueof100:

Variable:IntraBarPersistMax(100);

DeclareMax_Priceasa24-elementsingle-dimensionnumericalarray,updatedoneverytick,andwithdataelements'initialvaluesof0:

Array:IntraBarPersistMax_Price[23](0);

NumericUsedinfunctioninputdeclarationstatementstodefineaninputasNumerical.

InputdefinedasNumericalcanbeusedbothasaNumericalSimpleaswellasaNumericalSeriesinput;thevalueofaSimpleinputisconstantfrombartobarandthushasnohistory,whilethevalueofaSeriesinputmayvaryfrombartobarandcanbereferencedhistorically.

Input:InputName(Numeric)

Where:InputName-anexpressionspecifyingtheinputname

Thenamecanconsistofletters,underscorecharacters,numbers,andperiods.

Thenamecannotbeginwithanumberoraperiodandisnotcase-sensitive.

Example

DeclareLengthasaNumericalfunctioninput:

Input:Length(Numeric);

NumericArrayUsedinfunctioninputdeclarationstatementstodefineaninputasaNumericalArraywithaspecifiednumberofdimensions.

InputdefinedasNumericalcanbeusedbothasaNumericalSimpleaswellasaNumericalSeriesinput;thevalueofaSimpleinputisconstantfrombartobarandthushasnohistory,whilethevalueofaSeriesinputmayvaryfrombartobarandcanbereferencedhistorically.

Input:InputName[M1,M2,M3,etc.](NumericArray)

Parameters

M-aninputvariablethatrepresentsthemaximumindexvalueforeachdimensionofthearraypassedtothefunction;asingleinputvariablespecifiesaone-dimensionalarrayinput,twoinputvariablesspecifyatwo-dimensional(M1byM2)arrayinput,threeinputvariablesspecifyathree-dimensional(M1byM2byM3)arrayinput,etc.

Aninputwillonlyacceptanarraywiththespecifiednumberofdimensions.

Example

DeclareLengthasaone-dimensionalNumericalArrayfunctioninput:

Input:Length[X](NumericArray);

ThemaximumindexvalueforthearraypassedtothefunctionwillbeassignedtoinputvariableX.

DeclareTableasathree-dimensionalNumericalArrayfunctioninput:

Input:Table[X,Y,Z](NumericArray);

ThemaximumindexvalueforeachdimensionofthearraypassedtothefunctionwillbeassignedtoinputvariablesX,Y,andZ.

NumericArrayRefUsedinfunctioninputdeclarationstatementstodefineaninputasPassedbyReferenceNumericalArraywithaspecifiednumberofdimensions.

DeclaringaninputasPassedbyReferenceenablesthefunctiontomodifythevaluesofvariablespassedastheinput.

Input:InputName[M1,M2,M3,etc.](NumericArrayRef)

Parameters

Example

DeclareCountasaPassedbyReferenceone-dimensionalNumericalArrayfunctioninput:

Input:Count[X](NumericArrayRef);

DeclareTableasaPassedbyReferencethree-dimensionalNumericalArray

functioninput:

Input:Table[X,Y,Z](NumericArrayRef);

NumericRefUsedinfunctioninputdeclarationstatementstodeclareaPassedbyReferenceNumericalinput.

Input:InputName(NumericRef)

Example

DeclareBarCountasaPassedbyReferenceNumericalfunctioninput:

Input:BarCount(NumericRef);

NumericSeriesUsedinfunctioninputdeclarationstatementstodefineaninputasaNumericalSeries.

ThevalueofaninputdefinedasaSeriesmayvaryfrombartobarandcanbereferencedhistorically.

Input:InputName(NumericSeries)

Example

DeclarePriceasaNumericalSeriesfunctioninput:

Input:Price(NumericSeries);

NumericSimpleUsedinfunctioninputdeclarationstatementstodefineaninputasNumericalSimple.

ThevalueofaninputdefinedasSimpleisconstantfrombartobarandthushasnohistory.

Input:InputName(NumericSimple)

Example

DeclareLengthasaNumericalSimplefunctioninput:

Input:Length(NumericSimple);

RecalcPersistUsedinvariabledeclarationstatements,beforeavariablename,tospecifythatthevalueofthevariableistobeupdatedoneverytickandthelatestvalueofthisvariableistobesavedafterthestudyrecalculation.

Declaration:[RecalcPersist]Name(InitialValue1)

Thiskeywordcanbeusedonlywithvariables.Thevariablewithsuchanattributecannotbeserialtype.

Example

DeclareMaxasanumericalvalue,updatedoneverytick,withinitialvalueof100.

Afterstudyrecalculation,thelatestvalueofMaxwillbesaved:

Variable:RecalcPersistMax(100);

StringUsedinfunctioninputdeclarationstatementstodefineaninputasString.

InputdefinedasStringcanbeusedbothasaStringSimpleaswellasaStringSeriesinput;thevalueofaSimpleinputisconstantfrombartobarandthushasnohistory,whilethevalueofaSeriesinputmayvaryfrombartobarandcanbereferencedhistorically.

Input:InputName(String)

Example

DeclareNameasaStringfunctioninput:

Input:Name(String);

StringArrayUsedinfunctioninputdeclarationstatementstodefineaninputasaStringArraywithaspecifiednumberofdimensions.

InputdefinedasStringcanbeusedbothasaStringSimpleaswellasaStringSeriesinput;thevalueofaSimpleinputisconstantfrombartobarandthushasnohistory,whilethevalueofaSeriesinputmayvaryfrombartobarandcanbereferencedhistorically.

Input:InputName[M1,M2,M3,etc.](StringArray)

Parameters

Example

DeclareMessagesasaone-dimensionalStringArrayfunctioninput:

Input:Messages[X](StringArray);

DeclareMessageTableasathree-dimensionalStringArrayfunctioninput:

Input:MessageTable[X,Y,Z](StringArray);

StringArrayRefUsedinfunctioninputdeclarationstatementstodefineaninputasPassedbyReferenceStringArraywithaspecifiednumberofdimensions.

Input:InputName[M1,M2,M3,etc.](StringArrayRef)

Parameters

Example

DeclareMessagesasaPassedbyReferenceone-dimensionalStringArrayfunctioninput:

Input:Messages[X](StringArrayRef);

DeclareCommentsTableasaPassedbyReferencethree-dimensionalStringArray

functioninput:

Input:CommentsTable[X,Y,Z](StringArrayRef);

StringRefUsedinfunctioninputdeclarationstatementstodeclareaPassedbyReferenceStringinput.

Input:InputName(StringRef)

Example

DeclareMessageasaPassedbyReferenceStringfunctioninput:

Input:Message(StringRef);

StringSeriesUsedinfunctioninputdeclarationstatementstodefineaninputasStringSeries.

ThevalueofaninputdefinedasaSeriesmayvaryfrombartobarandcanbereferredtohistorically.

Input:InputName(StringSeries)

Example

DeclareMessagesasaStringSeriesfunctioninput:

Input:Messages(StringSeries);

StringSimpleUsedinfunctioninputdeclarationstatementstodefineaninputasStringSimple.

Input:InputName(StringSimple)

Example

DeclareNameasaStringSimplefunctioninput:

Input:Name(StringSimple);

TrueFalseUsedinfunctioninputdeclarationstatementstodefineaninputastrue/false.

Inputdefinedastrue/falsecanbeusedbothasatrue/falseSimpleaswellasatrue/falseSeriesinput;thevalueofaSimpleinputisconstantfrombartobarandthushasnohistory,whilethevalueofaSeriesinputmayvaryfrombartobarandcanbereferencedhistorically.

Input:InputName(TrueFalse)

Example

DeclareOvernightasatrue/falsefunctioninput:

Input:Overnight(TrueFalse);

TrueFalseArrayUsedinfunctioninputdeclarationstatementstodefineaninputasatrue/falseArraywithaspecifiednumberofdimensions.

Inputdefinedastrue/falsecanbeusedbothasatrue/falseSimpleaswellasatrue/falseSeriesinput;thevalueofaSimpleinputisconstantfrombartobarandthushasnohistory,whilethevalueofaSeriesinputmayvaryfrombartobarandcanbereferencedhistorically.

Input:InputName[M1,M2,M3,etc.](TrueFalseArray)

Parameters

Example

DeclareUpTrendasaone-dimensionaltrue/falseArrayfunctioninput:

Input:UpTrend[X](TrueFalseArray);

DeclareFlagTableasathree-dimensionaltrue/falseArrayfunctioninput:

Input:FlagTable[X,Y,Z](TrueFalseArray);

TrueFalseArrayRefUsedinfunctioninputdeclarationstatementstodefineaninputasPassedbyReferencetrue/falseArraywithaspecifiednumberofdimensions.

Input:InputName[M1,M2,M3,etc.](TrueFalseArrayRef)

Parameters

Example

DeclareTrendasaPassedbyReferenceone-dimensionaltrue/falseArrayfunctioninput:

Input:Trend[X](TrueFalseArrayRef);

DeclareTrendTableasaPassedbyReferencethree-dimensionaltrue/falseArray

functioninput:

Input:TrendTable[X,Y,Z](TrueFalseArrayRef);

TrueFalseRefUsedinfunctioninputdeclarationstatementstodeclareaPassedbyReferencetrue/falseinput.

Input:InputName(TrueFalseRef)

Example

DeclareFlagasaPassedbyReferencetrue/falsefunctioninput:

Input:Flag(TrueFalseRef);

TrueFalseSeriesUsedinfunctioninputdeclarationstatementstodefineaninputasatrue/falseSeries.

ThevalueofaninputdefinedasaSeriesmayvaryfrombartobarandcanbereferencedhistorically.

Input:InputName(TrueFalseSeries)

Example

DeclareUpTrendasatrue/falseSeriesfunctioninput:

Input:UpTrend(TrueFalseSeries);

TrueFalseSimpleUsedinfunctioninputdeclarationstatementstodefineaninputastrue/falseSimple.

Input:InputName(TrueFalseSimple)

Example

DeclareOvernightasatrue/falseSimplefunctioninput:

Input:Overnight(TrueFalseSimple);

VarSameastheVariable

VariableDeclaresoneormorenamesasvariables;specifiestheinitialvalue,variabletype,updatebasis,anddatanumberforeachvariable.

Variablescanbenumerical,string,ortrue/false.

Variable:[IntraBarPersist]VariableName1(InitialValue1[,DataN]),[IntraBarPersist]VariableName2(InitialValue2[,DataN]),etc.

Parametersinsidethesquarebracketsareoptional

Parameters

IntraBarPersist-anoptionalparameter;specifiesthatthevalueofthevariableistobeupdatedoneverytickIfthisparameterisnotspecified,thevaluewillbeupdatedatthecloseofeachbar.

VariableName-anexpression,specifyingthevariablenameThenamecanconsistofletters,underscorecharacters,numbers,andperiods.

InitialValue-anexpression,specifyingtheinitialvalueanddefiningthevariabletypeThevaluecanbeanumerical,string,ortrue/falseexpression;thetypeoftheexpressiondefinesthevariabletype.

DataN-anoptionalparameter;specifiestheDataNumberofthedataseriesthevariableistobetiedtoIfthisparameterisnotspecified,thevariablewillbetiedtothedefaultdataseries.

Example

DeclareAvg.asanumericalvariablewiththeinitialvalueof20:

Variable:Avg.(20);

DeclareMaxasanumericalvariable,updatedoneverytick,withtheinitialvalueof100:

Variable:IntraBarPersistMax(100);

DeclareMin_Priceasanumericalvariable,tiedtotheserieswithData#2,andtheinitialvalueequaltothevalueofClosefunction:

Variable:Min_Price(Close,Data2);

DeclareOvernightasatrue/falsevariablewiththeinitialvalueofFalse,andNameasastringvariablewiththeinitialvalueof"Intra-Day":

Variable:Overnight(False),Name("Intra-Day");

VariablesSameastheVariable

VarsSameastheVariable

ArraySizeSupportedbyPowerLanguage.

AdetaileddescriptionandusageexampleshavebeenpublishedbyTradeStationTechnologies:EasyLanguageExtensionSDK

ArrayStartAddrSupportedbyPowerLanguage.

BoolSupportedbyPowerLanguage.

ByteSupportedbyPowerLanguage.

CharSupportedbyPowerLanguage.

DefineDLLFuncSupportedbyPowerLanguage.

DoubleSupportedbyPowerLanguage.

DWORDSupportedbyPowerLanguage.

ExternalSupportedbyPowerLanguage.

FloatSupportedbyPowerLanguage.

iEasyLanguageObjectSupportedbyPowerLanguage.

IntSupportedbyPowerLanguage.

Int64Theint64isareservedworddefiningthatthepassedorreturnedvalueoffunctionsexportedfromthedllhasthelonglongtype(64-bitrepresentationofaninteger).

DuetoarchitecturalspecificsofPowerLanguage,beforepassingthelonglongtypevalueinadll(orwhenthevalueswerereturnedfromadll)itisconvertedfromthe"double"type(orinto"double"type).Notethatprecisionofthedoubletypevaluesis15decimals.(Valuesrangeofthelonglongtypeisfrom-9,223,372,036,854,775,808to9,223,372,036,854,775,807-19decimalpoints).Itmeansthatwithoutlossofaccuracythevalueswiththerangefrom-999,999,999,999,999to999,999,999,999,999willbepassed.

Example

Definesthedllfunction,whichreceiveslonglongparameter:

DEFINEDLLFUNC:"test_int64.dll",void,"int64test_1",int64;

Definesthedllfunction,whichreturnslonglongvalue:

DEFINEDLLFUNC:"test_int64.dll",int64,"int64test_2";

LongSupportedbyPowerLanguage.

LPBoolSupportedbyPowerLanguage.

LPByteSupportedbyPowerLanguage.

LPDoubleSupportedbyPowerLanguage.

LPDWORDSupportedbyPowerLanguage.

LPFloatSupportedbyPowerLanguage.

LPIntSupportedbyPowerLanguage.

LPLongSupportedbyPowerLanguage.

LPSTRSupportedbyPowerLanguage.

LPWORDSupportedbyPowerLanguage.

MethodSupportedbyPowerLanguage.

OnCreateSupportedbyPowerLanguage.

OnDestroySupportedbyPowerLanguage.

SelfSupportedbyPowerLanguage.

ThreadSafeDeclaresthefunctionimportedfromDLLasthread-safe.

ItwillincreasetheperformanceofcalculationandoptimizationofthestudiesthatuseexternalDLLs.

ThreadSafe

ItisnotrecommendedtoapplyThreadSafeattributetothefunctionsexportedfromelkit32.dll(forexampleFindAddress_).

Example

DEFINEDLLFUNC:ThreadSafe,"user32.dll",Void,"MessageBeep",Int;

WilldeclareMessageBeepfunctionofuser32.dllasthread-safe.

UnsignedSupportedbyPowerLanguage.

VarSizeSupportedbyPowerLanguage.

VarStartAddrSupportedbyPowerLanguage.

VoidSupportedbyPowerLanguage.

WORDSupportedbyPowerLanguage.

#EventsSupportedbyPowerLanguage.

DOM_AskPriceReturnsaskpriceforthecertaindepthlevelofaparticularsymbol.

DOM_AskPrice(num)[Data(N)]

where:

(num)-isthenumberofdepthlevel

(N)-isthenumberofthedataseries

Example

DOM_AskPrice(4);willreturntheaskpriceforthe5thlevelofdepthfortheData1

DOM_AskPrice(2)Data2;willreturntheaskpriceforthe3rdlevelofdepthfortheData2

DOM_AsksCountReturnsthenumberofaskdepthlevelsavailableforaparticularsymbol.

DOM_AsksCount[Data(N)]

where:

Example

DOM_AsksCountwillreturn10if10asklevelsofthemarketdepthareavailablefortheData1

DOM_AsksCountData2willreturn6if6asklevelsofthemarketdepthareavailablefortheData2

DOM_AskSizeReturnstheasksizeforthecertaindepthlevelofaparticularsymbol.

DOM_AskSize(num)[Data(N)]

where:

Example

DOM_AskSize(2)willreturn1500iftheasksizeforthe3rdlevelofdepthonData1is1500

DOM_AskSize(0)Data2willreturn750iftheasksizeforthe1stlevelofdepthonData2is750

DOM_BidPriceReturnsbidpriceforthecertaindepthlevelofaparticularsymbol.

DOM_BidPrice(num)[Data(N)]

where:

Example

DOM_BidPrice(4);willreturnthebidpriceforthe5thlevelofdepthfortheData1

DOM_BidPrice(2)Data2;willreturnthebidpriceforthe3rdlevelofdepthfortheData2

DOM_BidsCountReturnsthenumberofbiddepthlevelsavailableforaparticularsymbol.

DOM_BidsCount[Data(N)]

where:

Example

DOM_BidsCountwillreturn10if10bidlevelsofthemarketdepthareavailablefortheData1

DOM_BidsCountData2willreturn6if6bidlevelsofthemarketdepthareavailablefortheData2

DOM_BidSizeReturnsthebidsizeforthecertaindepthlevelofaparticularsymbol.

DOM_BidSize(num)[Data(N)]

where:

Example

DOM_BidSize(2)willreturn1500ifthebidsizeforthe3rdlevelofdepthonData1is1500

DOM_BidSize(0)Data2willreturn750ifthebidsizeforthe1stlevelofdepthonData2is750

DOM_IsConnectedReturnsalogicalvalueindicatingtheavailabilityofthemarketdepthdata;returnsavalueofTrueifthemarketdepthdataisavailableandavalueofFalseifthemarketdepthdataisnotavailable.

DOM_IsConnected

Example

Printtheasksizeforthe1stlevelofmarketdepthifthemarketdepthdataisavailable

Variables:

var0(0);

IfDOM_IsConnectedthen

var0=DOM_AskPrice(0);

Print(var0);

Array_CompareComparesaspecifiedrangeofelementsofthespecifiedone-dimensionalsourcearray,startingatthespecifiedsourceindex,tothesamerangeofelementsofthespecifiedone-dimensionaldestinationarray,startingatthespecifieddestinationindex.

Sourceanddestinationcanbethesamearrayaswellastwodifferentarrays.

Fornumericalarrays,thenumericalvaluesforeachpairofelementsarecompared.Forstringarrays,theASCIIvaluesofthestringcharacters,withthefirstcharacterofthestringbeingthemostsignificant,arecomparedforeachpairofelements.Fortrue/falsearrays,thelogicalvaluesofeachpairofelementsarecompared,withthevalueoftrueconsideredtobegreaterthanthevalueoffalse.

Returnsavalueof0ifeachrespectivepairofelementscomparedasequal;avalueof1if,forthefirstpairthatwasnotequal,thevalueinthesourcerangewasgreaterthenthevalueinthedestinationrange;andavalueof-1if,forthefirstpairthatwasnotequal,thevalueinthesourcerangewaslessthenthevalueinthedestinationrange.

Array_Compare(SourceArray,SourceIndex,DestinationArray,DestinationIndex,NumberOfElements

Where:SourceArray-anexpressionspecifyingthenameofthesourcearrayDestinationArray-anexpressionspecifyingthenameofthedestinationarraySourceIndex-anumericalexpressionspecifyingthestartingindexforthesourcearrayDestinationIndex-anumericalexpressionspecifyingthestartingindexforthedestinationarrayNumberOfElements-anumericalexpressionspecifyingthenumberofelementstocompare

Return

0-eachrespectivepairofelementscomparedasequal1-forthefirstpaircomparedthatwasnotequal,thevalueinthesourcerangewasgreaterthenthevalueinthedestinationrange-1-forthefirstpaircomparedthatwasnotequal,thevalueinthesourcerangewaslessthenthevalueinthedestinationrange

Example

Assignavalue,indicatingtheresultofcomparingtwo-elementsegments,ofArray1,beginningattheindexof4,andofArray2,beginningattheindexof6,toValue1variable:

Value1=Array_Compare(Array1,4,Array2,6,2);

Assignavalue,indicatingtheresultofcomparingtwo-elementsegmentsthatbeginattheindexof4andattheindexof6withinthesamearray,toValue1variable:

Value1=Array_Compare(Array1,4,Array1,6,2);

Array_ContainsWillreturnTrue/Falsevaluedependingonwhetherspecificelementiscontainedintheone-dimensionalarray,ornot.

Array_Contains(ArrayName,Value)

Where:ArrayName-anexpressionspecifyingthenameofannumerical/string/boolarray.Value-anumerical/string/boolexpressionspecifyingthevaluetosearch.

Example

Assignatrue/falsevalue,indicatingthatvalue4iscontainedinthenumericarrayArray1,toCondition1variable:

Condition1=Array_Contains(Array1,4);

Array_CopyCopiesaspecifiednumberofelementsfromthespecifiedone-dimensionalsourcearray,startingatthespecifiedsourceindex;theelementsarecopiedtothespecifiedone-dimensionaldestinationarray,startingatthespecifieddestinationindex.

Sourceanddestinationcanbethesamearrayaswellastwodifferentarrays.

Array_Copy(SourceArray,SourceIndex,DestinationArray,DestinationIndex,NumberOfElements

Where:SourceArray-anexpressionspecifyingthenameofthesourcearrayDestinationArray-anexpressionspecifyingthenameofthedestinationarraySourceIndex-anumericalexpressionspecifyingthestartingindexforthesourcearrayDestinationIndex-anumericalexpressionspecifyingthestartingindexforthedestinationarrayNumberOfElements-anumericalexpressionspecifyingthenumberofelementstocopy

Example

CopyfromArray1thetwo-elementsegmentbeginningattheindexof4,totheArray2,beginningattheindexof6:

Array_Copy(Array1,4,Array2,6,2);

CopyfromArray1thetwo-elementsegmentbeginningattheindexof4,tothesamearray,beginningattheindexof6:

Array_Copy(Array1,4,Array1,6,2);

Array_GetBooleanValue

ReturnstheBooleanvaluewithacertainindexfromnumericalarray.

Array_GetBooleanValue

Example

AssignthesecondBooleanvalueofthe"arr"arraytoValue1variable:

Array:arr[10](0);Value1=Array_GetBooleanValue(arr,2);

Array_GetFloatValue

Returnsthefloatvaluewithacertainindexfromnumericalarray.

Array_GetFloatValue

Example

AssignthesecondfloatvalueofarrarraytoValue1variable:

Array:arr[10](0);Value1=Array_GetFloatValue(arr,2);

Array_GetIntegerValue

Returnstheintegervaluewithacertainindexfromnumericalarray.

Array_GetIntegerValue

Example

Assignthesecondfloatvalueof"arr"arraytoValue1variable:

Array:arr[10](0);Value1=Array_GetIntegerValue(arr,2);

Array_GetMaxIndexReturnsanumericalvalueindicatingthemaximumindexofaone-dimensionalarray.

Arrayindexesstartat0,andarraysizeisequaltothevalueofthemaximumindexplusone.

Array_GetMaxIndex(ArrayName)

Where:ArrayName-anexpressionspecifyingthenameofanarray

Example

AssignavaluethatindicatesthemaximumindexofArray1totheMaxIndexvariable:

MaxIndex=Array_GetMaxIndex(Array1);

Array_GetStringValue

Returnsthestringvaluewithacertainindexfromnumericalarray.

Array_GetStringValue

Example

Assignthesecondfloatvalueof"arr"arraytoValue1variable:

Array:arr[10](0);Value1=Array_GetStringValue(arr,2);

Array_GetTypeReturnsanumericalvalueindicatingthetypeofthespecifiedarray.

Array_GetType(ArrayName)

Where:ArrayName-anexpressionspecifyingthenameofanarray

Return

2-atrue/falsearray3-astringarray7-adouble-precisionnumericalarray

Example

Assignavalue,indicatingthetypeofArray1,toValue1variable:

Value1=Array_GetType(Array1);

Array_IndexOfWillreturnindexofaspecificelementinone-dimensionalarray.Willreturn-1ifthearraywillnotcontainthespecificelement.

Array_IndexOf(ArrayName,Value)

Where:ArrayName-anexpressionspecifyingthenameofannumerical/string/boolarray.Value-anumerical/string/boolexpressionspecifyingthevaluetosearchfor.

Example

Assignanindexofvalue4toValue1variableinthenumericarrayArray1:

Value1=Array_IndexOf(Array1,4);

Array_SetBooleanValue

SetstheBooleanvalueforacertainindexofnumericalarray.

Array_SetBooleanValue

Example

Setthefirstandthirdvaluesof"arr"arraytoTRUE:

Array:arr[10](False);Array_SetBooleanValue(arr,1,True);Array_SetBooleanValue(arr,1,True);

Array_SetFloatValue

Setsthefloatvalueforacertainindexofnumericalarray.

Array_SetFloatValue

Example

Setthefirstandthirdvaluesof"arr"arrayto1.789:

Array:arr[10](False);Array_SetFloatValue(arr,1,1.789000352);Array_SetFloatValue(arr,3,1.789000352);

Array_SetIntegerValue

Setstheintegervalueforacertainindexofnumericalarray.

Array_SetIntegerValue

Example

Setthefirstandthirdvaluesof"arr"arrayto500:

Array:arr[10](False);Array_SetIntegerValue(arr,1,500);Array_SetIntegerValue(arr,3,500);

Array_SetMaxIndexResizesadeclareddynamicarraytoaspecifiednumberofelements;returnsavalueofTruetoindicateasuccessfulresize.

Anarraycanberesizedtoalargerortoasmallernumberofelements;anyelementsaddedtoanarraywillbeassignedtheinitialvaluethatwasspecifiedatarraydeclaration.

Array_SetMaxIndex(ArrayName,MaxIndex)

Where:ArrayName-anexpressionspecifyingthenameofanarraytoberesizedMaxIndex-anumericalexpressionspecifyingthemaximumindexofthearray*

*Arrayindexesstartat0,andarraysizeisequaltothevalueofMaxIndexplusone.

Return

True-resizesucessfull

False-resizefailed

Example

ResizethedynamicarrayArray1to10elementsbyspecifyingamaximumindexvalueof9:

Array_SetMaxIndex(Array1,9);

AssignavaluethatindicatesastatusoftheresizeofArray1totheResizeReportvariable:

ResizeReport=Array_SetMaxIndex(Array1,9);

AvalueofTruewillindicateasuccessfulresize,andavalueofFalsewillindicateafailedresize.

Array_SetStringValue

Setsthestringvalueforacertainindexofnumericalarray.

Array_SetStringValue

Example

Setthefirstandthirdvaluesof"arr"arrayto"arraystring":

Array:arr[10](False);Array_SetStringValue(arr,1,"arraystring");Array_SetStringValue(arr,3,"arraystring");

Array_SetValRangeAssignsaspecifiedvaluetoeachelementwithinaspecifiedrange,ofthespecifiedone-dimensionalarray.

Array_SetValRange(ArrayName,StartIndex,EndIndex,Value)

Where:ArrayName-anexpressionspecifyingthenameofanarrayStartIndex-anumericalexpressionspecifyingthestartingindexfortherangeEndIndex-anumericalexpressionspecifyingtheendingindexfortherangeValue-avaluetobeassignedtoeachelementwithintherange

Example

AssignavalueofTruetoeachelementwithinasegment,beginningatindex4andendingatindex6,ofArray1:

Array_SetValRange(Array1,4,6,True);

Array_SortSorts,ineitherascendingordescendingorder,therangeofelements,specifiedbythestartingandendingindexes,ofthespecifiedone-dimensionalarray.

Fornumericalarrays,theelementsaresortedaccordingtothevaluestheycontain.Forstringarrays,theelementsaresortedaccordingtotheASCIIvaluesofthestringcharacters,withthefirstcharacterofthestringbeingthemostsignificant.Forsortingtrue/falsearrayelements,thevalueoftrueisconsideredtobegreaterthanthevalueoffalse.

Array_Sort(ArrayName,StartIndex,EndIndex,SortOrder)

Where:ArrayName-anexpressionspecifyingthenameofanarrayStartIndex-anumericalexpressionspecifyingthestartingindexfortherangeEndIndex-anumericalexpressionspecifyingtheendingindexfortherangeSortOrder-atrue/falsevaluespecifyingthesortorder;truespecifiesascendingorder,andfalsespecifiesdescendingorder

Example

SorttheelementsinthesegmentofArray1thatbeginsattheindexof4andendsattheindexof6,inascendingorder:

Array_Sort(Array1,4,6,True);

Array_SumReturnsasumofthevaluescontainedinarangeofelements,specifiedbythestartingandendingindexes,ofthespecifiedone-dimensionalarray;returnsthenumberoftrueelementsifthearraycontainstrue/falsevalues;returnsavalueof0ifthearraycontainsstringvalues.

Array_Sum(ArrayName,StartIndex,EndIndex)

Where:ArrayName-anexpressionspecifyingthenameofanarrayStartIndex-anumericalexpressionspecifyingthestartingindexfortherangeEndIndex-anumericalexpressionspecifyingtheendingindexfortherange

Example

Assignavalue,indicatingasumofthevaluescontainedinthesegmentofArray1thatbeginsattheindexof4andendsattheindexof6,toValue1variable:

Value1=Array_Sum(Array1,4,6);

Fill_Array

Assignsaspecifiedvaluetoeachelementofthespecifiedone-dimensionalarray.

Fill_Array(ArrayName,Value)

Where:ArrayName-anexpressionspecifyingthenameofanarrayValue-avaluetobeassignedtoeachelementofthearray

Example

AssignavalueofTruetoeachelementofArray1:

Fill_Array(Array1,True);

BaseDataNumber

ReturnsanumericalvalueindicatingtheDataNumberoftheseriesthatthestudyisappliedto.

BaseDataNumber

Example

Assignavalue,indicatingtheDataNumberoftheseriesthatthestudyisappliedto,toValue1variable:

Value1=BaseDataNumber;

CurrentDataNumber

ReturnsanumericalvalueindicatingtheDataNumberoftheseriesthatthefunctionisbeingcalculatedon.

CurrentDataNumber

Example

Assignavalue,indicatingtheDataNumberoftheseriesthatthefunctionisbeingcalculatedon,toValue1variable:

Value1=CurrentDataNumber;

ExecOffset

Returnsanumericalvalueindicatingthefunctionexecutionoffsetinbars.

ExecOffset

Example

Assignavalue,indicatingthefunctionexecutionoffset,toValue1variable:

Value1=ExecOffset;

GetAppInfoReturnsanumericalvalue,representingthespecifiedattributeofthecallingapplication.

GetAppInfo(Attribute)

Parameters

aiApplicationType-identifiesthecallingapplication:

0=Unknown

1=Chart

2=Scanner

aiBarSpacing-specifiesreturnofthenumberofspacesbetweenthebarsonachartGetAppInfowillreturnavalue,indicatingthebarspacingofachart.

aiCalcReason-returnsanumericalvalue,indicatingthereasonofcalculationinitialization(i.e.returns0(CalcReason_Default)whencalculationwastriggeredbyanewbar/tick):

0(CalcReason_default)-calculationistobeinitializedwhenthenewbar/tickappeared.

1(CalcReason_mouseLClick)calculationistobeinitializedafterleft-clickonthechart.

2(CalcReason_mouseRClick)-calculationistobeinitializedafterright-clickonthechart.

3(CalcReason_timer)calculationistobeinitializedafterexpirationofRecalcLastBarAftertimeout.

4(CalcReason_MPChange)calculationistobeinitializedaftermarketpositionfortheinstrumenthasbeenchanged(forsignalsonly).

5(CalcReason_OrderFilled)calculationistobeinitializedafterorderfilledevent(forsignalsonly).

aiHighestDispValue-specifiesreturnofthehighestpricevaluethatcouldbedisplayedinthecurrentchartwindowGetAppInfowillreturnthehighestpricevaluethatcouldbedisplayedonachart.

aiLowestDispValue-specifiesreturnofthelowestpricevaluethatcouldbedisplayedinthecurrentchartwindowGetAppInfowillreturnthelowestpricevaluethatcouldbedisplayedonachart.

aiLeftDispDateTime-specifiesreturnofthedateandtimeoftheleftmostbardisplayedinthecurrentchartwindowGetAppInfowillreturntheDateTimevalueoftheleftmostbardisplayedonachart;theintegerportionoftheDateTimevaluespecifiesthenumberofdayssinceJanuary1st,1900,andthefractionalportionoftheDateTimevaluespecifiesthefractionofthedaysincemidnight.

aiRightDispDateTime-specifiesreturnofthedateandtimeoftherightmostbardisplayedinthecurrentchartwindowGetAppInfowillreturntheDateTimevalueoftherightmostbardisplayedonachart;theintegerportionoftheDateTimevaluespecifiesthenumberofdayssinceJanuary1st,1900,andthefractionalportionoftheDateTimevaluespecifiesthefractionofthedaysincemidnight.

aiRow-identifiesthesymbol'srownumberinScanner;returnsapositivenon-zerovaluefromaScannerapplicationelsereturns0.

aiSpaceToRight-specifiesreturnoftherightmargin,inbars,ofthecurrentchartwindowGetAppInfowillreturntherightmargin,inbars,ofachart.

aiOptimizing-specifiesreturnofanumericalvalue,indicatingwhetherthecallingapplicationiscurrentlyperforminganoptimizationGetAppInfowillreturnavalueof1onlyifthecallingapplicationiscurrentlyperforminganoptimization,andavalueof0inallothercases.

aiStrategyAuto-specifiesreturnofanumericalvalue,indicatingwhetherthecallingapplicationisusingAutomatedTradeExecutionGetAppInfowillreturnavalueof1onlyifthecallingapplicationisusingAutomatedTradeExecution,andavalueof0inallothercases.

aiStrategyAutoConf-specifiesreturnofanumericalvalue,indicatingwhetherthecallingapplicationisusingAutomatedTradeExecutionwithorderconfirmationturnedoffGetAppInfowillreturnavalueof0onlyifthecalling

applicationisusingAutomatedTradeExecutionwithorderconfirmationturnedoff,andavalueof1inallothercases.

aiIntrabarOrder-specifiesreturnofanumericalvalue,indicatingwhetherthecallingapplicationisrunningthesignalwithintra-barordergenerationturnedonGetAppInfowillreturnavalueof1onlyifthecallingapplicationisrunningthesignalwithintra-barordergenerationturnedon,andavalueof0inallothercases.

aiAppId-specifiesreturnofanumericalvalue,usedtoidentifythecallingapplicationGetAppInfowillreturnauniquenon-zerointegeridentifyingthecallingapplication.

aiRealTimeCalc-specifiesreturnofanumericalvalue,indicatingwhetherthecallingapplicationscalculationsarebasedonreal-timedataGetAppInfowillreturnavalueof1onlyifthecallingapplication'scalculationsarebasedonreal-timedata,andavalueof0inallothercases.

aichartshiftpercent-returnstheChartShiftvalueinpercentsfromFormatWindow->X-TimeScale.Thevalueisupdatedonthefly.

Example

GetAppInfo(aiBarSpacing)willreturnavalue,indicatingthebarspacingofachart

GetAppInfo(aiStrategyAutoConf)willreturnavalueof0ifthecallingapplicationisusingAutomatedTradeExecutionwithorderconfirmationturnedoff;otherwise,willreturnavalueof1

GetAppInfo(aiRealTimeCalc)willreturnavalueof1ifthecallingapplicationscalculationsarebasedonreal-timedata;otherwise,willreturnavalueof0

[ProcessMouseEvents=true];switch(getappinfo(aicalcreason))begincaseCalcReason_MouseLClick:ifMouseClickCtrlPressedthenbeginvar:var0(0),var1(0);repeatif0=var0thenbeginvar0=MouseClickDateTime;break;end;

until(false);end;end;var1=datetime2eltime(var0);print("TimeoftheBar=",var1);

WillreturnthetimeofthebarafterleftclickonitpressingCtrlbuttononthekeyboard.

GetCDRomDrive

ReturnsastringexpressionofthedriveletterforthefirstCD-ROMdrivedetected.

GetCDRomDrive

Example

Variables:Drive("D");Drive=GetCDRomDrive;

WillsetthevariableDriveequaltothefirstCD-ROMdrivedetected.

GetCountryReturnsthelocalename,correspondingtotheStandardsandformatssettingselectedintheRegionalOptionssettingsoftheWindowsXPControlPanel.

GetCountry

Example

GetCountrywillreturnastringexpression"UnitedStates"forthesetting"English(UnitedStates)"

GetCurrencyReturnsthecurrencysymbolselectedintheRegionalOptionssettingsoftheWindowsXPControlPanel.

GetCurrency

Example

GetCurrencywillreturnthe"$"symbolfortheUSDollar

GetUserID

Returnsauniqueidentificationnumber(UserID)forthePCthatthestudyisbeingrunon.

UserIDnumberisusedforstudyprotection.

GetUserID

Example

Assignavalue,indicatingtheUserID,toValue1variable:

Value1=GetUserID;

GetUserNameReturnsMultiChartsregistrationname(UserName)forMultiChartsinstallationonthePCthatthestudyisbeingrunon.

UserNameisusedforstudyprotection.

GetUserName

Example

Assignavalue,indicatingtheUserName,toUserNamevariable:

Var:UserName("");

UserName=GetUserName;

MaxBarsBack

ReturnsanumericalvalueindicatingtheMaximumBarsBacksettingforthestudy.

Allstudiesbasedonpastdatauseacertainnumberofbarsfortheircalculations.ThenumberofbarsiscalledMaximumnumberofbarsastudywillreference,orMaximumBarsBack.

MaxBarsBack

Example

Assignavalue,indicatingtheMaximumBarsBacksettingforthestudy,toValue1variable:

Value1=MaxBarsBack;

MaxBarsForward

Returnsanumericalvalueindicatingthesize,inbars,oftherightmarginonthechart.

Rightmarginisusedbythestudiesthatvisualizethepredictedpricemovement.

MaxBarsForward

Example

Assignavalue,indicatingthesizeoftherightmarginofthechart,toValue1variable:

Value1=MaxBarsForward;

SetMaxBarsBack

SetsanumericalvalueindicatingtheMaximumBarsBacksettingforthestudy.

Allstudiesbasedonpastdatauseacertainnumberofbarsfortheircalculations.

ThenumberofbarsiscalledMaximumnumberofbarsastudywillreference,orMaximumBarsBack.

SetMaxBarsBack(BarsBack)

Where:BarsBack-numericalexpression,specifyingthenumberofbarsback

BarsBackcan'tbeanegativevalue.

Example

Setavalue,indicatingtheMaximumBarsBacksettingforthestudyto50:

SetMaxBarsBack(50);

Generatesarun-timeerrorandabortstheexecutionofthestudy.

Example

Abortthestudysexecution:

Abort;

CommandLine

Passesastringexpressionfromscripttocommandline.

CommandLine("Expression")

Seethelistofsupportedexpressionsforthecommandline.

Examples

CommandLine(".rld");

Reloadsthechartwherethescriptisapplied(reloadsallchartwherethesamesymbolisused).

CommandLine(".at_toggle");

Turnson/offautotradingonthechartwherethescriptisapplied(ifitisusedtoturnautotradingon,thepoppedupconfirmationwindowcannotbeskippedandamanualclickon"OK"isrequired).

CommandLine(".csydnum=1,name=AUD/CHF,df=LMAX");

Changesthesymbolplottedasdataseries1toAUD/CHFandthedatasourcetoLMAXonthechartwherethescriptisapplied.

CommandLine(".isyname=@ES#,df=IQFeed,res=1min,desc=E-MINIS&P;500MARCH2013,from=12/31/2012,to=5/10/2013");

Inserts1minutegraphofS&P;mini500fromIQFeedstartingfrom31thofDecember2012upto10thofMay2013asadditionaldataseriestothechartwherethescriptisapplied.

CommandLine(".iidname=MACD,base=1,bref=100");

AppliesMACDindicatortothedataseries1withMaxBarsBackparameter=100to

thechartwherethescriptisapplied.

CommandLine(".rldint2weeks");

Reloads2weeksofdataonthechartwherethescriptisapplied.

fpcExactAccuracy

Constant,usedincombinationwithSetFPCompareAccuracytodesignatethefloatingpointcomparetolerancevalueof0.00;canbesubstitutedbyanumericalvalueof5.

SetFPCompareAccuracy(fpcExactAccuracy)

SetFPCompareAccuracy(5)

Example

SetthefloatingpointcompareaccuracytoExact:

SetFPCompareAccuracy(fpcExactAccuracy);

SetthefloatingpointcompareaccuracytoExact:

SetFPCompareAccuracy(5);

fpcHighAccuracy

Constant,usedincombinationwithSetFPCompareAccuracytodesignatethefloatingpointcomparetolerancevalueof2.2204460492503131e-14;canbesubstitutedbyanumericalvalueof3.

SetFPCompareAccuracy(fpcHighAccuracy)

Example

SetthefloatingpointcompareaccuracytoHigh:

SetFPCompareAccuracy(fpcHighAccuracy);

SetthefloatingpointcompareaccuracytoHigh:

fpcLowAccuracy

SetFPCompareAccuracy(fpcLowAccuracy)

Example

SetthefloatingpointcompareaccuracytoLow:

SetFPCompareAccuracy(fpcLowAccuracy);

SetthefloatingpointcompareaccuracytoLow:

fpcMedAccuracy

SetFPCompareAccuracy(fpcMedAccuracy)

Example

SetthefloatingpointcompareaccuracytoMedium:

SetFPCompareAccuracy(fpcMedAccuracy);

SetthefloatingpointcompareaccuracytoMedium:

fpcVeryHighAccuracy

SetFPCompareAccuracy(fpcVeryHighAccuracy)

Example

SetthefloatingpointcompareaccuracytoVeryHigh:

SetFPCompareAccuracy(fpcVeryHighAccuracy);

SetthefloatingpointcompareaccuracytoVeryHigh:

fpcVeryLowAccuracy

SetFPCompareAccuracy(fpcVeryLowAccuracy)

Example

SetthefloatingpointcompareaccuracytoVeryLow:

SetFPCompareAccuracy(fpcVeryLowAccuracy);

SetthefloatingpointcompareaccuracytoVeryLow:

RaiseRunTimeError

Generatesarun-timeerroranddisplaysthespecifiederrormessage.

Arun-timeerrorwillcausetheexecutionofthestudytobeaborted.

RaiseRunTimeError("Message")

Where:Message-astringexpressionspecifyingtheerrormessage

Example

Generatearun-timeerroranddisplaythemessage"StrategyStopped":

RaiseRunTimeError("StrategyStopped");

RecalcLastBarAfter

Initializesthecalculationafterexpirationofthetimeout,setinseconds.Note:Themaximumrecalculationfrequencyis100milliseconds(0.1sec).

RecalcLastBarAfter(Timeout)

Where:Timeout-thenumberofseconds.

Example

RecalcLastBarAfter(60)willinitiatenewscriptcalculationafteroneminutetimeoutsincethelastcalculation.

ReCalculate

Initializesrecalculationofthestudy.Allthevariableswillbere-initialized.

Thestudywillberecalculatedfromthefirstbarofthedataseries.

ReCalculate

Toavoidinfiniteloopingofthescript,useglobalvariableswithrecalculationconditions.

Example

Settheconditionforrecalculation:

Var:ReCalcPersistrecalc_once(True),vo10(0);

IfLastBarOnChartThenBeginPrint("Lastbarvolume=",Volume);

Ifrecalc_onceThenBeginPrint("Recalculatestudy!");recalc_once=FalseReCalculate;End;

SetFPCompareAccuracy

Setsfloatingpointcompareaccuracybyspecifyingthetolerancevaluetobeusedwhenfloatingpointvaluesarecompared.

Twofloatingpointvalueswillbeconsideredequalif"abs(Value1Value2)<=ε",whereεisthetolerancevalue.

Bydefault,thetolerancevalueis2.2204460492503131e-012.

SetFPCompareAccuracy(Accuracy)

Parameters

Accuracy-anFPCconstantoranumericalexpressionspecifyingatolerancevalueasfollows:

fpcVeryLowAccuracy 0 02.2204460492503131e-8fpcLowAccuracy 1 12.2204460492503131e-10fpcMedAccuracy 2 22.2204460492503131e-12(Default)fpcHighAccuracy 3 32.2204460492503131e-14fpcVeryHighAccuracy 4 42.2204460492503131e-16fpcExact 5 50.00

Example

SetfloatingpointcompareaccuracytoHigh:

SetFPCompareAccuracy(fpcHighAccuracy);

#Return

ReturnsthecontrolfromthestudyscriptbyanalogywiththecorrespondingC++statement.

Doesnotreturnanyvalue.

#Return;

Canbeusedinalltypesofstudies.

AtCommentaryBarThisreservedwordreturnsavalueofTrueonthebarclickedbytheuser.

ItwillreturnavalueofFalseforallotherbars.

Thisallowsyoutooptimizeyourtradingstrategies,analysistechniques,andfunctionsforspeed,asitwillallowPowerLanguagetoskipallcommentary-relatedcalculationsforallbarsexceptfortheonewherethecommentaryisrequested.

AtCommentaryBar

ThedifferencebetweenAtCommentaryBarandCommentaryEnabledisthatCommentaryEnabledreturnsavalueofTrueforALLbarswhentheExpertCommentarywindowisopen,whiletheAtCommentaryBarreturnsavalueofTrueonlyforthebarclicked.

Example

Thefollowingstatementsdisplaya50-baraverageofthevolumeintheExpertCommentarywindowbutavoidcalculatingthis50-baraverageforeveryotherbarofthechart:

IfAtCommentaryBarThen

Commentary("The50-barvolavg:",Average(Volume,50));

CheckCommentaryReturnsTrueafterleftclickonachartwiththeExpertCommentarypointeronthespecifiedbar.

ReturnsFalseifthepointerhasnotbeeninserted,orifthepointerwasinsertedonadifferentbar.

CheckCommentary

Example

IfyouonlywantedcodetobeevaluatedforthebarwheretheuserhadinsertedtheExpertCommentaryTool,youcouldusethefollowingsyntax:

IfCheckCommentaryThenBegin{YourCodeHere}End;

CommentaryThisreservedwordsendstheexpression(orlistofexpressions)totheExpertCommentarywindowforwhateverbarisselectedonthepricechart.

Commentary("MyExpression");

Where"MyExpression"isthenumerical,textstringortrue/falseexpressionthatistobesenttotheExpertCommentarywindow.

Youcansendmultipleexpressions,commasmustseparatethem.

Example

Thefollowingwillresultinthestring"Thisisonelineofcommentary"beingsenttothecommentarywindow.

Anyadditionalcommentarysentwillbeplacedonthesameline.

Commentary("Thisisonelineofcommentary");

CommentaryCLThisreservedwordsendstheexpression(orlistofexpressions)totheExpertCommentarywindowforwhateverbarisselectedbytheExpertCommentarypointer.

CommentaryCL("MyExpression");

Where"MyExpression"isasingleoracomma-separatedlistofnumeric,textstring,ortrue/falseexpressionsthataresenttotheExpertCommentarywindow.

Example

Thefollowingwillresultinthestring"Thisisonelineofcommentary"beingsenttothecommentarywindow.

Anyadditionalcommentarysentwillbeplacedonthenextline.

CommentaryCL("Thisisonelineofcommentary");

CommentaryEnabledThisreservedwordreturnsavalueofTrueonlywhentheExpertCommentarywindowisopenandCommentaryhasbeenrequested.

Thisallowsyoutooptimizeyourtradingstrategies,analysistechniques,andfunctionsforspeed,asitallowsPowerLanguagetoperformcommentary-relatedcalculationsonlywhentheExpertCommentarywindowisopen.

CommentaryEnabled

ThedifferencebetweenCommentaryEnabledandAtCommentaryBaristhatCommentaryEnabledreturnsavalueofTrueforALLbarswhentheExpertCommentarywindowisopen,whiletheAtCommentaryBarreturnsavalueofTrueonlyforthebarclickedwiththeExpertCommentarypointer.

Example

CommentaryEnabledwillreturnTrueiftheAnalysisCommentaryToolhasbeenappliedtothechart.

#BeginCmtryThestatementsbetweenthiscompilerdirectiveandthereservedword#EndareevaluatedonlywhentheExpertCommentarytoolisusedtoselectabaronachartoracellinagrid.

Thereservedword#Endmustbeusedwiththisreservedword.

#BeginCmtry

Commentary("Theindicatorvaluehereis"+NumtoStr(Plot1,2));

Allstatementsbetweenthe#BeginCmtryand#Endareignored,includingcalculationofMaxBarsBack,unlesscommentaryisgenerated.

Example

Anindicatorthatcalculatesthe10-barmomentumoftheclosingpriceneedstenbarsinordertostartplottingresults.

Ifcommentaryisaddedtothisindicatorandthecommentaryusesa50-baraverageofthevolume,thentheMaxBarsBacksettingisincreasedtofifty.

However,the50-baraverageisonlyusedforthecommentary,sothereisnoneedtohavetheindicatorwaitfiftybarsbeforegivingresultsunlessCommentaryisrequested.

Tohavetheindicatorplotafter10barsandignorethe50-barrequirement,theindicatorcanbewrittenasfollows:

Plot1(Close-Close[10],"Momentum");

#BeginCmtry;IfClose-Close[10]>0ThenCommentary("Momentumispositive,")ElseCommentary("Momentumisnegative,");IfVolume>Average(Volume,50)ThenCommentary("andvolumeisgreaterthanaverage.")ElseCommentary("andvolumeislowerthanaverage.");#End;

Thisindicatorplotsthemomentumandthecommentarystateswhetherthemomentumispositiveornegative,andifthevolumeisoverorunderthe50-baraverageofthevolume.

Whentheindicatorisappliedwithoutusingcommentary,itwillrequireonly10barstostartcalculating.

Whencommentaryisrequested,theindicatorisrecalculated,thestatementswithinthecompilerdirectivesareevaluated,andthenewminimumnumberofbarsrequiredis50.

Anyseriesfunctionswithinthesereservedwordsarealsoignored.

AbsValueReturnstheabsolutevalueofthespecifiednumericalexpression.

AbsValue(Value)

Where:Value-anumericalexpression

Example

AbsValue(45.275)willreturnavalueof45.275

AbsValue(-1385)willreturnavalueof1385

ArcTangentReturnsthearctangentvalue,indegrees,ofthespecifiednumericalexpression.

ArcTangent(Value)

Example

ArcTangent(2.318)willreturnavalueof66.66

AvgListReturnstheaveragevalueofthespecifiednumericalexpressions.

AvgList(Value1,Value2,Value3,etc.)

Where:Value1,Value2,Value3,etc.-numericalexpressions

Example

AvgList(45,40,0,35)willreturnavalueof30

AvgList(-40,20)willreturnavalueof-10

CeilingReturnsthesmallestintegergreaterthanorequaltothespecifiednumericalexpression.

Ceiling(Value)

Example

Ceiling(9.1)willreturnavalueof10

Ceiling(-2.85)willreturnavalueof-2

CosineReturnsthecosinevalueforanangleofthespecifiednumberofdegrees.

Cosine(Value)

Where:Value-anumericalexpression,specifyingthenumberofdegreesintheangle

Example

Cosine(60)willreturnavalueof0.5

CotangentReturnsthecotangentvalueforanangleofthespecifiednumberofdegrees.

Cotangent(Value)

Example

Cotangent(30)willreturnavalueof1.732

ExpValueReturnstheexponentialvalueofthespecifiednumericalexpression.

ExpValue(Value)

Example

ExpValue(2.3)willreturnavalueof9.0250

FloorReturnsthegreatestintegerlessthanorequaltothespecifiednumericalexpression.

Floor(Value)

Example

Floor(9.1)willreturnavalueof9

Floor(-2.85)willreturnavalueof-3

FracPortionReturnsthefractionalportionofthespecifiednumericalexpressionwhileretaingthesign.

FracPortion(Value)

Example

FracPortion(-45.275)willreturnavalueof-0.275

FracPortion(1385)willreturnavalueof0

IntPortionReturnstheintegerportionofthespecifiednumericalexpressionwhileretaingthesign.

IntPortion(Value)

Example

IntPortion(-45.75)willreturnavalueof-45

IntPortion(1385)willreturnavalueof1385

LogReturnsthenaturallogarithmofthespecifiednumericalexpression.

Log(Value)

Example

Log(25)willreturnavalueof3.2189

MaxListReturnsthevalueofthegreatestofthespecifiednumericalexpressions.

MaxList(Value1,Value2,Value3,etc.)

Example

MaxList(-5,0,12,7)willreturnavalueof12

MaxList2Returnsthesecondhighestvalueofthespecifiednumericalexpressions.

MaxList2(Value1,Value2,Value3,etc.)

Example

MaxList2(-5,0,12,7)willreturnavalueof7

MinListReturnsthelowestvalueofthespecifiednumericalexpressions.

MinList(Value1,Value2,Value3,etc.)

Example

MinList(-5,0,12,7)willreturnavalueof-5

MinList2Returnsthesecondlowestvalueofthespecifiednumericalexpressions.

MinList2(Value1,Value2,Value3,etc.)

Example

MinList(-5,0,12,7)willreturnavalueof0

ModReturnstheremainderfromdividingonespecifiednumericalexpressionbyanother.

Mod(Dividend,Divisor)

Where:Dividend-anumericalexpressionDivisor-anumericalexpression

Example

Mod(25,7)willreturnavalueof4

NegReturnsthenegativeabsolutevalueofthespecifiednumericalexpression.

Neg(Value)

Example

Neg(12)willreturnavalueof-12

Neg(-7)willreturnavalueof-7

NthMaxListReturnstheNthhighestvalueofthespecifiednumericalexpressions.

NthMaxList(N,Value1,Value2,Value3,etc.)

Where:N-anumericalexpression,indicatingtherankofthevaluetobereturnedValue1,Value2,Value3,etc.-numericalexpressions

Example

NthMaxList(4,-15,-5,0,6,12)willreturnavalueof-5

NthMinListReturnstheNthlowestvalueofthespecifiednumericalexpressions.

NthMinList(N,Value1,Value2,Value3,etc.)

Where:N-anumericalexpression,indicatingtherankofthevaluetobereturnedValue1,Value2,Value3,etc.-numericalexpressions

Example

NthMinList(4,-15,-5,0,6,12)willreturnavalueof6

PosSameasAbsValue

PowerReturnsthevalueofonespecifiednumericalexpressiontothepowerofanother.

Power(Base,Exponent)

Where:Base-anumericalexpressionExponent-anumericalexpression

Example

Power(5,3)willreturnavalueof125

RandomReturnsapseudo-randomnumberbetween0andthevalueofthespecifiednumericalexpression.

Random(Value)

Example

Random(1.25)willreturnarandomvalueanywherebetween0and1.25

Random(-10)willreturnarandomvalueanywherebetween-10and0

RoundReturnsthevalueofonespecifiednumericalexpressionroundedtothenumberofdecimalplacesspecifiedbyanother.

Round(Value,Precision)

Where:Value-anumericalexpressionPrecision-anumericalexpression

Example

Round(1.237,2)willreturnavalueof1.24

Round(-5.7744,3)willreturnavalueof5.774

SignReturnsanumericalvalue,indicatingthesignofthevalueofthespecifiednumericalexpression.

Avalueof1isreturnedforapositivevalue,-1isreturnedforanegativevalue,and0isreturnedforthevalueof0.

Sign(Value)

Example

Sign(5)willreturnavalueof1

Sign(-2.85)willreturnavalueof-1

Sign(0)willreturnavalueof0

SineReturnsthesinevalueforanangleofthespecifiednumberofdegrees.

Sine(Value)

Example

Sine(30)willreturnavalueof0.5

SquareReturnsthesquareofthevalueofthespecifiednumericalexpression.

Square(Value)

Example

Square(2.5)willreturnavalueof6.25

SquareRootReturnsthesquarerootofthevalueofthespecifiednumericalexpression.

SquareRoot(Value)

Example

SquareRoot(57.73)willreturnavalueof7.598

SumListReturnsasumofthevaluesofthespecifiednumericalexpressions.

SumList(Value1,Value2,Value3,etc.)

Example

SumList(45,-20,0,35)willreturnavalueof60

TangentReturnsthetangentvalueforanangleofthespecifiednumberofdegrees.

Tangent(Value)

Example

Tangent(40)willreturnavalueof0.839

AgoUsedincombinationwithBarorBarsandanumericalexpressiontoreferencethebaraspecifiednumberofbarsbackfromthecurrentbar.

BarsAgocanalsobespecifiedbyusingthebaroffsetnotationthatconsistsofanumericalexpressionenclosedinsquarebrackets.

NBarsAgo

Where:N-anumericalexpressionspecifyingthenumberofbarsbacktoreference

Example

BarUsedincombinationwithThis,Next,orAgotoreferenceaspecificbar.

Example

CloseOf1BarAgowillreturntheclosingpriceofthepreviousbar

BuyThisBarOnClose;

Buyauser-setnumberofsharesonopenofnextbar:

BuyNextBarOnOpen;

BarsSameasBar

ContractSameasContracts

ContractsUsedinstrategyentryorexitstatementsincombinationwithanumericalexpressiontospecifythenumberofcontractsorsharestotrade.

TradeSizeContracts

Where:TradeSize-anumericalexpression,specifyingthenumberofcontractsorshares

Example

Buy2contractsatMarketpriceonopenofnextbar:

Buy2ContractsNextBarAtMarket;

MarketUsedinstrategyentryorexitstatementstospecifyaMarketpriceforanentryoranexit.

AMarketBuyorderwillexecuteatthecurrentaskpriceandaMaretSellorderwillexecuteatthecurrentbidprice.

AtMarket

Where:Atisaskipwordandcanbeomitted

Example

BuyNextBarAtMarket;

NextUsedincombinationwithBartoreferencethenextbar.

NextBar

Example

BuyNextBarAtMarket;

ThisUsedincombinationwithBartoreferencethecurrentbar.

ThisBar

Example

BuyThisBarOnClose;

TodayRetainedforbackwardcompatibility;replacedwithThisBar

YesterdayRetainedforbackwardcompatibility.

MouseClickBarNumber

Afteramouseclickonthebar,returnsthenumericalvalueindicatingthebarnumberfromthebeginningofthedataseries.

MouseClickBarNumber

Example

MouseClickBarNumber-willreturn250afteramouseclickonthe250thbaronthechartfromthebeginningofthedataseries.

MouseClickCtrlPressed

ReturnsTrueiftheCtrlbuttonispressedonthekeyboardsimultaneouslywithamouseclick.

MouseClickCtrlPressed

MouseClickDataNumber

Returnsthenumericalvalueindicatingthedataseriesnumberafteramouseclickonthedataseries.

MouseClickDataNumber

Example

MouseClickDataNumber-willreturn1afterleft-clickonthemainchartwiththemaindataseries.

MouseClickDataNumber-willreturn2afterleft-clickonthesub-chartwiththeseconddataseries.

MouseClickDateTime

Returnsadouble-precisiondecimalvalueinJulian(OLE)date-timeformatindicatingtheclosingdateofthebarafteraclickonthebar.

MouseClickDateTime

Example

MouseClickDateTime-willreturnavalueof39449.65625000for3:45PM.

MouseClickPrice

Returnsanumericalvalueindicatingpricelevelofthemousepointerpositionafteraclickonthechart.

MouseClickPrice

Example

MouseClickPrice-willreturn139.60afteraclickonthechartonthe139.60pricelevel.

MouseClickShiftPressed

ReturnsTrueiftheShiftbuttonispressedonthekeyboardsimultaneouslywithamouseclick.

MouseClickShiftPressed

PlaySoundPlaysthespecifiedwave(.wav)soundfile.

PlaySound("PathFilename")

Where:PathFilename-astringexpressionspecifyingthepathandfilenameofthewavefiletobeplayed

Example

Playding.wavsoundfilelocatedintherootdirectoryoftheC:harddrive:

PlaySound("C:\ding.wav");

ClearDebugClearsthePowerLanguageEditorOutputLog.

ClearDebug

Example

ClearDebug;willclearthePowerLanguageEditorOutputLog

ClearPrintLogSameasClearDebug

FileUsedinPrintstatementstospecifyanASCIIfileastheoutputlocation;mustprecedetheexpressionstobeprintedandbefollowedbyacomma.Ifthespecifiedfiledoesnotexist,thefilewillbecreated.

File("PathFilename")

Where:PathFilename-astringexpressionspecifyingthepathandfilename

Example

Print(File("C:\test.txt"),CurrentDate,CurrentTime);willsavetheoutputofCurrentDateandCurrentTimetothetest.txtfileintherootdirectoryoftheC:harddrive

FileAppendAppendsthespecifiedstringexpressiontotheendofthespecifiedASCIIfile;ifthespecifiedfiledoesnotexist,thefilewillbecreated.

FileAppend("PathFilename","StringExpression")

Where:PathFilename-astringexpressionspecifyingthepathandfilenameStringExpression-thestringexpressiontobeappendedtoafile

Example

FileAppend("C:\test.txt","AppendedText");willappendthestringexpression"AppendedText"totheendofthetest.txtfileintherootdirectoryoftheC:harddrive

FileDeleteDeletesthespecifiedfile.

FileDelete("PathFilename")

Where:PathFilename-astringexpressionspecifyingthepathandfilenameofthefiletobedeleted

Example

FileDelete("C:\test.txt");willdeletethefiletest.txtintherootdirectoryoftheC:harddrive

MessageLogDisplaysoneormorespecifiedexpressionsinthePowerLanguageEditorOutputLog.Anycombinationofstring,true/false,numericalseries,ornumericalexpressionscanbespecified.

MessageLog(Expression1,Expression2,etc.)

Parameters

Expression-astring,true/false,numericalseries,ornumericalexpression;anynumberofvalidexpressions,separatedbycommas,canbeused

Astringexpressionmustbeenclosedinquotationmarks:

"StringExpression"

Anumericalexpressioncanbeformattedtospecifytheminimumnumberofcharacters,includingthedecimalpoint,andthenumberofdecimalplaces,tobeusedfortheoutput:

Expression:C:D

Where:C-minimumnumberofcharactersD-numberofdecimalplaces

Thedefaultoutputformatforanumericalexpressionistwodecimalplacesandaminimumofsevencharacters.

Ifthenumberofdecimalplacesinthenumericalexpressionismorethanthespecifiednumber,thevaluewillbewillberoundedofftothespecifiednumberofdecimalplaces.

Ifthenumberofcharactersintheoutputislessthanthespecifiedminimum,leadingspaceswillbeaddedtobringtheoutputtothespecifiedminimumvalue.

Example

MessageLog(.1);willdisplay0.10inthePowerLanguageEditorOutputLog,withthreeleadingspacesinserted

MessageLog(1.555555:6:3);willdisplay1.556inthePowerLanguageEditorOutputLog,withoneleadingspaceinserted

MessageLog("CurrentTimeis:",CurrentTime:5:0);willdisplaythestringexpression"CurrentTimeis:",followedbytheoutputoftheCurrentTime,withoneleadingspaceinserted,inthePowerLanguageEditorOutputLog

PrintSendsoneormorespecifiedexpressionstothePowerLanguageEditorOutputLogoranotheroutputtarget,ifspecified.Anycombinationofstring,true/false,numericalseries,ornumericalexpressionscanbespecified.

Print([OutputTarget],Expression1,Expression2,etc.)

ParameterinsidethesquarebracketsisoptionalParameters

OutputTarget-anoptionalparameter;specifiesanoutputtargetotherthenthePowerLanguageEditorOutputLog;theparametermustbefollowedbyacomma.

Therearetwooptionaloutputtargets:

Printer

Specifiesthedefaultprinterastheoutputtarget.

File("PathFilename")

Where:PathFilename-astringexpressionspecifyingthepathandfilename

SpecifiesanASCIIfileastheoutputtarget;ifthespecifiedfiledoesnotexist,thefilewillbecreated.

IfOutputTargetisnotspecified,theoutputwillbesenttothePowerLanguageEditorOutputLog.

Expression-astring,true/false,numericalseries,ornumericalexpression;anynumberofvalidexpressions,separatedbycommas,canbeused

Astringexpressionmustbeenclosedinquotationmarks:

"StringExpression"

Anumericalexpressioncanbeformattedtospecifytheminimumnumberofcharacters,includingthedecimalpoint,andthenumberofdecimalplaces,tobeusedfortheoutput:

Expression:C:D

Where:C-minimumnumberofcharactersD-numberofdecimalplaces

Thedefaultoutputformatforanumericalexpressionistwodecimalplacesandaminimumofsevencharacters.

Ifthenumberofdecimalplacesinthenumericalexpressionismorethanthespecifiednumber,thevaluewillbewillberoundedofftothespecifiednumberofdecimalplaces.

Ifthenumberofcharactersintheoutputislessthanthespecifiedminimum,leadingspaceswillbeaddedtobringtheoutputtothespecifiedminimumvalue.

Example

Print(.1);willprint0.10inthePowerLanguageEditorOutputLog,withthreeleadingspacesinserted

Print(1.555555:6:3);willprint1.556inthePowerLanguageEditorOutputLog,withoneleadingspaceinserted

Print(Printer,"PrintTest");willsendthestringexpression"PrintTest"tothedefaultprinter

Print(File("C:\test.txt"),CurrentDate,CurrentTime);willsavetheoutputofCurrentDateandCurrentTimetothetest.txtfileintherootdirectoryoftheC:harddrive

DefaultUsedinplotstatementstospecifyadefaultstyle.Defaultstylesaresetbytheuser.

FormoreinformationseePlot

Default

Example

Plottheclosingpriceusingthedefaultstyles(colorandwidth):

Plot1(Close,"Close",Default,Default,Default);

GetBackgroundColor

ReturnsanRGBcolornumberoralegacycolorvaluethatcorrespondtothebackgroundcolorofthechart.

GetBackgroundColor

Example

AssignanRGBcolornumber,correspondingtothebackgroundcolorofthechart,toValue1variable:

Value1=GetBackgroundColor;

Assignalegacycolorvalue,correspondingtothebackgroundcolorofthechart,toValue1variable:

Value1=GetBackgroundColor;

GetPlotBGColor

Returnsthenumericcolorvalueoftheplot(cell)backgroundinagrid.

GetPlotBGColor(PlotNum)

Where:PlotNum-numericalexpressionrepresentingplotnumber

Example

Setavariable,Value1,tothecellcolorofthePlot1background:

Value1=GetPlotBGColor(1);

GetPlotColor

ReturnsanRGBcolornumberoralegacycolorvaluethatcorrespondtothecolorofthespecifiedplot.

GetPlotColor(PlotNumber)

Where:PlotNumber-anumericalexpressionspecifyingtheplotnumber;plotnumbersrangefrom1to999

Example

AssignanRGBcolornumber,correspondingtothecolorofPlot1,toValue1variable:

Value1=GetPlotColor(1);

Assignalegacycolorvalue,correspondingtothecolorofPlot1,toValue1variable:

Value1=GetPlotColor(1);

GetPlotWidth

Returnstheplotlinewidthvalueofthespecifiedplot.Plotlinewidthvaluesrangefrom0to14.

GetPlotWidth(PlotNumber)

Example

AssigntheplotlinewidthvalueofPlot1toValue1variable:

Value1=GetPlotWidth(1);

I_getplotvalue

Getsthevaluecalculatedbyasignalthatistobeusedforplottingfromanindicator.Itcanbeconsideredasabridgebetweenasignalandanindicator.Usingi_setplotvalueandi_getplotvaluekeywordsmakesitpossibletoavoidcopyingthesamescriptforcalculationthesamevalueinbothindicatorandsignal.

i_getplotvalue(index)

Parameters

index-isthereferencenumber

1. i_getplotvaluecanbeusedinfunctionsandindicatorsifanysignalisappliedtothemainchart.

2. Valueswillbetransferredbetweeni_setplotvalueandi_getplotvalueONLYwithin1chartwindow,

3. i_setplotvalueandi_getplotvaluewillreturn0ifappliedtotheMarketScannerWindow,

4. i_setplotvalueandi_getplotvaluecannotbeusedwhilebacktestingaportfolio,

5. i_setplotvalueandi_getplotvaluecannotbereferredhistorically,

6. itispossibletouseunlimitedindexesfordatatransfer.

Plotintheindicatorthemaxdrawdownandopenequityvaluescalculatedbythesignalwithindexes111and112

plot1(i_getplotvalue(111),"MaxIDDrawdown");

plot2(i_getplotvalue(112),"OpenEquity");

I_setplotvalue

Setsthevaluecalculatedbyasignalthatistobeusedforplottingfromanindicator.Itcanbeconsideredasabridgebetweenasignalandanindicator.Usingi_setplotvalueandi_getplotvaluekeywordsmakesitpossibletoavoidcopyingthesamescriptforcalculationthesamevalueinbothindicatorandsignal.

i_setplotvalue(index,value)

Parameters

index-isthereferencenumber

value-isthevaluethatistobetransferred.

1. i_setplotvaluecanbeusedinsignals,functionsand

indicatorsifanysignalisappliedtothemainchart.

2. Valueswillbetransferredbetweeni_setplotvalueandi_getplotvalueONLYwithin1chartwindow,

3. i_setplotvalueandi_getplotvaluewillreturn0ifappliedtotheMarketScannerWindow,

4. i_setplotvalueandi_getplotvaluecannotbeusedwhilebacktestingaportfolio,

5. i_setplotvalueandi_getplotvaluecannotbereferredhistorically,

6. itispossibletouseunlimitedindexesfordatatransfer.

Setthemaxdrawdownandopenequityvaluescalculatedbythesignaltobetransferredintotheindicatorwithindexes111and112

i_setplotvalue(111,maxiddrawdown)

i_setplotvalue(112,netprofit+openpositionprofit)

NoPlotRemovesaspecifiedplotfromthecurrentbar.

Aconditionalplotthatisalreadydrawnwillremaineveniftheconditionsbecomenolongertruebeforethebarisclosed.NoPlotcanbeusedtoremovetheconditionalplotfromthecurrentbariftheconditionsarenolongertrue.

NoPlot(PlotNumber)

Example

TheexamplebelowusesNoPlotremovethePlotPaintBarplot"painted"overthechartsbarsforwhichtheHighpriceisnolongerlessthentheHighpriceofthepreviousbar:

IfHigh<High[1]ThenBeginPlotPaintBar(High,Low,"",Red);End

ElseBeginNoPlot(1);NoPlot(2);End;

WithoutNoPlot,chartsbarsforwhichaHighpricewasinitiallylessthentheHighpriceofthepreviousbarwouldremainpartiallypaintedevenifaHighpriceequaltoorgreaterthentheHighpriceofthepreviousbarwasreachedbeforethebarwasclosed.

PlotPlotsthespecifiednumericalorstringexpressiononachart,upto999differentplotscanbeusedsimultaneously.

Numerical:Plotoffset,name,color,andplotlinewidthcanbespecifiedbyusingtheoptionalparameters.

String:Abilitytoshowauser-definedtextmessageonthestatuslineofthechartorinthescanner.

Numerical:PlotN<[Offset]>(Expression<,"PlotName"<,PlotColor<,ScannerCellBackgroundColor<,LineWidth>>>>)

Text:PlotN("String")

Parameters

N-anumberusedtoidentifytheplot;plotnumberscanrangefrom1to999

Offset-anoptionalparameter;anumericalexpressionspecifyingtheplotoffset,inbars;apositivevaluewilldisplacetheplottotheleftalongthetimeaxis,andanegativevaluewilldisplacetheplottotherightalongthetimeaxis

Expression-thenumericalexpressiontobeplotted

PlotName-anoptionalparameter;assignsanametotheplot

PlotColor-anoptionalparameter;specifiestheplotcolorPlotcolorcanbespecifiedbyanumericalexpressionrepresentinganRGBcolornumberoralegacycolorvalue,byoneof17basecolorwords,orbythewordDefaulttospecifythecolorchosenbytheuser.InorderforPlotColortobeused,PlotNameparametermustalsobeused.

ScannerCellBackgroundColor-anoptionalparameter;setsthebackgroundcolorofthescannercellifthisplotisappliedtoascanner;usethewordDefault

tospecifythecolorchosenbytheuser.InorderforScannerCellBackgroundColortobeused,PlotNameandPlotColorparametersmustalsobeused.

LineWidth-anoptionalparameter;specifiestheplotlinewidth,rangingfrom1to14PlotlinewidthcanbespecifiedasanumericalexpressionorbythewordDefaulttospecifythelinewidthchosenbytheuser.InorderforLineWidthtobeused,PlotName,PlotColor,andScannerCellBackgroundColorparametersmustalsobeused.

String-texttobedisplayed

Example

Plottheclosingpriceusingthedefaultplotcolorandlinewidth:

Plot1(Close);

Plottheclosingpriceusingthedefaultplotcolorandlinewidth,andnametheplot"Close":

Plot1(Close,"Close",Default,Default,Default);

Plottheclosingprice,offsetbackby3bars,usingtheplotcolorofblue,usingcellbackgroundcolorofgreenifthisplotisappliedtoascanner,linewidthof3,andnametheplot"Close3barslater":

Plot1[3](Close,"Close3barslater",Blue,Green,3);

Plottheclosingprice,offsetforwardby3bars,usingtheRGBcolor2138336(Orange),andnametheplot"Close3barsago":

Plot1[-3](Close,"Close3barsago",2138336);

Plottheclosingpriceusingthelegacycolorvalueof4(Green)andnametheplot"Close":

[LegacyColorValue=True];Plot1(Close,"Close",4);

Showthetext"Attention!"onthestatusbarofthechartorinthescanner.

Plot1("Attention!");

Showthetext"Attention!"onthestatusbarofthechartorinthescanneriftheclosepriceisgreaterthan100.Ifclose>100thenPlot1("Attention!");

PlotPaintBarPlotsthespecifiednumericalexpressionsintheformofabarchart.

Plotname,color,andplotlinewidthcanbespecifiedbyusingtheoptionalparameters.

PlotPaintBarplotcanbesuperimposedontopofoneormorebarsofabarchart,effectively"painting"thebars.

PlotPaintBar(BarHigh,BarLow,BarOpen,BarClose<,"PlotName"<,PlotColor<,Default<,LineWidth>>>>)

Parameters

BarHigh,BarLow,BarOpen,BarClose-numericalexpressionsspecifyingtheHigh,Low,Open,&Closepricesforthebarstobeplotted;atleasttwooftheseparametersarerequired

PlotName-anoptionalparameter;assignsanametotheplot

PlotColor-anoptionalparameter;specifiestheplotcolorPlotcolorcanbespecifiedbyanumericalexpressionrepresentinganRGBcolornumberoralegacycolorvalue,byoneof17basecolorwords,orbythewordDefaulttospecifythecolorchosenbytheuser.InorderforPlotColortobeused,PlotNameparametermustalsobeused.

Default-anoptionalparameterreservedforfutureuse;shouldbespecifiedasDefault;useofthisparameterisrequiredinorderforLineWidthtobeused

LineWidth-anoptionalparameter;specifiestheplotlinewidth,rangingfrom1to14PlotlinewidthcanbespecifiedasanumericalexpressionorbythewordDefaulttospecifythelinewidthchosenbytheuser.InorderforLineWidthtobeused,PlotName,PlotColor,andDefaultparametersmustalsobeused.

PlotPaintBar(BarHigh,BarLow,BarOpen,BarClose);

istheequivalentof:

Plot1(BarHigh);Plot2(BarLow);Plot3(BarOpen);Plot4(BarClose);

InorderforthePlotPaintBarplottobedisplayedintheformofabarchart,theplottypeforeachPlotmustbeset,intheStylesectionoftheGeneraltaboftheFormatIndicatorwindow,toBarHigh,BarLow,LeftTick,andRightTick,respectively.

Example

PaintredthesebarsofanOHLCchartforwhichtheOpenpriceislessthentheOpenpriceofthepreviousbar:

IfOpen<Open[1]ThenPlotPaintBar(High,Low,Open,Close,"",Red);

PlotPBSameasthePlotPaintBar

SetPlotBGColorAssignsaspecifiedcolortothecellbackgroundfortheindicatedstudyplotforthedurationofthecurrentbar.

UseofSetBGPlotColoriseffectiveonlyfortheScanner.

SetPlotBGColor(PlotNumber,PlotColor)

Parameters

PlotNumber-anumericalexpressionspecifyingtheplotnumber;plotnumbersrangefrom1to999

PlotColor-anexpressionspecifyingthecellbackgroundcolorfortheindicatedplot.CellbackgroundcolorfortheindicatedplotcanbespecifiedbyanumericalexpressionrepresentinganRGBcolornumber,alegacycolorvalue,orbyoneof17basecolorwords.

Example

Assignthecolorofbluetotheindicatedcelloftheplot1forthedurationofthecurrentbar:

SetPlotBGColor(1,Blue);

AssignRGBcolor2138336(Orange)totheindicatedcelloftheplot1forthedurationofthecurrentbar:

Assignlegacycolor4(Green)totheindicatedcelloftheplot1forthedurationofthecurrentbar:

[LegacyColorValue=True];SetPlotBGColor(1,4);

SetPlotColor

Assignsaspecifiedcolortothespecifiedplotforthedurationofthecurrentbar.

SetPlotColor(PlotNumber,PlotColor)

Parameters

PlotNumber-anumericalexpressionspecifyingtheplotnumber;plotnumbersrangefrom1to999

PlotColor-anexpressionspecifyingtheplotcolor

PlotcolorcanbespecifiedbyanumericalexpressionrepresentinganRGBcolornumberoralegacycolorvalue,orbyoneof17basecolorwords.

Example

Assignthecolorofbluetoplot1forthedurationofthecurrentbar:

SetPlotColor(1,Blue);

AssignRGBcolor2138336(Orange)toplot1forthedurationofthecurrentbar:

Assignlegacycolor4(Green)toplot1forthedurationofthecurrentbar:

[LegacyColorValue=True];SetPlotColor(1,4);

SetPlotWidth

Assignsaspecifiedlinewidthtothespecifiedplotforthedurationofthecurrentbar.

SetPlotWidth(PlotNumber,LineWidth)

Where:PlotNumber-anumericalexpressionspecifyingtheplotnumber;plotnumbersrangefrom1to999LineWidth-anumericalexpressionspecifyingtheplotlinewidth;linewidthcanrangefrom1to14

Example

Assignaplotlinewidthof10toplot1forthedurationofthecurrentbar:

SetPlotWidth(1,10);

pmms_get_strategy_named_numReturnsanumericalvalue,indicatingthevalueofVariableNameofthestrategywithStrategyIndexnumber.

pmms_get_strategy_named_num(StrategyIndex,VariableName)

Parameters

StrategyIndex-numericvariable.

VariableName-stringvariable.

ThisfunctioncanonlybeusedinsignalsintendedtobeusedwiththePortfolioTrader.

Example

pmms_get_strategy_named_num(0,"CustomVar")

pmms_get_strategy_named_strReturnsastringvalue,indicatingthevalueofVariableNameofthestrategywithStrategyIndexnumber.

pmms_get_strategy_named_str(StrategyIndex,VariableName)

Parameters

Example

pmms_get_strategy_named_str(0,"CustomStr")

pmms_set_strategy_named_numThisfunctionsetsthevalueofVariableNameofthestrategywithStrategyIndexnumber.

pmms_set_strategy_named_num(StrategyIndex,VariableName,VariableValue)

Parameters

VariableValue-numericvariable.

Example

pmms_set_strategy_named_num(0,"CustomVar",5)

pmms_set_strategy_named_strThisfunctionsetsthestringvalueofVariableNameofthestrategywithStrategyIndexnumber.

pmms_set_strategy_named_str(StrategyIndex,VariableName,VariableValue)

Parameters

VariableValue-stringvariable.

Example

pmms_set_strategy_named_str(0,"CustomStr","buy")

pmms_strategies_allow_entries_allThisfunctionallowsallthestrategiestoopenpositions.

pmms_strategies_allow_entries_all

Example

pmms_strategies_allow_entries_all

pmms_strategies_countReturnsanumericalvalue,indicatingthenumberoftradingstrategies(whichisequaltonumberofdownloadedinstrumentsthataretraded).

pmms_strategies_count

Example

pmms_strategies_count

pmms_strategies_deny_entries_allThisfunctiondeniesallthestrategiestoopenpositions(entryorderswillbeexcludedfromRAWorderscollection).

pmms_strategies_deny_entries_all

Example

pmms_strategies_deny_entries_all

pmms_strategies_get_by_symbol_nameReturnsanindexofthestrategybasedoninstrumentname(-1,iftheinstrumentisnotfound).Ifseveralstrategiesareappliedtothesameinstrument,thenthenumberofoneofthesestrategieswillbereturned.

pmms_strategies_get_by_symbol_name(SymbolName)

Parameters

SymbolName-stringvariable.

Example

Value1=pmms_strategies_get_by_symbol_name("MSFT");

pmms_strategies_in_long_countReturnsanumericalvalue,indicatingthenumberofstrategieswithopenlongposition.Acceptsoneparameter-aonedimensionaldynamicalarray.Thisarrayisfilledwiththeindexnumbersofthestrategiesthathaveanopenlongpositionatthemomentofthestrategycalculation.

pmms_strategies_in_long_count(indexesArray)

Parameters

indexesArray-arrayvariable.

Example

var:positionsLong(0);

array:strategyIndexes[](0);

positionsLong=pmms_strategies_in_long_count(strategyIndexes);

pmms_strategies_in_positions_countReturnsanumericalvalue,indicatingthenumberofstrategieswithopenposition.Acceptsoneparameter-aonedimensionaldynamicalarray.Thisarrayisfilledwiththeindexnumbersofthestrategiesthathaveanopenpositionatthemomentofthestrategycalculation.

pmms_strategies_in_positions_count(indexesArray)

Parameters

Example

var:positions(0);

positions=pmms_strategies_in_positions_count(strategyIndexes);

pmms_strategies_in_short_countReturnsanumericalvalue,indicatingthenumberofstrategieswithopenshortposition.Acceptsoneparameter-aonedimensionaldynamicalarray.Thisarrayisfilledwiththeindexnumbersofthestrategiesthathaveanopenshortpositionatthemomentofthestrategycalculation.

pmms_strategies_in_short_count(indexesArray)

Parameters

Example

var:positionsShort(0);

positionsShort=pmms_strategies_in_short_count(strategyIndexes);

pmms_strategies_pause_allThisfunctionpausesordersendingforallstrategiesoftheportfolio.

pmms_strategies_pause_all

Example

pmms_strategies_pause_all

pmms_strategies_resume_allThisfunctionresumesordersendingforallstrategiesoftheportfolio.

pmms_strategies_resume_all

Example

pmms_strategies_resume_all

pmms_strategies_set_status_for_allThisfunctionsetsatext(string)statusforallstrategiesoftheportfolio(statusisindicatedintheCustomTextcolumnofPortfolioReal-TimeWindow).

pmms_strategies_set_status_for_all(Status)

Parameters

Status-stringvariable.

Example

pmms_strategies_set_status_for_all("Calculating")

pmms_strategy_allow_entriesThisfunctionallowsentryordersforstrategywithStrategyIndexnumber.

pmms_strategy_allow_entries(StrategyIndex)

Parameters

Example

pmms_strategy_allow_entries(0)

pmms_strategy_allow_exitsThisfunctionallowsexitordersforstrategywithStrategyIndexnumber.

pmms_strategy_allow_exits(StrategyIndex)

Parameters

Example

pmms_strategy_allow_exits(0)

pmms_strategy_allow_exit_from_longThesameaspmms_strategy_allow_exits,butappliedforexitsfromlongentriesonly.

pmms_strategy_allow_exit_from_shortThesameaspmms_strategy_allow_exits,butappliedforexitsfromshortentriesonly.

pmms_strategy_allow_long_entriesThesameaspmms_strategy_allow_entries,butappliedforlongentriesonly.

pmms_strategy_allow_short_entriesThesameaspmms_strategy_allow_entries,butappliedforshortentriesonly.

pmms_strategy_close_positionThisfunctionclosespositionofthestrategywithIndexnumberwithmarketorder(ordersgeneratedbythestrategywillbedeletedfromRawOrderscollection).

pmms_strategy_close_position(Index)

Parameters

Index-numericvariable.

Example

pmms_strategy_close_position(0)

pmms_strategy_currentcontractsReturnsanumericalvaluerepresentingnumberofcontractsofthepositionopenedbystrategywithStrategyIndexnumber.

pmms_strategy_currentcontracts(StrategyIndex)

Parameters

Example

Value1=pmms_strategy_currentcontracts(0);

pmms_strategy_deny_entriesThisfunctiondeniesentryordersforstrategywithStrategyIndexnumber(entryorderswillbedeletedfromRawOrderscollection).

pmms_strategy_deny_entries(StrategyIndex)

Parameters

Example

pmms_strategy_deny_entries(0)

pmms_strategy_deny_exitsThisfunctiondeniesexitordersforstrategywithStrategyIndexnumber(exitorderswillbedeletedfromRawOrderscollection).

pmms_strategy_deny_exits(StrategyIndex)

Parameters

Example

pmms_strategy_deny_exits(0)

pmms_strategy_deny_exit_from_longThesameaspmms_strategy_deny_exits,butappliedforexitsfromlongentriesonly.

pmms_strategy_deny_exit_from_shortThesameaspmms_strategy_deny_exits,butappliedforexitsformshortentriesonly.

pmms_strategy_deny_long_entriesThesameaspmms_strategy_deny_entries,butappliedforlongentriesonly.

pmms_strategy_deny_short_entriesThesameaspmms_strategy_deny_entries,butappliedforshortentriesonly.

pmms_strategy_entrypriceReturnsanumericalvaluerepresentinganaverageentrypriceofthepositionopenedbythestrategywithStrategyIndexnumber.

pmms_strategy_entryprice(StrategyIndex)

Parameters

Example

Value1=pmms_strategy_entryprice(0);

pmms_strategy_get_entry_contractsReturnsthenumberofcontractsoftheentryorderofthestrategywithStrategyIndexnumber.

pmms_strategy_get_entry_contracts(StrategyIndex)

Parameters

Example

pmms_strategy_get_entry_contracts(0)

pmms_strategy_is_pausedReturnstrue/falsevalueindicatingifordersendingispausedforthestrategywithStrategyIndexnumber.

pmms_strategy_is_paused(StrategyIndex)

Parameters

Example

Condition1=pmms_strategy_is_paused(0);

pmms_strategy_marketpositionReturnsanumericalvaluerepresentingmarketpositionofthestrategywithStrategyIndexnumber.

pmms_strategy_marketposition(StrategyIndex)

Parameters

Example

Value1=pmms_strategy_marketposition(0);

pmms_strategy_maxiddrawdownReturnsanumericalvaluerepresentingmaxdrawdownofthestrategywithStrategyIndexnumber.

pmms_strategy_maxiddrawdown(StrategyIndex)

Parameters

ThevalueisreturnedinthecurrencyspecifiedinPortfolioTrader:PortfolioSettings->BaseCurrency.

Example

Value1=pmms_strategy_maxiddrawdown(0);

pmms_strategy_netprofitReturnsanumericalvaluerepresentingnetprofitofthestrategywithStrategyIndexnumber.

pmms_strategy_netprofit(StrategyIndex)

Parameters

Example

Value1=pmms_strategy_netprofit(0);

pmms_strategy_openprofitReturnsanumericalvaluerepresentingunrealizedprofit/lossofthestrategywithStrategyIndexnumber.

pmms_strategy_openprofit(StrategyIndex)

Parameters

Example

Value1=pmms_strategy_openprofit(0);

pmms_strategy_pauseThisfunctiondeniesordersendingforthestrategywithStrategyIndexnumber(allordersofthestrategywillbedeletedfromRawOrdersCollection).

pmms_strategy_pause(StrategyIndex)

Parameters

Example

pmms_strategy_pause(0);

pmms_strategy_resumeThisfunctionallowsordersendingforthestrategywithStrategyIndexnumber(allordersofthestrategywillbedeletedfromRawOrdersCollection).

pmms_strategy_resume(StrategyIndex)

Parameters

Example

pmms_strategy_resume(0);

pmms_strategy_riskcapitalReturnsanumericalvaluerepresentingamountofmoneywithheldasariskcapitalfortheopenpositionofthestrategywithStrategyIndexnumber.

pmms_strategy_riskcapital(StrategyIndex)

Parameters

Example

Value1=pmms_strategy_riskcapital(0);

pmms_strategy_set_entry_contractsThisfunctionsetsthenumberofcontractsforentryordersofthestrategywithStrategyIndexnumber(sizecalculatedbythestrategyitselfwillbeignored).Tousetheordersizecalculatedbythestrategyitselfsetcontractsparameterto-1.

pmms_strategy_set_entry_contracts(StrategyIndex,Contracts)

Parameters

Contracts-numericvariable.

Example

pmms_strategy_set_entry_contracts(0,5)

pmms_strategy_set_statusThisfunctionsetsatext(string)statusforthestrategywithStrategyIndexnumberoftheportfolio(statusisindicatedintheCustomTextcolumnofPortfolioReal-TimeWindow).

pmms_strategy_set_status(StrategyIndex,Status)

Parameters

Example

pmms_strategy_set_status("Long");

pmms_strategy_symbolReturnsastringvaluerepresentingthenameofinstrumenttowhichthesignalofthestrategywithStrategyIndexnumberisapplied.

pmms_strategy_symbol(StrategyIndex)

Parameters

Example

pmms_strategy_symbol(0);

pmm_get_global_named_numReturnsanumericalvalue,indicatingtheglobalnumericalvaluewithVariableNamename.

pmm_get_global_named_num(VariableName)

Parameters

Example

Value1=pmm_get_global_named_num("GlobalVar");

pmm_get_global_named_strReturnstheglobalstringvaluewithVariableNamename.

pmm_get_global_named_str(VariableName)

Parameters

Example

pmm_get_global_named_str("GlobalStr");

pmm_get_my_named_numReturnsanumericalvalue,indicatingthevalueofVariableNameofthecurrentstrategy.

pmm_get_my_named_num(VariableName)

Parameters

Example

Value1=pmm_get_my_named_num("CustomVar");

pmm_get_my_named_strReturnsastringvalue,indicatingthevalueofVariableNameofthecurrentstrategy.

pmm_get_my_named_str(VariableName)

Parameters

Example

pmm_get_my_named_str("CustomStr");

pmm_set_global_named_numThisfunctionsetstheglobalnumericvaluewithVariableNamename.

pmm_set_global_named_num(VariableName,VariableValue)

Parameters

Example

pmm_set_global_named_num("GlobalVar",3);

pmm_set_global_named_strThisfunctionsetstheglobalstringvaluewithVariableNamename.

pmm_set_global_named_str(VariableName,VariableValue)

Parameters

Example

ifmarketposition>0thenpmm_set_global_named_str("GlobalStr",symbolname+"isLong");

pmm_set_my_named_numThisfunctionsetsthevalueofVariableNameofthecurrentstrategy.

pmm_set_my_named_num(VariableName,VariableValue)

Parameters

Example

pmm_set_my_named_num("MarketPosition",marketposition);

pmm_set_my_named_strThisfunctionsetsthestringvalueofVariableNameofthecurrentstrategy.

pmm_set_my_named_str(VariableName,VariableValue)

Parameters

Example

ifmarketposition>0thenpmm_set_my_named_str("Position","Long");

pmm_set_my_statusThisfunctionsetsatext(string)statusforthecurrentstrategyoftheportfolio(statusisindicatedintheCustomTextcolumnofPortfolioReal-TimeWindow).

pmm_set_my_status(Status)

Parameters

Example

ifmarketposition<0thenpmm_set_my_status("Short");

Portfolio_GrossLossReturnsanegativenumericalvalue,indicatingthetotalcurrencyvalueofallcompletedlosingtradesforaportfolio.

Portfolio_GrossLoss

Example

Portfolio_GrossLosswillreturnavalueof-50iftherewereatotaloffourlosingtrades,at10,5,20,and15

Portfolio_GrossLosswillreturnavalueof0ifnolosingtradeswerecompletedduringtheentiretradingperiod

Portfolio_GrossProfitReturnsanumericalvalue,indicatingthetotalcurrencyvalueofallcompletedwinningtradesforaportfolio.

Portfolio_GrossProfit

Example

Portfolio_GrossProfitwillreturnavalueof50iftherewereatotaloffourwinningtrades,at10,5,20,and15

Portfolio_GrossProfitwillreturnavalueof0ifnowinningtradeswerecompletedduringtheentiretradingperiod

Portfolio_InvestedCapitalReturnsabsolutevalueindicatingtheamountofcashassetsinvestedinportfoliosecuritiesonthemomentofstrategycalculation.

Portfolio_InvestedCapital

Example

Portfolio_InvestedCapitalwillreturnavalueof100000iftheamountofcashassetsinvestedinportfoliosecuritiesonthemomentofstrategycalculationis100000unitsoftheselectedcurrency(e.g.therearethreeopenpositions:50000long,20000longand30000short).

Portfolio_MaxIDDrawdownReturnsanegativenumericalvalue,indicatingthelargestdeclineinequityfortheentireportfolioduringthetradingperiod.

Portfolio_MaxIDDrawdown

Example

Portfolio_MaxIDDrawdownwillreturnavalueof-500ifthelargestdeclineinequityduringtheentiretradingperiodwas¤500

Portfolio_NetProfitReturnsanumericalvalue,indicatingthetotalcurrencyvalueofallcompletedtradesforaportfolio.

Portfolio_NetProfit

Example

Portfolio_NetProfitwillreturnavalueof20iftherewerewinningtradesat25and10,andlosingtradesat5and10

Portfolio_NetProfitwillreturnavalueof-15iftherewerewinningtradesat10and5,andlosingtradesat20and10

Portfolio_NetProfitwillreturnavalueof0notradeswerecompletedduringtheentiretradingperiod

Portfolio_NumLossTradesReturnsanumericalvalue,indicatingthenumberofallcompletedlosingtradesforaportfolio.

Portfolio_NumLossTrades

Example

Portfolio_NumLossTradeswillreturnavalueof5iftherewereatotaloffivecompletedlosingtrades

Portfolio_NumLossTradeswillreturnavalueof0ifnolosingtradeswerecompletedduringtheentiretradingperiod

Portfolio_NumWinTradesReturnsanumericalvalue,indicatingthenumberofallcompletedwinningtradesforaportfolio.

Portfolio_NumWinTrades

Example

Portfolio_NumWinTradeswillreturnavalueof5iftherewereatotaloffivecompletedwinningtrades

Portfolio_NumWinTradeswillreturnavalueof0ifnowinningtradeswerecompletedduringtheentiretradingperiod

Portfolio_PercentProfitReturnsanumericalvalue,indicatingthepercentageofwinningtradesinalltradescompletedforaportfolio.

Portfolio_PercentProfit

Example

Portfolio_PercentProfitwillreturnavalueof70ifsevenoutofthetotalof10completedtradeswerewinningtrades

Portfolio_StrategyDrawdownReturnsanegativenumericalvalue,indicatingthecurrentdeclineinequityfortheentireportfoliofromthepeakvaluefortheentiretradingperiod.

Portfolio_StrategyDrawdown

Example

Portfolio_StrategyDrawdownwillreturnavalueof-100ifthecurrentdeclineinequityfromthepeakvalueis¤100

Portfolio_TotalTradesReturnsanumericalvalue,indicatingthetotalnumberofallcompletedtradesforaportfolio.

Portfolio_TotalTrades

Example

Portfolio_TotalTradeswillreturnavalueof5iftherewereatotaloffivecompletedtrades

Portfolio_TotalTradeswillreturnavalueof0ifnotradeswerecompletedduringtheentiretradingperiod

Portfolio_CalcMaxPotentialLossForEntryCalculatesandreturnsmaximumpotentialloss(notincludingmargin,commisionorslippage)ifuserenteredthepositionwiththenumberofContractsandPriceofentry.

Portfolio_CalcMaxPotentialLossForEntry(Side<,Contracts<,Price>>);

Parameters

Sideisanumericalexpressionspecifyingtheentrytype(e.g.1Longentryor-1Shortentry).

Contractsisanoptionalparameterspecifyingthenumberofcontracts.IftheContractsparameterisnotspecified,thenthenumberofcontractsindicatedintheFormatSettingsdialogwindowunderthePropertiestabisusedbydefault.

Priceisanoptionalparameterspecifyingthepricevalue.IfthePriceparameterisnotspecified,thentheClosepricevalueofthecurrentbarwillbeusedbydefault.ThisparametercanberoundeddownifenteredaShortpositionorroundedupifenteredaLongposition.

Example

Portfolio_CalcMaxPotentialLossForEntry(0,25,High)willreturnavalueof0,sincetheparameterSide=0

Portfolio_CalcMaxPotentialLossForEntry(1,100,Close)willreturnthemaximumpotentialloss(notincludingmargin,commisionorslippage)ifuserenteredaLongpositionfor100contractsattheCloseprice.

Portfolio_CalcMaxPotentialLossForEntry(-1,5,Open)willreturnthemaximumpotentialloss(notincludingmargin,commisionorslippage)ifuserenteredaShortpositionfor5contractsatOpenprice.

Portfolio_CalcMaxPotentialLossForEntry(1)willreturnthemaximumpotentialloss(notincludingmargin,commisionorslippage)iftheuserenteredaLongpositionforanumberofcontractsindicatedintheFormatSettingsdialogwindowunderthePropertiestabatCloseprice.

Portfolio_CurrentEntries

Returnsanumericalvalue,indicatingthecombinednumberofentriescurrentlyopenwithinaportfolio.

Portfolio_CurrentEntries

Example

Assignavalue,indicatingthecombinednumberofentriescurrentlyopenwithinaportfolio,toValue1variable:

Value1=Portfolio_CurrentEntries;

Portfolio_MaxOpenPositionPotentialLossReturnsavalueindicatingthecombinedpotentialloss(notincludingmargin,commisionorslippage)forthetradedsymbol'sopenpositionwithintheportfolio.

SetStopPosition;

SetStopLoss(Portfolio_MaxOpenPositionPotentialLoss);

Example

value1=Portfolio_MaxOpenPositionPotentialLoss;

ifvalue1<>0thenbegin

SetStopPosition;

SetStopLoss(value1);

Portfolio_MaxOpenPositionPotentialLosswillreturnavalueof0iftherearecurrentlynoopenpositionswithinaportfolio.

Portfolio_MaxOpenPositionPotentialLosswillreturnavalueof100ifthecombinedpotentiallossforallopenpositionswithinaportfoliois¤100sincethepositionswereentered.

Portfolio_OpenPositionProfit

Returnsanumericalvalue,indicatingthecurrentcombinedprofitorlossforallopenpositionswithinaportfolio.

Portfolio_OpenPositionProfit

Example

Portfolio_OpenPositionProfitwillreturnavalueof0iftherearecurrentlynoopenpositionswithinaportfolio

Portfolio_OpenPositionProfitwillreturnavalueof100ifthecombinedvalueofallopenpositionswithinaportfoliohasincreasedby¤100sincethepositionswereentered

Portfolio_OpenPositionProfitwillreturnavalueof-50ifthecombinedvalueofallopenpositionswithinaportfoliohasdecreasedby¤50sincethepositionswereentered

Portfolio_SetMaxPotentialLossPerContractRedefinesthevaluesfortheindicatedsymbol.Thevaluesinthe¤boxiftheAbsoluteMaxPotentialLossoptionisselectedorthevaluesinthe%boxiftheMaxPotentialLossisselected.

ThenewlysetvalueisvalidduringthestrategycalculationoruntilthePortfolio_SetMaxPotentialLossPerContractisrequestedagainassigninganewvalue.

Portfolio_SetMaxPotentialLossPerContract(NewValue);

Parameters

NewValueisanumericalvaluethatcanbe:

anabsolutevalueintherange[-100,-0.001];definespercentageofthemaximumpotentiallosspercontract.(MaxPotentialLoss:%)avalueintherange[0.001,1e+29];definesthemaximumpotentiallosspercontractintheselectedcurrency.(AbsoluteMaxPotentialLoss:¤)equal0;inthiscasethevalueenteredintheFormatSettingsdialogwindowunderthePortfolioSettingstabisused.

Portfolio_SetMaxPotentialLossPerContractreturns:

Trueifthevalueisinoneoftherangesindicatedabove.Redefiningisconsideredtobesuccesfull.Falseiftheifthevalueisoutoftherangesindicatedabove.RedefiningisconsideredunsuccessfulandtheMaxPotentialLossvalueisunchanged.

ThevalueisreturnedinthecurrencyspecifiedinPortfolioTrader:Portfolio

Settings->BaseCurrency.

Example

If"MSFT"=SymbolNamethenPortfolio_SetMaxPotentialLossPerContract(-10);thenewvalueof-10isassignedforthesymbol"MSFT"onlyifsuchsymbolisexistintheportfolio.

Portfolio_SetMaxPotentialLossPerContract(-5);redefinesthepercentagevalueofthemaximumpotentiallosspercontractfor5%.

Portfolio_SetMaxPotentialLossPerContract(200);redefinesthemaximumpotentiallosspercontractfor¤200.

PortfolioEntriesPriorityAssignsaprioritytoeachentryorderwithinaportfolio.

Ifexecutionofallentriesgeneratedforaportfoliowouldcausethecapitallimitstobeexceeded,theentrieswiththehighestprioritywillreceivepreference,whiletheentrieswiththelowestprioritywillnotbeexecuted.

IfPortfolioEntriesPriorityisnotspecified,theentrieswillbeexecutedaccordingtotheorderthesymbolsarelistedinthesymbolgridofthePortfolioTrader.

PortfolioEntriesPriority=Priority

Where:Priority-anumericalexpressionspecifyingtheentryorderexecutionpriority;agreatervalueindicatesahigherpriority

Example

Assignhigherexecutionprioritytoentryordersforsymbolswithlowershareprices:

PortfolioEntriesPriority=(-Close);

Portfolio_GetMarginPerContractReturns:

anumericalvalueindicatedinthe%ofcontractcostboxmultipliedby-1,iftheMarginvalueoptionisselected;or:thesamevalueasareservedwordMarginiftheAbsoluteMarginValueoptionisselected.

Portfolio_GetMarginPerContract

Parameters

TheabsolutemarginvalueisreturnedinthecurrencyspecifiedinPortfolioTrader:PortfolioSettings->BaseCurrency.

Example

Portfolio_GetMarginPerContractwillreturnavalueof0ifAbsoluteMarginValueoptionisselectedandthemargindoesnotexistintheQuoteManagersymbolsettings.Notallofthesecuritiescanbeboughtonmargin.Themarginvaluecanbereturnedforfuturesoroptions.

Portfolio_GetMarginPerContractwillreturnavalueof25ifAbsoluteMarginValueoptionisselectedandthemarginboxintheEditSymboldialogwindowunderFuturetabinQuoteManagercontainsthevalueof25.

Portfolio_GetMarginPerContractwillreturnavalueof-10iftheMarginValueoptionisselectedandthe%ofcontractcostboxcontainsthevalueof10.

Portfolio_GetMaxPotentialLossPerContractReturns:

anumericalvalueindicatedinthe%boxmultipliedby-1,iftheMaxPotentialLossoptionisselectedintheFormatSettingsdialogwindowunderthePortfolioSettingstab;or:anumericalvalueindicatedintheAbsoluteMaxPotentialLossoptionboxintheFormatSettingsdialogwindowunderthePortfolioSettingstab.

Portfolio_GetMaxPotentialLossPerContract

TheabsolutemaxpotentiallossvalueisreturnedinthecurrencyspecifiedinPortfolioTrader:PortfolioSettings->BaseCurrency.

Example

Portfolio_GetMaxPotentialLossPerContractwillreturn-5iftheMaxPotentialLossoptionisselectedand%boxvalueis5underthePortfolioSettingstabintheFormatSettingsdialogwindow.

Portfolio_GetMaxPotentialLossPerContractwillreturn0.001iftheAbsoluteMaxPotentialLossoptionisselectedand¤boxvalueis0.001underthePortfolioSettingstabintheFormatSettingsdialogwindow.

Portfolio_MaxRiskEquityPerPosPercentReturnstheMax%ofEquityatRiskperPositionnumericalvaluesetbytheuserinthePortfolioSettingstabofthePortfolioTraderFormatSettingswindow.

Portfolio_MaxRiskEquityPerPosPercent

Example

Portfolio_MaxRiskEquityPerPosPercentwillreturntheMax%ofEquityatRiskperPositionnumericalvaluesetbytheuser

Portfolio_TotalMaxRiskEquityPercentReturnstheequityExposure%numericalvaluesetbytheuserinthePortfolioSettingstabofthePortfolioTraderFormatSettingswindow.

Portfolio_TotalMaxRiskEquityPercent

Example

Portfolio_TotalMaxRiskEquityPercentwillreturntheequityExposure%numericalvaluesetbytheuser.

AskSizeReturnsanumericalvalueindicatingthecurrentbestAskvolumeforthesymbolthatthestudyisappliedto.

AskSize

QuoteFieldscannotbereferencedhistorically.

Example

AskSizewillreturnthecurrentbestAskvolume

BidSizeReturnsanumericalvalueindicatingthecurrentbestBidvolumeforthesymbolthatthestudyisappliedto.

BidSize

Example

BidSizewillreturnthecurrentbestBidvolume

CurrentOpenIntReturnsanumericalvalueindicatingthelastknownopeninterestforthesymbolthatthestudyisappliedto.

CurrentOpenInt

Example

CurrentOpenIntwillreturnthelastknownopeninterest

DailyCloseReturnsanumericalvalueindicatingthemostrecentCloseprice.

DailyClose

Example

DailyClosewillreturnthemostrecentCloseprice

DailyHighReturnsanumericalvalueindicatingtheHighpriceforthecurrenttradingsession.

DailyHigh

Example

DailyHighwillreturntheHighpriceforthecurrenttradingsession

DailyLowReturnsanumericalvalueindicatingtheLowpriceforthecurrenttradingsession.

DailyLow

Example

DailyLowwillreturntheLowpriceforthecurrenttradingsession

DailyOpenReturnsanumericalvalueindicatingtheopeningpriceforthecurrenttradingsession.

DailyOpen

Example

DailyOpenwillreturntheOpenpriceforthecurrenttradingsession

DailyVolumeReturnsanumericalvalueindicatingthecurrenttotaltradevolumeforthetradingsession.

DailyVolume

Example

DailyVolumewillreturnthecurrenttotaltradevolume

DescriptionReturnsastringexpressioncontainingthedescriptionforthesymbolthatthestudyisappliedto;ifnodescriptionisavailable,ablank("")stringexpressionwillbereturned.

Description

Example

Descriptionwillreturn"GOOGLEINC"forGoogle

ExchListedReturnsastringexpressioncontainingtheexchangenameforthesymbolthatthestudyisappliedto.

ExchListed

Example

ExchListedwillreturn"NASD"forGoogle

ExchListedwillreturn"CME"forE-miniS&P;500

InsideAskReturnsanumericalvalueindicatingthecurrentbestAskforthesymbolthatthestudyisappliedto.

InsideAsk

Example

InsideAskwillreturnthecurrentbestAsk

InsideBidReturnsanumericalvalueindicatingthecurrentbestBidforthesymbolthatthestudyisappliedto.

InsideBid

Example

InsideBidwillreturnthecurrentbestBid

LastReturnsanumericalvalueindicatingthepriceofthelastcompletedtrade.

Example

Lastwillreturnthepriceofthelasttrade

PrevCloseReturnsanumericalvalueindicatingtheclosingpriceoftheprevioustradingsession.

PrevClose

Example

PrevClosewillreturntheCloseoftheprevioustradingsession

q_AskRetainedforbackwardcompatibility;replacedwithInsideAsk.

q_asksizeRetainedforbackwardcompatibility;replacedwithAskSize.

q_BidRetainedforbackwardcompatibility;replacedwithInsideBid.

q_bidsizeRetainedforbackwardcompatibility;replacedwithBidSize.

q_BigPointValueRetainedforbackwardcompatibility;replacedwithBigPointValue.

q_DateRetainedforbackwardcompatibility;replacedwithTradedDate.

q_ExchangeListedRetainedforbackwardcompatibility;replacedwithExchListed.

q_LastRetainedforbackwardcompatibility;replacedwithLast.

q_OpenInterestRetainedforbackwardcompatibility;replacedwithCurrentOpenInt.

q_PreviousCloseRetainedforbackwardcompatibility;replacedwithPrevClose.

q_TimeRetainedforbackwardcompatibility;replacedwithTradeTime.

q_Time_DtReturnsadouble-precisiondecimalDateTimevalueindicatingcurrenttimefromthestatusline.

q_Time_Dt

Example

q_Time_Dtwillreturnavalueof39448.25000000for6:00AMonJanuary1st,2008

q_Time_sSameasq_Time.

TimeisindicatedinHHmmssformat.

q_TotalVolumeRetainedforbackwardcompatibility;replacedwithDailyVolume.

q_tradevolumeRetainedforbackwardcompatibility;sameasTradeVolume.

RTSymbolSameastheRTSymbolName.

RTSymbolNameReturnsastringexpressioncontainingthenameofthereal-timesymbolthatthestudyisappliedtoincasethemergingoptionisenabled.IfthemergingoptionisdisabledreturnsthesamevalueastheNameproperty.Incaseofacustomfuturesinstrumentthenameofthelastcontractisreturned.

SeealsoGetRTSymbolName

RTSymbolName

Example

RTSymbolNamewillreturn"GOOG"forGoogleifthemergingoptionisenabledandGoogleisconfiguredasthereal-timeinstrument.

SymbolSameastheSymbolName.

SymbolNameReturnsastringexpressioncontainingthenameofthesymbolthatthestudyisappliedto.

SeealsoGetSymbolName

SymbolName

Example

SymbolNamewillreturn"GOOG"forGoogle

TradeDate

Returnsanumericalvalueindicatingthedateofthemostrecentpricefieldupdateforthesymbol.ThedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

TradeDate

Example

TradeDatewillreturnavalueof1071030forOctober30th,2007

TradeDatewillreturnavalueof990402forApril2th,1999

TradeTime

Returnsanumericalvalueindicatingthetimeofthemostrecentpricefieldupdateforthesymbol.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

TradeTime

Example

TradeTimewillreturnavalueof1015for10:15AM

TradeTimewillreturnavalueof1545for3:45PM

TradeVolumeReturnsanumericalvalueindicatingthevolumeofLastPrice.InformationistakenfromtheStatusLine.

TradeVolume

Example

TradeVolumewillreturnthevalueof5ifLastSizewas5.

AutoSessionReturns0andisusedasanargumentinsessioninformationfunctions.

RegularSessionReturns1andisusedasanargumentinsessioninformationfunctions.

Sess1EndTimeThiswordisretainedforbackwardcompatibility.

Sess1FirstBarTimeReturnstheFirstbar'stimeforthefirstsessionofthetradingdayin24-hourformat.PleasenotethattheTimeZonesettingaffectsthevaluereturned.

Example

Sess1FirstBarTimereturns0945whenappliedtoMSFTdatawitha15-minuteinterval

Sess1FirstBarTimereturns0835whenappliedtoE-miniS&P500;Datawitha5-minuteinterval

Sess1StartTimeThiswordisretainedforbackwardcompatibility.

Sess2EndTimeThiswordisretainedforbackwardcompatibility.

Sess2FirstBarTimeReturnstheFirstbar stimeforthesecondsessionofthetradingdayin24-hourformat.PleasenotethattheTimeZonesettingaffectsthevaluereturned.

Example

Sess2FirstBarTimereturns1725whenappliedtoUSTreasuryBondDatawitha5-minuteinterval.

Sess2StartTimeThiswordisretainedforbackwardcompatibility.

SessionCountReturnsthenumberofsessionsforthetradingweek.

SessionCount(SessionType);

Where:SessionType-anumericalexpression:0=AutoDetect,1=RegularSession*

*CustomSessionsparameterswillbeusedifselectedinQuoteManager.

Example

Inthisexample,wehaveassignedtoValue1thetotalnumberofsessionsfortheweekinthecurrentbar.

Value1=SessionCount(0);

Inthisexample,wehaveassignedtoValue1thetotalnumberofregularsessionsfortheweekinthecurrentbar.

Value1=SessionCount(1);

SessionCountMSReturnsthenumberofmergedsessionsforthetradingweek.Mergedsessionsaresessionsbeginningattheearlieststarttimeforallsymbolsandendingatthelatestendtimeforallsymbolseachtradingday.

Example

Inthisexample,wehaveassignedtoValue1thetotalnumberofmergedsessionsfortheweekinthecurrentchart:

Value1=SessionCountMS

SessionEndDayReturnsanumericalvalueindicatingthedayoftheweekthatthespecifiedsessionends,where0=Sunday,1=Monday,etc.

SessionEndDay(SessionType,SessionNum)

Where:SessionType-anumericalexpression:0=AutoDetect,1=RegularSession*SessionNum-anumericalexpressionspecifyingtheSessionNumber

Example

Assignavalue,indicatingthedayoftheweekthatthe4thregularsessionends,toValue1variable:

Value1=SessionEndDay(1,4)

SessionEndDayMSReturnsanumericalvalueindicatingthedayoftheweekthespecifiedmergedsessioninamulti-dataserieschartends,where0=Sunday,1=Monday,etc.

Mergedsessionextendsfromtheearlieststarttimetothelatestendtimeofallsessionsmerged.

SessionEndDayMS(SessionNum)

Where:SessionNum-anumericalexpressionspecifyingtheSessionNumber

Example

Assignavalue,indicatingthedayoftheweekthatthe4thmergedsessionends,toValue1variable:

Value1=SessionEndDayMS(4);

SessionEndTime

Returnsanumericalvalue,indicatingthetimeofthedaythatthespecifiedsessionends.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

SessionEndTime(SessionType,SessionNum)

Example

Assignavalue,indicatingthetimeofthedaythatthe4thregularsessionends,toValue1variable:

Value1=SessionEndTime(1,4);

SessionEndTimeMS

Returnsanumericalvalue,indicatingthetimeofthedaythatthespecifiedmergedsessioninamulti-dataserieschartends.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

SessionEndTimeMS(SessionNum)

Example

Assignavalue,indicatingthetimeofthedaythatthe4thmergedsessionends,toValue1variable:

Value1=SessionEnd(4);

SessionStartDayReturnsanumericalvalueindicatingthedayoftheweekthatthespecifiedsessionstarts,where0=Sunday,1=Monday,etc.

SessionStartDay(SessionType,SessionNum)

Example

Assignavalue,indicatingthedayoftheweekthatthe4thregularsessionstarts,toValue1variable:

Value1=SessionStartDay(1,4);

SessionStartDayMSReturnsanumericalvalueindicatingthedayoftheweekthatthespecifiedmergedsessioninamulti-dataserieschartstarts,where0=Sunday,1=Monday,etc.

SessionStartDayMS(SessionNum)

Example

Assignavalue,indicatingthedayoftheweekthatthe4thmergedsessionstarts,toValue1variable:

Value1=SessionStartDayMS(4);

SessionStartTime

Returnsanumericalvalue,indicatingthetimeofthedaythatthespecifiedsessionstarts.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

SessionStartTime(SessionType,SessionNum)

Example

Assignavalue,indicatingthetimeofthedaythatthe4thregularsessionstarts,toValue1variable:

Value1=SessionStartTime(1,4);

SessionStartTimeMS

Returnsanumericalvalue,indicatingthetimeofthedaythatthespecifiedmergedsessioninamulti-dataserieschartstarts.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

SessionStartTimeMS(SessionNum)

Example

Assignavalue,indicatingthetimeofdaythatthe4thmergedsessionstarts,toValue1variable:

Value1=SessionStartTimeMS(4);

AASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

TheuseofSkipWordsisoptional;theycanbeinsertedanywherewithinthePLcodeandwillappearinredinPowerLanguageEditor.

Example

TheSkipWordsintheexamplebelowarecoloredinred:

IfanOpenis<thanCloseof4BarsAgowasThenBuyThisBaronClose;IfPlot1doesCrossAbovea1350ThenSellFromEntry("MyEntry")NextBarattheMarket;

AnASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

AtASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

BasedASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

ByASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

DoesASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

FromAskipword;usedinstrategyexitstatementsincombinationwithEntrywordthattiesanexittotheparticularentrythatwasassignedtheEntryLabelname.

Anexitcanonlybetiedtoanentrywithinthesamesignal;formoreinformation,seeBuyorSellShort.

SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

FromEntry("EntryLabel")

Where:EntryLabel-thenamethatwasassignedtotheentrythattheexitistobetiedtoFrom-askipwordandcanbeomitted

Example

Completelyexitfromthelongpositionestablishedbytheentrylabeled"OriginalEntry",atMarketpriceonopenofnextbar:

SellFromEntry("OriginalEntry")NextBaratOpen;

IsASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

OfASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

OnASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

PlaceASkipWordretainedforbackwardcompatibility.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

ThanASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

TheASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

WasASkipWord.SkipWordsservesolelytoimprovethereadabilityofPowerLanguagecodeandareskipped(ignored)duringthecompilationandexecution.

Example

Usedinstrategyexitstatementsinplaceofanumericalexpression,precedingthewordsSharesorContracts,todenoteallofthesharesorallofthecontractsheldwithoutspecifyingtheactualnumberofsharesorcontracts.

AllContracts

Example

Sellallofthesharesheldatmarketpriceonopenofnextbar:

SellAllSharesNextBarAtMarket;

BuyEntersalongpositionasspecifiedbytheparameters.

TheentrypointisvisuallyindicatedonachartbyanArrowandaTick.TheArrowidentifiesthetimeandtheTickidentifiesthepricevalueoftheentrypoint.Labels,displayingtheentrynameandthenumberofcontractsorsharestraded,aredisplayedbelowtheBuyArrow.

Anorderisexecutedatthepointspecifiedbytheparameters;iftheorderisnotfilledwithinthespecifiedbar,theorderiscancelled.

WhenaBuyorderisfilled,anyopenshortpositionswillalsobeclosed.

Buy[("EntryLabel")][TradeSize]EntryType;

ParametersEntryLabel-anoptionalparameter;assignsanamethatwillbedisplayedinthenamelabelbelowtheentry,andcanbeusedtoidentifytheparticularentryandtotieanexittoit.

Anexitcanonlybetiedtoanentrywithinthesamesignal;formoreinformation,seeSell.

IfEntryLabelisnotspecified,thename"Buy"willbeusedforthefirstentry,"Buy#2"forthesecondentry,"Buy#3"forthethirdentry,etc.

TradeSize-anoptionalparameter;anumericalexpression,specifyingthenumberofcontractsorsharestobuy;theexpressionmustbefollowedbyoneofthefollowingtransposablewords:Share,Shares,ContractorContracts.

IfTradeSizevalueequals0orisnegative,alongpositionwillnotbeenteredbutanyopenshortpositionswillbeclosed.

IfTradeSizeisnotspecified,thetradesizevaluesetbytheuserintheProperties

taboftheStrategyPropertieswindowwillbeused.

EntryType-arequiredparameter;specifiesthetimingandpriceofentry.

TherearefourkindsofEntryType:

ThisBar[On]Close

Where:-Onisaskipwordandcanbeomitted

ABuyArrowwillbeplacedatthecurrentbar'sClosetick.

NextBar[At]OpenorNextBar[At]Market

Where:-words"Market"and"Open"aretransposable-Atisaskipwordandcanbeomitted

ABuyArrowwillbeplacedatthenextbar'sOpentick.

NextBar[At]PriceLimit

Where:-Priceisanumericalexpression,specifyingtheLimitPrice-Atisaskipwordandcanbeomitted

ABuyArrowwillbeplacedonthenextbaratthefirsttickwithapricevaluelessthanorequaltoPrice;iftherearenosuchtickswithinthenextbar,theorderwillbecancelled.

NextBar[At]PriceStop

Where:-Priceisanumericalexpression,specifyingtheStopPrice-Atisaskipwordandcanbeomitted

ABuyArrowwillbeplacedonthenextbaratthefirsttickwithapricevalueequaltoorgreaterthanthePrice;iftherearenosuchtickswithinthenextbar,theorderwillbecancelled.

Example

Buyauser-setnumberofsharesatMarketpriceoncloseofthisbar:

BuyThisBarOnClose;

Buy1shareatMarketpriceonopenofnextbarandlabeltheentry"Entry":

Buy("Entry")1ShareNextBarAtOpen;

Buy1contractatMarketpriceonopenofnextbarandlabeltheentry"Entry":

Buy("Entry")1ContractNextBarMarket;

Buy2shareswithinthenextbaronthefirsttickwithapriceof100orless:

Buy2SharesNextBarAt100Limit;

Buy10contractswithinthenextbaronthefirsttickwithapriceof50ormore:

Buy10ContractsNextBar50Stop;

BuyToCoverCompletelyorpartiallyexitsoneoralloftheshortentriesasspecifiedbytheparameters.

TheexitpointisvisuallyindicatedonachartbyanArrowandaTick.TheArrowidentifiesthetimeandtheTickidentifiesthepricevalueoftheexitpoint.Labels,displayingtheexitnameandthenumberofcontractsorsharestraded,aredisplayedbelowtheCoverArrow.

BuyToCover[("ExitLabel")][FromEntry("EntryLabel")][TradeSize[Total]]Exit

Parameters

ExitLabel-anoptionalparameter;assignsanamethatwillbedisplayedinthenamelabelabovetheexit

IfExitLabelisnotspecified,thename"Cover"willbeusedforthefirstexit,"Cover#2"forthesecondexit,"Cover#3"forthethirdexit,etc.

EntryLabel-anoptionalparameter;tiestheexittotheparticularentrythatwasassignedtheEntryLabelname;thenamemustbeprecededbythewordEntry,thewordFromisaskipwordandcanbeomitted

Anexitcanonlybetiedtoanentrywithinthesamesignal.Formoreinformation,seeSellShort

IfEntryLabelisnotspecified,alloftheopenshortentrieswillbeclosed.

TradeSize-anoptionalparameter;anumericalexpression,specifyingthenumberofcontractsorsharestobuy;theexpressionmustbefollowedbyoneofthefollowingtransposablewords:Share,Shares,ContractorContracts.

Bydefault,thenumberofcontractsorsharesspecifiedbytheTradeSizeparameterwillbecoveredfromeachoftheopenshortentries.

IfTradeSizeisfollowedbythewordTotal,onlythenumberofcontractsorsharesspecifiedbytheTradeSizeparameterwillbecovered,regardlessofthenumberofopenshortentries.Thecontractsorshareswillbecoveredinthesameordertheywereshorted:FirstIn,FirstOut.

IfTradeSizeisnotspecified,theentireshortpositionwillbeclosedout.

Exit-arequiredparameter;specifiesthetimingandpriceofexit.

TherearefourtypesofExit:

ThisBar[On]Close

ACoverArrowwillbeplacedatthecurrentbar'sClosetick.

ACoverArrowwillbeplacedatthenextbar'sOpentick.

ACoverArrowwillbeplacedonthenextbaratthefirsttickwithapricevaluelessthanorequaltoPrice;iftherearenosuchtickswithinthenextbar,theorderwillbecancelled.

ACoverArrowwillbeplacedonthenextbaratthefirsttickwithapricevalueequaltoorgreaterthanthePrice;iftherearenosuchtickswithinthenextbar,theorderwillbecancelled.

Example

CompletelyexitallopenshortentriesatMarketpriceoncloseofthisbarandlabeltheexit"CompleteExit":

BuyToCover("CompleteExit")ThisBarOnClose;

Completelyexitfromtheshortpositionestablishedbytheentrylabeled"OriginalEntry",atMarketpriceonopenofnextbar:

BuyToCoverFromEntry("OriginalEntry")NextBarAtOpen;

Cover10sharesoftheshortpositionestablishedbytheentrylabeled"OriginalEntry",atMarketpriceonopenofnextbar:

BuyToCoverEntry("OriginalEntry")10SharesNextBarAtMarket;

Cover5contractsforeachoneoftheopenshortentriesatMarketpriceonopenofnextbar:

BuyToCover5ContractsNextBarMarket;

Coveratotalof1share,regardlessofthenumberofopenshortentries,withinthenextbaronthefirsttickwithapriceof100orless(thefirstshareshortedwillbecoveredifthepriceismet):

BuyToCover1ShareTotalNextBarAt100Limit;

Completelyexitallshortentrieswithinthenextbaronthefirsttickwithapriceof50ormore:

BuyToCoverNextBar50Stop;

ContractSameasContracts

ContractsUsedinstrategyentryorexitstatementsincombinationwithanumericalexpressiontospecifythenumberofcontractsorsharestotrade.

TradeSizeContracts

Where:TradeSize-anumericalexpression,specifyingthenumberofcontractsorshares

Example

Buy2contractsatMarketpriceonopenofnextbar:

Buy2ContractsNextBarAtMarket;

UsedincombinationwiththewordsBuyTo;sameasBuyToCover.

BuyToCover[("ExitLabel")][FromEntry("EntryLabel")][TradeSize[Total]]Exit;

EntryUsedinstrategyexitstatementstotieanexittotheparticularentrythatwasassignedtheEntryLabelname.

Anexitcanonlybetiedtoanentrywithinthesamesignal;formoreinformation,seeBuyorSellShort.

FromEntry("EntryLabel")

Where:EntryLabel-thenamethatwasassignedtotheentrythattheexitistobetiedtoFrom-askipwordandcanbeomitted

Example

SellFromEntry("OriginalEntry")NextBarAtOpen;

Higher

Usedinstrategyentryorexitstatementstospecifyapricerangeforanentryoranexit;mustbeprecededbythewordOr.

AtPriceOrHigher

Where:Price-anumericalexpression,specifyingthebasePriceAt-askipwordandcanbeomitted

AtPriceOrHigherisanequivalentofaLimitwhenusedwithSellorSellShortstatements,andanequivalentofaStopwhenusedwithBuyorBuyToCoverstatements.

Example

Buywithinthenextbaronthefirsttickwithapriceof100ormore:

BuyNextBarAt100OrHigher;

Sellshortwithinthenextbaronthefirsttickwithapriceof50ormore:

SellShortNextBarAt50OrHigher;

LimitUsedinstrategyentryorexitstatementstospecifyaLimitpriceforanentryoranexit.

ALimitorderwillexecuteatthespecifiedpriceorbetter.AbetterpriceisalowerpriceforBuyandBuytocoverorders,andahigherpriceforSellandSellshortorders.

AtPriceLimit

Where:Price-anumericalexpression,specifyingtheLimitPriceAt-askipwordandcanbeomitted

Example

Buywithinthenextbaronthefirsttickwithapriceof100orless:

BuyNextBarAt100Limit;

Sellshortwithinthenextbaronthefirsttickwithapriceof50ormore:

SellShortNextBar50Limit;

LowerUsedinstrategyentryorexitstatementstospecifyapricerangeforanentryoranexit.

MustbeprecededbythewordOr.

AtPriceOrLower

Where:Price-anumericalexpression,specifyingthebasePriceAt-askipwordandcanbeomitted

AtPriceOrLowerisanequivalentofaLimitwhenusedwithBuyorBuyToCoverstatements,andanequivalentofaStopwhenusedwithSellorSellShortstatements.

Example

Buywithinthenextbaronthefirsttickwithapriceof100orless:

BuyNextBarAt100OrLower;

Sellshortwithinthenextbaronthefirsttickwithapriceof50orless:

SellShortNextBarAt50OrLower;

MarketUsedinstrategyentryorexitstatementstospecifyaMarketpriceforanentryoranexit.

AMarketBuyorderwillexecuteatthecurrentaskpriceandaMaretSellorderwillexecuteatthecurrentbidprice.

AtMarket

Where:Atisaskipwordandcanbeomitted

Example

BuyNextBarAtMarket;

SellCompletelyorpartiallyexitsoneorallofthelongentriesasspecifiedbytheparameters.

TheexitpointisvisuallyindicatedonachartbyanArrowandaTick.TheArrowidentifiesthetimeandtheTickidentifiesthepricevalueoftheexitpoint.Labels,displayingtheexitnameandthenumberofcontractsorsharestraded,aredisplayedabovetheSellArrow.

UsageSell[("ExitLabel")][FromEntry("EntryLabel")][TradeSize[Total]]Exit

ParametersExitLabel-anoptionalparameter;assignsanamethatwillbedisplayedinthenamelabelabovetheexit

IfExitLabelisnotspecified,thename"Sell"willbeusedforthefirstexit,"Sell#2"forthesecondexit,"Sell#3"forthethirdexit,etc.

EntryLabel-anoptionalparameter;tiestheexittotheparticularentrythatwasassignedtheEntryLabelname;thenamemustbeprecededbytheword"Entry",theword"From"isaskipwordandcanbeomitted

Anexitcanonlybetiedtoanentrywithinthesamesignal.Formoreinformation,seeBuy

IfEntryLabelisnotspecified,alloftheopenlongentrieswillbeclosed.

TradeSize-anoptionalparameter;anumericalexpression,specifyingthenumberofcontractsorsharestosell;theexpressionmustbefollowedbyoneofthefollowingtransposablewords:Share,Shares,ContractorContracts.

Bydefault,thenumberofcontractsorsharesspecifiedbytheTradeSizeparameterwillbesoldfromeachoneoftheopenlongentries.

IfTradeSizeisfollowedbytheword"Total",onlythenumberofcontractsor

sharesspecifiedbytheTradeSizeparameterwillbesold,regardlessofthenumberofopenlongentries.Thecontractsorshareswillbesoldinthesameordertheywerebought:FirstIn,FirstOut.

IfTradeSizeisnotspecified,theentirelongpositionwillbeclosedout.

Exit-arequiredparameter;specifiesthetimingandpriceofexit.

TherearefourtypesofExit:

ThisBar[On]Close

ASellArrowwillbeplacedatthecurrentbar'sClosetick.

ASellArrowwillbeplacedatthenextbar'sOpentick.

ASellArrowwillbeplacedonthenextbaratthefirsttickwithapricevaluegreaterthanorequaltoPrice;iftherearenosuchtickswithinthenextbar,theorderwillbecancelled.

ASellArrowwillbeplacedonthenextbaratthefirsttickwithapricevalueequaltoorlessthanthePrice;iftherearenosuchtickswithinthenextbar,theorderwillbecancelled.

Example

CompletelyexitallopenlongentriesatMarketpriceoncloseofthisbarandlabeltheexit"CompleteExit":

Sell("CompleteExit")ThisBarOnClose;

SellFromEntry("OriginalEntry")NextBarAtOpen;

Sell10sharesofthelongpositionestablishedbytheentrylabeled"OriginalEntry",atMarketpriceonopenofnextbar:

SellEntry("OriginalEntry")10SharesNextBarAtMarket;

Sell5contractsforallopenlongentriesatMarketpriceonopenofnextbar:

Sell5ContractsNextBarMarket;

Sellatotalof1share,regardlessofthenumberofopenlongentries,withinthenextbaronthefirsttickwithapriceof100ormore(thelongest-heldsharewillbesoldifthepriceismet):

Sell1ShareTotalNextBarAt100Limit;

Completelyexitalllongentrieswithinthenextbaronthefirsttickwithapriceof50orless:

SellNextBar50Stop;

SellShortEntersashortpositionasspecifiedbytheparameters.

TheentrypointisvisuallyindicatedonachartbyanArrowandaTick.TheArrowidentifiesthetimeandtheTickidentifiesthepricevalueoftheentrypoint.Labels,displayingtheentrynameandthenumberofcontractsorsharestraded,aredisplayedabovetheShortArrow.

WhenaSellShortorderisfilled,anyopenlongpositionswillalsobeclosed.

SellShort[("EntryLabel")][TradeSize]Entry

Parameters

EntryLabel-anoptionalparameter;assignsanamethatwillbedisplayedinthenamelabelabovetheentry,andcanbeusedtoidentifytheparticularentryandtotieanexittoit.

Anexitcanonlybetiedtoanentrywithinthesamesignal;formoreinformation,seeBuyToCover.

IfEntryLabelisnotspecified,thename"Short"willbeusedforthefirstentry,"Short#2"forthesecondentry,"Short#3"forthethirdentry,etc.

TradeSize-anoptionalparameter;anumericalexpression,specifyingthenumberofcontractsorsharestosellshort;theexpressionmustbefollowedbyoneofthefollowingtransposablewords:Share,Shares,ContractorContracts.

IfTradeSizevalueequals0orisnegative,ashortpositionwillnotbeenteredbutanyopenlongpositionswillbeclosed.

IfTradeSizeisnotspecified,thetradesizevaluesetbytheuserinthePropertiestaboftheStrategyPropertieswindowwillbeused.

Entry-arequiredparameter;specifiesthetimingandpriceofentry.

TherearefourtypesofEntry:

ThisBar[On]Close

AShortArrowwillbeplacedatthecurrentbar'sClosetick.

AShortArrowwillbeplacedatthenextbar'sOpentick.

AShortArrowwillbeplacedonthenextbaratthefirsttickwithapriceequaltoorgreaterthanthePrice;iftherearenosuchtickswithinthenextbar,theorderwillbecancelled.

AShortArrowwillbeplacedonthenextbaratthefirsttickwithapricevaluelessthanorequaltoPrice;iftherearenosuchtickswithinthenextbar,theorderwillbecancelled.

Example

SellShortauser-setnumberofsharesatMarketpriceoncloseofthisbar:

SellShortThisBarOnClose;

SellShort1shareatMarketpriceonopenofnextbarandlabeltheentry"Entry":

SellShort("Entry")1ShareNextBarAtOpen;

SellShort1contractatMarketpriceonopenofnextbarandlabeltheentry"Entry":

SellShort("Entry")1ContractNextBarMarket;

SellShort2shareswithinthenextbaronthefirsttickwithapriceof100ormore:

SellShort2SharesNextBarAt100Limit;

SellShort10contractswithinthenextbaronthefirsttickwithapriceof50orless:

SellShort10ContractsNextBar50Stop;

SetBreakEvenClosesouttheentirepositionortheentryifitisatthebreakevenpointaftertheprofithasreachedthespecifiedvalue;generatestheappropriateStoporderdependingonwhetherthepositionislongorshort.

SetStopPositionandSetStopContractorSetStopSharefunctionsdeterminewhetherSetBreakEvenwillbeappliedtotheentirepositionortoeachcontractorshareindividually;bydefault,SetBreakEvenisappliedtotheentireposition.

SetBreakEvenfunctionisevaluatedintra-barandnotonlyoncloseofabar,andcanexitwithinthesamebarastheentry.

SetBreakEven(Profit)

Where:Profit-anumericalexpression,specifyingthecurrencyvalueoftheprofitthatmustbereachedfirst

Thisfunctioncanonlybeusedinsignals.

SetBreakEvenfunctiondoesnotfactorincommissionsorslippage.

Amountcanbeseteitherinthecurrencyofthesymbolorinthecurrecyofthestrategy,dependingonthekeysetinWindowsRegistry.

GotoHKEY_CURRENT_USER\Software\TSSupport\[ProductName]\StrategyPropandcreateakeyDWORDValue:SpecOrdersAmountIsStrategyCurr.

0-tocalculateAmountinthecurrencyofthesymbol.

1-tocalculateAmountinthecurrencyofthestrategy/Portfolio(bydefault).

[ProductName]isnameofproduct,forexample,for32-bitMultiCharts="MultiCharts",for64-bitversion="MultiCharts64".

Ifthereisnosuchakey,Amountiscalculatedinthecurrencyofthestrategy/Portfolio.

Example

Generateanexitorderfortheentirepositionifitisatthebreakevenpointafterpositionprofithasreached¤50:

SetStopPosition;

SetBreakEven(50);

Generateanexitorderfortheentryifitisatthebreakevenpointafterpercontractprofithasreached¤10:

SetStopContract;

SetBreakEven(10);

SetBreakEven_ptClosesouttheentirepositionortheentryifitisatthebreakevenpointaftertheprofithasreachedthespecifiedtickvalue;generatestheappropriateStoporderdependingonwhetherthepositionislongorshort.

SetStopPositionandSetStopContractorSetStopSharefunctionsdeterminewhethersingleSetBreakEven_ptorderwillbeappliedtotheentirepositionormultipleSetBreakEven_ptorderswillbeappliedtoeachentryinpositionindividually;bydefault,SetBreakEven_ptisappliedtotheentireposition.

SetBreakEven_ptfunctionisevaluatedintra-barandnotonlyoncloseofabar,andcanexitwithinthesamebarastheentry.

SetBreakEven_pt(Profit)

Where:Profit-anumericalexpression,specifyingtheamountoftheprofitinticksthatmustbereachedfirst

SetBreakEven_ptfunctiondoesnotfactorincommissionsorslippage.

Example

Generateanexitorderfortheentirepositionifitisatthebreakevenpointafterpositionprofithasreached50ticks:

SetStopPosition;

SetBreakEven_pt(50);

Generateanexitorderfortheentryifitisatthebreakevenpointafterperentery

profithasreached10ticks:

SetStopContract;

SetBreakEven_pt(10);

SetDollarTrailingClosesouttheentirepositionortheentryifthecurrentprofitislessthanthemaximumprofitbythespecifiedamount;generatestheappropriateStoporderdependingonwhetherthepositionislongorshort.

Forexample,ifthespecifiedammountis¤50andtheprofithasreachedthemaximumof¤120,thepositionwillbeclosedoncetheprofitdropsto¤70.

SetStopPositionandSetStopContractorSetStopSharefunctionsdeterminewhetherSetDollarTrailingwillbeappliedtotheentirepositionortoeachcontractorshareindividually;bydefault,SetDollarTrailingisappliedtotheentireposition.

SetDollarTrailingfunctionisevaluatedintra-barandnotonlyoncloseofabar,andcanexitwithinthesamebarastheentry.

SetDollarTrailing(Amount)

Where:Amount-anumericalexpression,specifyingthecurrencyvalueofthemaximumlossofprofit

[ProductName]isnameofproduct,forexample,for32-bitMultiCharts=

"MultiCharts",for64-bitversion="MultiCharts64".

Example

Generateanexitorderfortheentirepositionifpositionprofitdropsby¤50:

SetStopPosition;

SetDollarTrailing(50);

Generateanexitorderfortheentryifpercontractprofitdropsby¤10:

SetStopContract;

SetDollarTrailing(10);

SetExitOnCloseClosesoutthecurrentpositionattheClosetickofthelastbarofthetradingsessiononanintra-daychart;generatestheappropriateMarketexitorderdependingonwhetherthepositionislongorshort.

SetExitOnClosefunctionusesthesessionclosingtimespecifiedinthesessionsettingsforthesymbolintheQuoteManager.

SetExitOnClose

Example

GenerateanexitorderattheClosetickofthelastbarofthetradingsession:

SetExitOnClose;

SetPercentTrailingClosesouttheentirepositionortheentryifthespecifiedpercentageofthemaximumprofitislostaftertheprofithasreachedthespecifiedvalue;generatestheappropriateStoporderdependingonwhetherthepositionislongorshort.

Forexample,ifthespecifiedprofitis¤100andthespecifiedpercentageis50,andtheprofithasreachedthemaximumof¤120,thepositionwillbeclosedoncetheprofitfallsbackto¤60.

SetStopPositionandSetStopContractorSetStopSharefunctionsdeterminewhetherSetPercentTrailingwillbeappliedtotheentirepositionoreachcontractorshareindividually;bydefault,SetPercentTrailingisappliedtotheentireposition.

SetPercentTrailingfunctionisevaluatedintra-barandnotonlyoncloseofabar,andcanexitwithinthesamebarastheentry.

SetPercentTrailing(Profit,Percentage)

Where:Profit-anumericalexpression,specifyingthecurrencyvalueoftheprofitthatmustbereachedfirstPercentage-anumericalexpression,specifyingthemaximumlossofprofitinpercent

Example

Generateanexitorderfortheentirepositionif50percentofmaximumpositionprofitislostaftertheprofithasreached¤25:

SetStopPosition;

SetPercentTrailing(25,50);

Generateanexitorderfortheentryif25percentofmaximumpershareprofitislostaftertheprofithasreached¤5:

SetStopShare;

SetPercentTrailing(5,25);

SetPercentTrailing_ptClosesouttheentirepositionortheentryifthespecifiedpercentageofthemaximumprofitislostaftertheprofithasreachedthespecifiedtickvalue;generatestheappropriateStoporderdependingonwhetherthepositionislongorshort.

Forexample,ifthespecifiedprofitis100ticksandthespecifiedpercentageis50,andtheprofithasreachedthemaximumof120ticks,thepositionwillbeclosedoncetheprofitfallsbackto60ticks.

SetStopPositionandSetStopContractorSetStopSharefunctionsdeterminewhethersingleSetPercentTrailing_ptorderwillbeappliedtotheentirepositionormultipleSetPercentTrailing_ptorderswillbeappliedtoeachentryinpositionindividually;bydefault,SetPercentTrailing_ptisappliedtotheentireposition.

SetPercentTrailing_ptfunctionisevaluatedintra-barandnotonlyoncloseofabar,andcanexitwithinthesamebarastheentry.

SetPercentTrailing_pt(Profit,Percentage)

Where:Profit-anumericalexpression,specifyingthetickvalueoftheprofitthatmustbereachedfirstPercentage-anumericalexpression,specifyingthemaximumlossofprofitinpercent

SetPercentTrailing_ptfunctiondoesnotfactorincommissionsorslippage.

Example

Generateanexitorderfortheentirepositionif50percentofmaximumposition

profitislostaftertheprofithasreached25ticks:

SetStopPosition;

SetPercentTrailing_pt(25,50);

Generateanexitorderfortheentryif25percentofmaximumperentryprofitislostaftertheprofithasreached5ticks:

SetStopShare;

SetPercentTrailing_pt(5,25);

SetProfitTargetClosesouttheentirepositionortheentryifprofitreachesthespecifiedcurrencyvalue;generatestheappropriateLimitexitorderdependingonwhetherthepositionislongorshort.

SetStopPositionandSetStopContractorSetStopSharefunctionsdeterminewhethertheprofittargetwillbeappliedtotheentirepositionortoeachcontractorshareindividualy;bydefault,profittargetisappliedtotheentireposition.

SetProfitTargetfunctionisevaluatedintra-barandnotonlyoncloseofabar,andcanexitwithinthesamebarastheentry.

SetProfitTarget(Amount)

Where:Amount-anumericalexpression,specifyingtheprofittargetamount

Example

Generateanexitorderfortheentirepositionifthepositionprofitreaches¤100:

SetStopPosition;

SetProfitTarget(100);

Generateanexitorderfortheentryiftheprofitpercontractreaches¤10:

SetStopContract;

SetProfitTarget(10);

SetProfitTarget_ptClosesouttheentirepositionortheentryifprofitreachesthespecifiedtickvalue;generatestheappropriateLimitexitorderdependingonwhetherthepositionislongorshort.

SetStopPositionandSetStopContractorSetStopSharefunctionsdeterminewhethersingleprofittargetorderwillbeappliedtotheentirepositionormultipleSetProfitTarget_ptorderswillbeappliedtoeachentryinpositionindividualy;bydefault,profittargetisappliedtotheentireposition.

SetProfitTarget_ptfunctionisevaluatedintra-barandnotonlyoncloseofabar,andcanexitwithinthesamebarastheentry.

SetProfitTarget_pt(Amount)

Where:Amount-anumericalexpression,specifyingtheprofittargetamountinticks.

SetProfitTarget_ptfunctiondoesnotfactorincommissionsorslippage.

Example

Generateanexitorderfortheentirepositionifthepositionprofitreaches100ticks:

SetStopPosition;

SetProfitTarget_pt(100);

Generateanexitorderfortheentryiftheprofitperentryreaches10ticks:

SetStopContract;

SetProfitTarget_pt(10);

SetStopContractForcesthebuilt-instrategyexitfunctionstobeappliedonpercontractorsharebasis.

Thebuilt-instrategyexitfunctionsare:SetStopLoss,SetProfitTarget,SetBreakEven,SetDollarTrailing,andSetPercentTrailing.

SetStopContract

IfSetStopPositon,SetStopContract,andSetStopSharewerenotused,theexitfunctionswillbeappliedontheentirepositionbasisasadefault.

IfSetStopPositon,SetStopContract,andSetStopSharewereusedinmultipleinstancesorindifferentsignalsappliedtothesamechart,thelastinstancewillbecontrolling.

Example

ForcetheSetStopLossstrategyexitfunctiontobeappliedonpercontractbasis:

SetStopContract;

SetStopLoss(10);

Anexitorderfortheentrywillbegeneratedifthelosspercontractreaches¤10.

SetStopLossClosesouttheentirepositionortheentryifthelossreachesthespecifiedcurrencyvalue;generatestheappropriateStoporderdependingonwhetherthepositionislongorshort.

SetStopPositionandSetStopContractorSetStopSharefunctionsdeterminewhetherthestoplosswillbeappliedtotheentirepositionortoeachcontractorshareindividually;bydefault,stoplossisappliedtotheentireposition.

SetStopLossfunctionisevaluatedintra-barandnotonlyoncloseofabar,andcanexitwithinthesamebarastheentry.

SetStopLoss(Amount)

Where:Amount-anumericalexpression,specifyingthestoplossamount

Example

Generateanexitorderfortheentirepositionifthepositionlossreaches¤100:

SetStopPosition;

SetStopLoss(100);

Generateanexitorderfortheentryifthelosspercontractreaches¤10:

SetStopContract;

SetStopLoss(10);

SetStopLoss_ptClosesouttheentirepositionortheentryifthelossreachesthespecifiedtickvalue;generatestheappropriateStoporderdependingonwhetherthepositionislongorshort.

SetStopPositionandSetStopContractorSetStopSharefunctionsdeterminewhethersinglestoplosswillbeappliedtotheentirepositionormultipleSetStopLoss_ptorderswillbeappliedtoeachentryinpositionindividually;bydefault,stoplossisappliedtotheentireposition.

SetStopLoss_ptfunctionisevaluatedintra-barandnotonlyoncloseofabar,andcanexitwithinthesamebarastheentry.

SetStopLoss_pt(Amount)

Where:Amount-anumericalexpression,specifyingthestoplossamountinticks.

SetStopLoss_ptfunctiondoesnotfactorincommissionsorslippage.

Example

Generateanexitorderfortheentirepositionifthepositionlossreaches100ticks:

SetStopPosition;

SetStopLoss_pt(100);

Generateanexitorderfortheentryifthelossperentryreaches10ticks:

SetStopContract;

SetStopLoss_pt(10);

SetStopPositionForcesthebuilt-instrategyexitfunctionstobeappliedontheentirepositionbasis.

Thebuilt-instrategyexitfunctionsare:SetStopLoss,SetProfitTarget,SetBreakEven,SetDollarTrailing,andSetPercentTrailing.

SetStopPosition

IfSetStopPositon,SetStopContract,andSetStopSharewerenotused,theexitfunctionswillbeappliedontheentirepositionbasisasadefault.

IfSetStopPositon,SetStopContract,andSetStopSharewereusedinmultipleinstancesorindifferentsignalsappliedtothesamechart,thelastinstancewillbecontrolling.

Example

ForceSetStopLossstrategyexitfunctiontobeappliedontheentirepositionbasis:

SetStopPosition;

SetStopLoss(100);

Anexitorderfortheentirepositionwillbegeneratedifthepositionlossreaches¤100.

SetStopShareSameasSetStopContract

SetTrailingStop_ptClosesouttheentirepositionortheentryifthecurrentprofitislessthanthemaximumprofitbythespecifiedamount;generatestheappropriateStoporderdependingonwhetherthepositionislongorshort.

Forexample,ifthespecifiedammountis50ticksandtheprofithasreachedthemaximumof120ticks,thepositionwillbeclosedoncetheprofitdropsto70ticks.

SetStopPositionandSetStopContractorSetStopSharefunctionsdeterminewhetherSetTrailingStop_ptwillbeappliedtotheentirepositionortoeachentryinpositionindividually;bydefault,SetTrailingStop_ptisappliedtotheentireposition.

SetTrailingStop_ptfunctionisevaluatedintra-barandnotonlyoncloseofabar,andcanexitwithinthesamebarastheentry.

SetDollarTrailing_pt(Amount)

Where:Amount-anumericalexpression,specifyingthetickvalueofthemaximumlossofprofitinticks.

SetTrailingStop_ptfunctiondoesnotfactorincommissionsorslippage.

Example

Generateanexitorderfortheentirepositionifpositionprofitdropsby50ticks:

SetStopPosition;

SetDollarTrailing_pt(50);

Generateanexitorderfortheentryifperentryprofitdropsby10ticks:

SetStopContract;

SetDollarTrailing_pt(10);

ShareSameasShares

Shares

Usedinstrategyentryorexitstatementsincombinationwithanumericalexpressiontospecifythenumberofsharesorcontractstotrade.

TradeSizeShares

Where:TradeSize-anumericalexpression,specifyingthenumberofsharesorcontracts

Example

Buy2sharesatMarketpriceonopenofnextbar:

Buy2SharesNextBarAtMarket;

UsedincombinationwiththewordSell;sameasSellShort.

SellShort[("EntryLabel")][TradeSize]Entry;

StopUsedinstrategyentryorexitstatementstospecifyaStoppriceforanentryoranexit.

AStoporderwillexecuteatthespecifiedpriceorworse.AworsepriceisahigherpriceforBuyandBuytocoverorders,andalowerpriceforSellandSellshortorders.

AtPriceStop

Where:Price-anumericalexpression,specifyingtheLimitPriceAt-askipwordandcanbeomitted

Example

Sellwithinthenextbaronthefirsttickwithapriceof100orless:

SellNextBar100Stop;

Coverwithinthenextbaronthefirsttickwithapriceof50ormore:

BuyToCoverNextBarAt50Stop;

TotalUsedinstrategyexitstatements,followinganumericalexpressionandthewordsSharesorContracts,toindicatethatonlythenumberofcontractsorsharesspecifiedbythenumericalexpressionistobesoldorcoveredintotal,regardlessofthenumberofopenentries.Thecontractsorshareswillbesoldorcoveredinthesameordertheywereboughtorshorted:FirstIn,FirstOut.

IfthewordTotalisnotused,thenumberofcontractsorsharesspecifiedbythenumericalexpressionwillbesoldorcoveredforeachoneoftheopenentries.

TradeSizeSharesTotal

Where:TradeSize-anumericalexpression,specifyingthenumberofsharesorcontracts

Example

Sellatotalof2contracts,regardlessofthenumberofopenlongentries,atMarketpriceonopenofnextbar:

Sell2ContractsTotalNextBarAtMarket;

AvgBarsEvenTradeReturnsanumericalvalue,indicatingtheaveragenumberofbarsapositionwasheldduringallcompletedeventrades.

AvgBarsEvenTrade

Example

AvgBarsEvenTradewillreturnavalueof3.5iffoureventradesheldpositionsfor2,5,3,and4bars

AvgBarsLosTradeReturnsanumericalvalue,indicatingtheaveragenumberofbarsapositionwasheldduringallcompletedlosingtrades.

AvgBarsLosTrade

Example

AvgBarsLosTradewillreturnavalueof3.5iffourlosingtradesheldpositionsfor2,5,3,and4bars

AvgBarsWinTradeReturnsanumericalvalue,indicatingtheaveragenumberofbarsapositionwasheldduringallcompletedwinningtrades.

AvgBarsWinTrade

Example

AvgBarsWinTradewillreturnavalueof3.5iffourwinningtradesheldpositionsfor2,5,3,and4bars

AvgEntryPriceReturnsanumericalvalue,indicatingtheaverageentrypriceforallopenentriesinapyramidedposition.

AvgEntryPrice

Example

AvgEntryPricewillreturnavalueof101iftherewerethreeopenentriesat95,105,and103

AvgEntryPrice_at_Broker

Returnsanumericalvalue,indicatingtheaverageentrypriceatthebrokerforthesymbol.

Apositivevalueindicatesalongpositionandanegativevalueindicatesashortposition.

Azero('0')isreturnedwhenthecurrentpositionisflat,orifAutomatedTradingisnotturnedon.

AvgEntryPrice_at_Broker

Thisfunctioncanonlybeusedinsignalsandfunctions.

Important

IfAutomatedTradingwasmanuallyturnedoffbytheuser,thevaluereturnedbythekeywordstopschanging,andmayremainunequalto'0'.

Example

AvgEntryPrice_at_Brokerwillreturnavalueof102ifbrokerhasreturnedthevalueof102forthecurrenttradinginstrument.

AvgEntryPrice_at_Broker_for_The_StrategyReturnsanumericalvalue,indicatingtheaverageentrypriceatthebrokerforthestrategy.

AvgEntryPrice_at_Broker_for_The_Strategy

Important

Example

AvgEntryPrice_at_Broker_for_The_Strategywillreturnavalueof100ifthereweretwo1contractentriesforthecurrentstrategy:at98and102.

GrossLossReturnsanegativenumericalvalue,indicatingthetotalcurrencyvalueofallcompletedlosingtrades.

GrossLoss

Example

GrossLosswillreturnavalueof-50iftherewereatotaloffourlosingtrades,at10,5,20,and15

GrossLosswillreturnavalueof0ifnolosingtradeswerecompletedduringtheentiretradingperiod

GrossProfitReturnsanumericalvalue,indicatingthetotalcurrencyvalueofallcompletedwinningtrades.

GrossProfit

Example

GrossProfitwillreturnavalueof50iftherewereatotaloffourwinningtrades,at10,5,20,and15

GrossProfitwillreturnavalueof0ifnowinningtradeswerecompletedduringtheentiretradingperiod

i_AvgEntryPriceSameasAvgEntryPriceexceptusedinindicators.

i_AvgEntryPrice_at_BrokerReturnstheAverageentrypriceofeachopenentryinapyramidedposition.

i_AvgEntryPrice_at_Broker

i_AvgEntryPrice_at_Brokeronlyreturnstheaverageentrypriceforopentrades.

i_AvgEntryPrice_at_Brokercanonlybeusedinanindicator.

i_AvgEntryPrice_at_Brokerwillonlyreturnavalueifasignalisappliedtothesamedata.

Example

i_AvgEntryPrice_at_Brokerreturns170ifthreetradesarecurrentlyopenandwereenteredatapriceof140,170,and200.

i_AvgEntryPrice_at_Brokerreturns53iffourtradesarecurrentlyopenandwereenteredatapriceof54,48,60,and50.

i_AvgEntryPrice_at_Broker_for_The_StrategyIsusedfortheextractionofstrategyinformationinindicator.

ReturnsthesameinformationasAvgEntryPrice_at_Broker_for_The_Strategy.

i_ClosedEquityReturnstheprofitorlossrealizedwhenapositionhasbeenclosed.

i_ClosedEquity

Thisfunctioncanonlybeusedinindicators.

Example

i_ClosedEquitywillreturn100iftheclosedequityis100.

i_CurrentContractsSameasCurrentContractsexceptusedinindicators.

i_CurrentSharesSameasCurrentSharesexceptusedinindicators.

i_MarketPositionReturnsanumericalvalue,indicatingthetypeofthespecifiedposition.

Avalueof1indicatesthecurrentbarhasalongposition,-1indicatesthecurrentbarhasashortposition,and0isreturnedonlyifthecurrentbarhasaflatposition.

i_MarketPosition

Example

i_MarketPositionwillreturnavalueof0ifthepositiononthecurrentbarisflat

i_MarketPositionwillreturnavalueof1ifthepositiononthecurrentbarislong

i_MarketPositionwillreturnavalueof-1ifthepositiononthecurrentbarisshort

i_OpenEquityReturnsthecurrentequity(netprofit+openpositionprofit)

i_OpenEquity

Example

i_OpenEquitywillreturn100ifthecurrentequityis100.

i_OpenEquitywillreturn-100ifthecurrentequityis-100.

LargestLosTradeReturnsanegativenumericalvalue,indicatingthecurrencyvalueofthelargestcompletedlosingtrade.

LargestLosTrade

Example

LargestLosTradewillreturnavalueof-20iftherewereatotaloffourlosingtradesat10,5,20,and15

LargestLosTradewillreturnavalueof0ifnolosingtradeswerecompletedduringtheentiretradingperiod

LargestWinTradeReturnsanumericalvalue,indicatingthecurrencyvalueofthelargestcompletedwinningtrade.

LargestWinTrade

Example

LargestWinTradewillreturnavalueof20iftherewereatotaloffourwinningtradesat10,5,20,and15

LargestWinTradewillreturnavalueof0ifnowinningtradeswerecompletedduringtheentiretradingperiod

MaxConsecLosersReturnsanumericalvalue,indicatingthenumberoftradesinthelongestsequenceofconsecutivecompletedlosingtrades.

MaxConsecLosers

Example

MaxConsecLoserswillreturnavalueof3iftherewerethreeconsecutivecompletedlosingtrades

MaxConsecLoserswillreturnavalueof0ifnolosingtradeswerecompletedduringtheentiretradingperiod

MaxConsecWinnersReturnsanumericalvalue,indicatingthenumberoftradesinthelongestsequenceofconsecutivecompletedwinningtrades.

MaxConsecWinners

Example

MaxConsecWinnerswillreturnavalueof3iftherewerethreeconsecutivecompletedwinningtrades

MaxConsecWinnerswillreturnavalueof0ifnowinningtradeswerecompletedduringtheentiretradingperiod

MaxContractsHeldReturnsanumericalvalue,indicatingthemaximumnumberofcontractsorsharesheldatanyonetime.

MaxContractsHeld

Example

MaxContractsHeldwillreturnavalueof10ifamaximumoftencontractswereheldatanyonetime

MaxIDDrawDownReturnsanegativenumericalvalue,indicatingthelargestdeclineinequityduringtheentiretradingperiod.

MaxIDDrawDown

Example

MaxIDDrawDownwillreturnavalueof-500ifthelargestdeclineinequityduringtheentiretradingperiodwas¤500

MaxSharesHeldSameasMaxContractsHeld

NetProfitReturnsanumericalvalue,indicatingthetotalcurrencyvalueofallcompletedtrades.

NetProfit

Example

NetProfitwillreturnavalueof20iftherewerewinningtradesat25and10,andlosingtradesat5and10

NetProfitwillreturnavalueof-15iftherewerewinningtradesat10and5,andlosingtradesat20and10

NetProfitwillreturnavalueof0notradeswerecompletedduringtheentiretradingperiod

NumEvenTradesReturnsanumericalvalue,indicatingthetotalnumberofallcompletedeventrades.

NumEvenTrades

Example

NumEvenTradeswillreturnavalueof10ifthereweretencompletedeventrades

NumEvenTradeswillreturnavalueof0ifnoeventradeswerecompletedduringtheentiretradingperiod

NumLosTradesReturnsanumericalvalue,indicatingthenumberofallcompletedlosingtrades.

NumLosTrades

Example

NumLosTradeswillreturnavalueof5iftherewereatotaloffivecompletedlosingtrades

NumLosTradeswillreturnavalueof0ifnolosingtradeswerecompletedduringtheentiretradingperiod

NumWinTradesReturnsanumericalvalue,indicatingthenumberofallcompletedwinningtrades.

NumWinTrades

Example

NumWinTradeswillreturnavalueof5iftherewereatotaloffivecompletedwinningtrades

NumWinTradeswillreturnavalueof0ifnowinningtradeswerecompletedduringtheentiretradingperiod

PercentProfitReturnsanumericalvalue,indicatingthepercentageofwinningtradesinalltradescompleted.

PercentProfit

Example

PercentProfitwillreturnavalueof70ifsevenoutofthetotalof10completedtradeswerewinningtrades

SetCustomFitnessValue

Setsavalueofthecustomcriterionthatistobeusedforoptimization.

SetCustomFitnessValue(Criterion)

Where:Criterion-anexpressionspecifyingacustomcriterionvalue.

ThisfunctioncanbeusedonlyinsignalsTousethecustomfitnessvalue:1. Opengeneticalgorithmpropertieswindow;2. Setthenumberofsimulationsbychangingtheinputsrange;3. SelecttheAlgorithm-SpecifiedPropertiestab;4. SelecttheCustomFitnessValuefromthelistundertheStandard

Criteriasection.

Example

Setthegrossprofittobeacustomcriterionforgeneticoptimization

SetCustomFitnessValue(GrossProfit);

Settheformulatobeacustomcriterionforgeneticoptimization

SetCustomFitnessValue(TotalTrades/(GrossLoss+GrossProfit));

TotalBarsEvenTradesReturnsanumericalvalue,indicatingthetotalnumberofbarsapositionwasheldduringallcompletedeventrades.

TotalBarsEvenTrades

Example

TotalBarsEvenTradeswillreturnavalueof14iffoureventradesheldpositionsfor2,5,3,and4bars

TotalBarsEvenTradeswillreturnavalueof0ifnoeventradeswerecompletedduringtheentiretradingperiod

TotalBarsLosTradesReturnsanumericalvalue,indicatingthetotalnumberofbarsapositionwasheldduringallcompletedlosingtrades.

TotalBarsLosTrades

Example

TotalBarsLosTradeswillreturnavalueof14iffourlosingtradesheldpositionsfor2,5,3,and4bars

TotalBarsLosTradeswillreturnavalueof0ifnolosingtradeswerecompletedduringtheentiretradingperiod

TotalBarsWinTradesReturnsanumericalvalue,indicatingthetotalnumberofbarsapositionwasheldduringallcompletedwinningtrades.

TotalBarsWinTrades

Example

TotalBarsWinTradeswillreturnavalueof14iffourwinningtradesheldpositionsfor2,5,3,and4bars

TotalBarsWinTradeswillreturnavalueof0ifnowinningtradeswerecompletedduringtheentiretradingperiod

TotalTradesReturnsanumericalvalue,indicatingthetotalnumberofallcompletedtrades.

TotalTrades

Example

TotalTradeswillreturnavalueof5iftherewereatotaloffivecompletedtrades

TotalTradeswillreturnavalueof0ifnotradeswerecompletedduringtheentiretradingperiod

BarsSinceEntry

Returnsanumericalvalue,indicatingthenumberofbarssincetheinitialentryintothespecifiedposition.

BarsSinceEntry(PosBack)

Where:PosBack-anumericalexpression,specifyingtheposition:

0-openposition;1-onepositionback(thelastpositionclosed);2-twopositionsback,etc.

IfPosBackisnotspecified,avaluefortheopenpositionwillbereturned.

Example

Assignavalue,indicatingthenumberofbarssincethecurrentpositionhasbeenentered,toValue1variable:

Value1=BarsSinceEntry;

Assignavalue,indicatingthenumberofbarssincethemostrecentlyclosedpositionhasbeenentered,toValue1variable:

Value1=BarsSinceEntry(1);

BarsSinceEntry_Checked

Returnsanumericalvalue,indicatingthenumberofbarssincetheinitialentryintothespecifiedposition.

BarsSinceEntry_Checked(PosBack)

1. Thisfunctioncanonlybeusedinsignals.2. IfPosBackvalueisgreaterthattherealnumberofpreviouslyopened

positions,BarsSinceEntry_Checkedwillgenerateanerror.

Example

Assignavalue,indicatingthenumberofbarssincethecurrentpositionhasbeenentered,toValue1variable:

Value1=BarsSinceEntry_Checked;

Assignavalue,indicatingthenumberofbarssincethemostrecentlyclosedpositionhasbeenentered,toValue1variable:

Value1=BarsSinceEntry_Checked(1);

BarsSinceExit

Returnsanumericalvalue,indicatingthenumberofbarssinceacompleteexitfromthespecifiedposition.

BarsSinceExit(PosBack)

1-thelastpositionclosed(onepositionback);2-twopositionsback,etc.

Example

Assignavalue,indicatingthenumberofbarssincethelastpositionhasbeenclosed,toValue1variable:

Value1=BarsSinceExit(1);

BarsSinceExit_Checked

Returnsanumericalvalue,indicatingthenumberofbarssinceacompleteexitfromthespecifiedposition.

BarsSinceExit_Checked(PosBack)

positions,BarsSinceExit_Checkedwillgenerateanerror.

Example

Assignavalue,indicatingthenumberofbarssincethelastpositionhasbeenclosed,toValue1variable:

Value1=BarsSinceExit_Checked(1);

ContractProfit

Returnsanumericalvalue,indicatingthecurrentprofitorlosspereachcontractorshareofamulti-shareormulti-contractposition.

ContractProfit

Example

Assignavalue,indicatingthecurrentprofitorlosspercontractorshare,toValue1variable:

Value1=ContractProfit;

CurrentContracts

Returnsanabsolutenumericalvalue,indicatingthenumberofcontractsorsharesheldinthecurrentposition.

CurrentContracts

Example

CurrentContractswillreturnavalueof1for1contractlong

CurrentContractswillreturnavalueof5for5sharesshort

CurrentEntries

Returnsanumericalvalue,indicatingthenumberofopenentriesforthecurrentposition.

CurrentEntries

Example

Assignavalue,indicatingthenumberofopenentriesinthecurrentposition,toValue1variable:

Value1=CurrentEntries;

CurrentSharesSameasCurrentContracts

EntryDate

Returnsanumericalvalue,indicatingthedateofinitialentryintothespecifiedposition.ThedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

EntryDate(PosBack)

Example

Assignavalue,indicatingthedatethatthecurrentpositionhasbeenentered,toValue1variable:

Value1=EntryDate;

Value1willequalto1081030fortheentrydateofOctober30th,2008

Assignavalue,indicatingthedatethatthemostrecentlyclosedpositionhasbeenentered,toValue1variable:

Value1=EntryDate(1);

Value1willequalto990402fortheentrydateofApril2nd,1999

EntryDateTime

Returnsadouble-precisiondecimalDateTimevalueindicatingthedateandtimeofthebarwheretheorderthatopenedaspecifiedpositionwasgenerated.TheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.DateTimeisafloatingpointvaluewithhighprecision.Itallowsaccessingmillisecondtimestampsofthebar.

EntryDateTime(PosBack)

Example

Value1=EntryDateTime;

EntryDateTime_Checked

Returnsadouble-precisiondecimalDateTimevalueindicatingthedateandtimeofthebarwheretheorderthatopenedaspecifiedpositionwasgenerated.TheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.DateTimeisafloatingpointvaluewithhighprecision.Itallowsaccessingmillisecondtimestampsofthebar.

EntryDateTime_Checked(PosBack)

IfPosBackvalueisgreaterthattherealnumberofpreviouslyopenedpositions,EntryDateTime_Checkedwillgenerateanerror.

Example

Value1=EntryDateTime_Checked;

EntryDate_Checked

Returnsanumericalvalue,indicatingthedateofinitialentryintothespecifiedposition.

EntryDate_Checked(PosBack)

positions,EntryDate_Checkedwillgenerateanerror.

Example

Value1=EntryDate_Checked;

Value1willequalto1081030fortheentrydateofOctober30th,2008

Assignavalue,indicatingthedatethatthemostrecentlyclosedpositionhasbeen

entered,toValue1variable:

Value1=EntryDate_Checked(1);

Value1willequalto990402fortheentrydateofApril2nd,1999

EntryName

Returnsthenameoftheorderwhichopenedtheposition.

EntryName(PosBack)

0-openposition;

1-onepositionback(thelastpositionclosed);

2-twopositionsback,etc.

Example

EntryName(1)willreturnavalueof"buyLE"forthelastclosedposition,ifthispositionwasopenedbytheorderwith"buyLE"name.

EntryPrice

Returnsanumericalvalue,indicatingthepriceattheinitialentryintothespecifiedposition.

EntryPrice(PosBack)

Example

Assignavalue,indicatingtheentrypriceforthecurrentposition,toValue1variable:

Value1=EntryPrice;Assignavalue,indicatingtheentrypriceforthemostrecentlyclosedposition,toValue1variable:

Value1=EntryPrice(1);

EntryPrice_Checked

Returnsanumericalvalue,indicatingthepriceattheinitialentryintothespecifiedposition.

EntryPrice_Checked(PosBack)

positions,EntryPrice_Checkedwillgenerateanerror.

Example

Assignavalue,indicatingtheentrypriceforthecurrentposition,toValue1variable:

Value1=EntryPrice_Checked;

Assignavalue,indicatingtheentrypriceforthemostrecentlyclosedposition,toValue1variable:

Value1=EntryPrice_Checked(1);

EntryTime

Returnsanumericalvalue,indicatingthetimeofinitialentryintothespecifiedposition.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

EntryTime(PosBack)

Example

Assignavalue,indicatingthetimethatthecurrentpositionhasbeenentered,toValue1variable:

Value1=EntryTime;

Value1willequalto1015for10:15AM

Assignavalue,indicatingthetimethatthemostrecentlyclosedpositionhasbeenentered,toValue1variable:

Value1=EntryTime(1);

Value1willequalto1545for3:45PM

EntryTime_Checked

Returnsanumericalvalue,indicatingthetimeofinitialentryintothespecifiedposition.

EntryTime_Checked(PosBack)

positions,EntryTime_Checkedwillgenerateanerror.

Example

Assignavalue,indicatingthetimethatthecurrentpositionhasbeenentered,toValue1variable:

Value1=EntryTime_Checked;

Value1willequalto1015for10:15AM.

Assignavalue,indicatingthetimethatthemostrecentlyclosedpositionhasbeenentered,toValue1variable:

Value1=EntryTime_Checked(1);

Value1willequalto1015for10:15AM.

ExitDate

Returnsanumericalvalue,indicatingthedateofthecompleteexitfromthespecifiedposition.ThedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

ExitDate(PosBack)

Example

Assignavalue,indicatingthedatethatthemostrecentlyclosedpositionhasbeenexited,toValue1variable:

Value1=ExitDate(1);

Value1willequalto1081030fortheexitdateofOctober30th,2008

ExitDateTime

Returnsadouble-precisiondecimalDateTimevalueindicatingthedateandtimeofthebarwheretheorderthatclosedaspecifiedpositionwasgenerated.TheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.DateTimeisafloatingpointvaluewithhighprecision.Itallowsaccessingmillisecondtimestampsofthebar.

ExitDateTime(PosBack)

Example

Value1=ExitDateTime(1);

ExitDateTime_Checked

Returnsadouble-precisiondecimalDateTimevalueindicatingthedateandtimeofthebarwheretheorderthatclosedaspecifiedpositionwasgenerated.TheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.DateTimeisafloatingpointvaluewithhighprecision.Itallowsaccessingmillisecondtimestampsofthebar.

ExitDateTime_Checked(PosBack)

IfPosBackvalueisgreaterthattherealnumberofpreviouslyopenedpositions,ExitDateTime_Checkedwillgenerateanerror.

Example

Value1=ExitDateTime_Checked(1);

ExitDate_Checked

Returnsanumericalvalue,indicatingthedateofthecompleteexitfromthespecifiedposition.ThedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth.

ExitDate_Checked(PosBack)

positions,ExitDate_Checkedwillgenerateanerror.

Example

Value1=ExitDate_Checked(1);

Value1willequalto1081030fortheexitdateofOctober30th,2008.

ExitName

Returnsthenameoftheorderwhichclosedtheposition.

ExitName(PosBack)

0-openposition;

Example

ExitName(1)willreturnavalueof"sellLX"forthelastclosedposition,ifthispositionwasclosedbytheorderwith"sellLX"name.

ExitPrice

Returnsanumericalvalue,indicatingthepriceatacompleteexitfromthespecifiedposition.

ExitPrice(PosBack)

Example

Assignavalue,indicatingtheexitpriceofthemostrecentlyclosedposition,toValue1variable:

Value1=ExitPrice(1);

ExitPrice_Checked

Returnsanumericalvalue,indicatingthepriceatacompleteexitfromthespecifiedposition.

ExitPrice_Checked(PosBack)

1-onepositionback(thelastpositionclosed);2-twopositionsback,etc.

positions,ExitPrice_Checkedwillgenerateanerror.

Example

Assignavalue,indicatingtheexitpriceofthemostrecentlyclosedposition,toValue1variable:

Value1=ExitPrice_Checked(1);

ExitTime

Returnsanumericalvalue,indicatingthetimeatthecompleteexitfromthespecifiedposition.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

ExitTime(PosBack)

Example

Assignavalue,indicatingthetimethatthemostrecentlyclosedpositionhasbeenexited,toValue1variable:

Value1=ExitTime(1);

Value1willequalto1545for3:45PM

ExitTime_Checked

Returnsanumericalvalue,indicatingthetimeatthecompleteexitfromthespecifiedposition.Thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM.

ExitTime_Checked(PosBack)

positions,ExitTime_Checkedwillgenerateanerror.

Example

Assignavalue,indicatingthetimethatthemostrecentlyclosedpositionhasbeenexited,toValue1variable:

Value1=ExitTime_Checked(1);

Value1willequalto1545for3:45PM.

i_MarketPosition_at_BrokerReturnsanumericalvalue,indicatingthenumberofcontractsandthetypeofpositionatthebrokerforthesymbol.

i_MarketPosition_at_Broker

Thisfunctiondiffersfromthemarketpositionkeywordinthatitcannottakeanargumenttoreferencepastvalues.Bysavingthevalueofi_MarketPosition_at_BrokertoaNumericVariable,it'spossibletoreferencethepositionatthebrokerforpreviousbarsortick.

I_MarketPosition_at_Brokerworkswithallbrokers,thoughtherearesomepeculiaritieswithMIGBankandTradingTechnologies:ForMIGBank,MultiChartscalculatesthebrokerpositionafterthebrokerprofilehasbeenconnectedsincethisisn'tprovidedbyMIGBank.TheTradingTechnologiesAPIdoesn'tprovideinformationaboutpositionsopenedthedaybefore,inwhichcaseMultiChartsusestheaverageofallcompletelong(short)tradesforthedaytocalculatetheEntryPrice.

Important

Example

i_MarketPosition_at_Brokerwillwillreturn'17'ifthecurrentpositionatthebrokerforthestrategyis17contractslong.

i_MarketPosition_at_Brokerwillreturn'-132'ifthecurrentpositionatthebrokerforthestrategyis132contractsshort.

i_MarketPosition_at_Brokerwillreturn'0'ifthecurrentpositionatthebrokerforthestrategyisflat.

i_MarketPosition_at_Brokerwillreturn'0'iftheAutomatedTradingModeisnotturnedon.

i_MarketPosition_at_Broker_for_The_StrategyReturnsanumericalvalue,indicatingthenumberofcontractsandthetypeofpositionatthebrokerforthestrategy.

i_MarketPosition_at_Broker_for_The_Strategy

Thisfunctiondiffersfromthemarketpositionkeywordinthatitcannottakeanargumenttoreferencepastvalues.Bysavingthevalueofi_MarketPosition_at_Broker_for_The_StrategytoaNumericVariable,it'spossibletoreferencethepositionatthebrokerforpreviousbarsortick.

Important

Example

i_MarketPosition_at_Broker_for_The_Strategywillwillreturn'17'ifthecurrentpositionatthebrokerforthestrategyis17contractslong.

i_MarketPosition_at_Broker_for_The_Strategywillreturn'-132'ifthecurrentpositionatthebrokerforthestrategyis132contractsshort.

i_MarketPosition_at_Broker_for_The_Strategywillreturn'0'ifthecurrentpositionatthebrokerforthestrategyisflat.

i_MarketPosition_at_Broker_for_The_Strategywillreturn'0'iftheAutomatedTradingModeisnotturnedon.

MarketPosition

Returnsanumericalvalue,indicatingthetypeofthespecifiedposition.

Avalueof1indicatesalongposition,-1indicatesashortposition,and0isreturnedonlyifthecurrentpositionisspecifiedandindicatesthatthecurrentpositionisflat.

MarketPosition(PosBack)

Example

MarketPositionwillreturnavalueof0ifthecurrentpositionisflat

MarketPosition(1)willreturnavalueof-1ifthemostrecentlyclosedpositionwasashortposition

MarketPosition_at_BrokerReturnsanumericalvalue,indicatingthenumberofcontractsandthetypeofpositionatthebrokerforthesymbol.

MarketPosition_at_Broker

Thisfunctiondiffersfromthemarketpositionkeywordinthatitcannottakeanargumenttoreferencepastvalues.

ThisfunctioncanonlybeusedwithInteractiveBrokers,Patsystems,andZen-Fire.

Important

Example

MarketPosition_at_Brokerwillwillreturn'17'ifthecurrentpositionatthebrokerforthestrategyis17contractslong.

MarketPosition_at_Brokerwillreturn'-132'ifthecurrentpositionatthebrokerforthestrategyis132contractsshort.

MarketPosition_at_Brokerwillreturn'0'ifthecurrentpositionatthebrokerforthestrategyisflat.

MarketPosition_at_Brokerwillreturn'0'iftheAutomatedTradingModeisnotturnedon.

MarketPosition_at_Broker_for_The_StrategyReturnsanumericalvalue,indicatingthenumberofcontractsandthetypeofpositionatthebrokerforthestrategy.

MarketPosition_at_Broker_for_The_Strategy

Thisfunctiondiffersfromthemarketpositionkeywordinthatitcannottakeanargumenttoreferencepastvalues.

Important

Example

MarketPosition_at_Broker_for_The_Strategywillwillreturn'17'ifthecurrentpositionatthebrokerforthestrategyis17contractslong.

MarketPosition_at_Broker_for_The_Strategywillreturn'-132'ifthecurrentpositionatthebrokerforthestrategyis132contractsshort.

MarketPosition_at_Broker_for_The_Strategywillreturn'0'ifthecurrent

positionatthebrokerforthestrategyisflat.

MarketPosition_at_Broker_for_The_Strategywillreturn'0'iftheAutomatedTradingModeisnotturnedon.

MarketPosition_Checked

Returnsanumericalvalue,indicatingthetypeofthespecifiedposition.

Avalueof1indicatesalongposition,-1indicatesashortposition,and0isreturnedonlyifthecurrentpositionisspecifiedandindicatesthatthecurrentpositionisflat.

MarketPosition_Checked(PosBack)

positions,MarketPosition_Checkedwillgenerateanerror.

Example

MarketPosition_Checked-willreturnavalueof0ifthecurrentpositionisflat.

MarketPosition_Checked(1)-willreturnavalueof-1ifthemostrecentlyclosedpositionwasashortposition.

MaxContractProfit

Returnsanumericalvalue,indicatingthelargestgainreachedpereachcontractorshareofacurrentmulti-shareormulti-contractposition.

MaxContractProfit

Example

Assignavalue,indicatingthelargestgainreachedpercontractorshare,toValue1variable:

Value1=MaxContractProfit;

MaxContractProfit_Checked

Returnsanumericalvalue,indicatingthelargestgainreachedpereachcontractorshareofacurrentmulti-shareormulti-contractposition.

MaxContractProfit_Checked

positions,MaxContractProfit_Checkedwillgenerateanerror.

Example

Assignavalue,indicatingthelargestgainreachedpercontractorshare,toValue1variable:

Value1=MaxContractProfit_Checked

MaxContracts

Returnsanabsolutenumericalvalue,indicatingthemaximumnumberofcontractsheldduringthespecifiedposition.

MaxContracts(PosBack)

Example

MaxContractswillreturnavalueof0ifthecurrentpositionisflat

MaxContracts(1)willreturnavalueof10ifthemostrecentlyclosedpositionwaslongorshortamaximumof10contracts

MaxContracts_Checked

Returnsanabsolutenumericalvalue,indicatingthemaximumnumberofcontractsheldduringthespecifiedposition.

MaxContracts_Checked(PosBack)

positions,MaxContracts_Checkedwillgenerateanerror.

Example

MaxContracts_Checked-willreturnavalueof0ifthecurrentpositionisflat.

MaxContracts_Checked(1)-willreturnavalueof10ifthemostrecentlyclosedpositionwaslongorshortamaximumof10contracts.

MaxEntries

Returnsanumericalvalue,indicatingthetotalnumberofentriesforthespecifiedposition.

MaxEntries(PosBack)

Example

MaxEntries(1)willreturnavalueof2ifthereweretwoseparateentriesforthemostrecentlyclosedposition

MaxEntries_Checked

MaxEntries_Checked(PosBack)

positions,MaxEntries_Checkedwillgenerateanerror.

Example

MaxEntries_Checked(1)-willreturnavalueof2ifthereweretwoseparateentriesforthemostrecentlyclosedposition.

MaxPositionLoss

Returnsanegativenumericalvalue,indicatingthelargestlossreachedwhilethespecifiedpositionwasheld.

MaxPositionLoss(PosBack)

Example

MaxPositionLosswillreturnavalueof0ifthevalueoftheopenpositionhasnotdroppedbelowtheentrypriceatanytimewhileitwasheld

MaxPositionLoss(1)willreturnavalueof-10ifthemostrecentlyclosedpositionhasdroppedinvalueasmuchas¤10whileitwasheld

MaxPositionLoss_Checked

Returnsanegativenumericalvalue,indicatingthelargestlossreachedwhilethespecifiedpositionwasheld.

MaxPositionLoss_Checked(PosBack)

positions,MaxPositionLoss_Checkedwillgenerateanerror.

Example

MaxPositionLoss_Checked;-willreturnavalueof0ifthevalueoftheopenpositionhasnotdroppedbelowtheentrypriceatanytimewhileitwasheld.

MaxPositionLoss_Checked(1);-willreturnavalueof-10ifthemostrecentlyclosedpositionhasdroppedinvalueasmuchas¤10whileitwasheld.

MaxPositionProfit

Returnsanumericalvalue,indicatingthelargestgainreachedwhilethespecifiedpositionwasheld.

MaxPositionProfit(PosBack)

Example

MaxPositionProfitwillreturnavalueof0ifthevalueoftheopenpositionhasnotincreasedatanytimewhileitwasheld

MaxPositionProfit(1)willreturnavalueof10ifthemostrecentlyclosedpositionhasgainedinvalueasmuchas¤10whileitwasheld

MaxPositionProfit_Checked

Returnsanumericalvalue,indicatingthelargestgainreachedwhilethespecifiedpositionwasheld.

MaxPositionProfit_Checked(PosBack)

positions,MaxPositionProfit_Checkedwillgenerateanerror.

Example

MaxPositionProfit_Checked;-willreturnavalueof0ifthevalueoftheopenpositionhasnotincreasedatanytimewhileitwasheld.

MaxPositionProfit_Checked(1);-willreturnavalueof10ifthemostrecentlyclosedpositionhasgainedinvalueasmuchas¤10whileitwasheld.

MaxPositionsAgo

Returnsthenumberofclosedpositionsforthestrategyonthecurrentmoment.

MaxPositionsAgo

ThisfunctioncanonlybeusedinSignals.

Example

CalculatethePnLforallclosedpositionsuptothecurrentmoment:

var:TotalProfitLoss(0),idx(0);foridx=1toMaxPositionsAgoBeginTotalProfitLoss=PositionProfit(idx);End;

MaxSharesSameasMaxContracts

MaxShares_CheckedSameasMaxContracts_Checked

OpenPositionProfit

Returnsanumericalvalue,indicatingthecurrentunrealizedprofitorlossfortheopenposition.

OpenPositionProfit

Example

OpenPositionProfitwillreturnavalueof0ifthecurrentpositionisflat

OpenPositionProfitwillreturnavalueof10ifthevalueoftheopenpositionhasincreasedby¤10sinceitwasentered

OpenPositionProfitwillreturnavalueof-5ifthevalueoftheopenpositionhasdecreasedby¤5sinceitwasentered

PositionProfit

Returnsanumericalvalue,indicatingthetotalrealizedprofitorlossforthespecifiedclosedposition.

PositionProfit(PosBack)

Where:PosBack-anumericalexpression,specifyingtheclosedposition:

Example

PositionProfit(0)willreturnavalueof5ifthevalueoftheopenpositionhasincreasedby¤5sinceitwasentered

PositionProfit(1)willreturnavalueof-5ifthemostrecentlyclosedpositionhasgeneratedalossof¤5

PositionProfit_Checked

Returnsanumericalvalue,indicatingtheprofitorlossforthespecifiedposition.

PositionProfit_Checked(PosBack)

positions,PositionProfit_Checkedwillgenerateanerror.

Example

PositionProfit_Checked;-willreturnavalueof0ifthecurrentpositionisflat.

PositionProfit_Checked(0);-willreturnavalueof5ifthevalueoftheopenpositionhasincreasedby¤5sinceitwasentered.

PositionProfit_Checked(1);-willreturnavalueof-5ifthemostrecentlyclosedpositionhasgeneratedalossof¤5.

ChangeMarketPosition

Placestheorderwithsetnameandpriceonthechart.

ChangeMarketPosition(Delta,Price,Name)

Where:Delta-numberofcontractsbywhichcurrentmarketpositionshouldbechanged;Price-orderfillingprice;Name-nameoftheorderthatchangestheposition.

Canbeusedasameanofsynchronizationofstrategymarketpositionwithabroker.

Example

IfMarketPosition=2thenChangeMarketPosition(-2,100,"LX")

Willplacecloseorderwiththename"LX"andtheprice100ifcurrentmarketposition=2

IfMarketPosition=0thenChangeMarketPosition(-2,100,"SE")

Willplaceopenorderwiththename"SE"andtheprice100ifcurrentmarketposition=0

Pleasereferto"!FromStrategyToBrokerMPSynchronizer!"defaultsignalformoreexamples.

PlaceMarketOrder

Placesmarketorderatthebrokerwithoutpositionchangingonthechart.

PlaceMarketOrder(IsBuy,IsEntry,Contracts)

Where:IsBuy-indicateswhetherorderisbuyorsell;IsEntry-indicateswhetherorderisentryorexit;Contracts-indicatesthenumberofcontracts/sharesoftheorder.

Worksonlywithautotradingturnedon.

Canbeusedasameanofsynchronizationofstrategymarketpositionwithabroker.

Example

IfMarketPosition*CurrentContracts=2andMarketPosition_at_Broker=4thenPlaceMarketOrder(false,false,2);

willgeneratesellmarketorderfor2contractstosynchronizemarketpositionatbrokerwiththestrategyposition

Pleasereferto"!FromStrategyToBrokerMPSynchronizer!"defaultsignalformoreexamples.

OpenEntriesCount

SameasCurrentEntries.

OpenEntryComission

Returnsanumericalvalue,indicatingtheamountofcashassetsintheunitsoftheselectedcurrencyspentonthecommissionforspecifiedtrade.

OpenEntryComission(EntryIndex)

Where:EntryIndex-anumericalexpression,specifyingthenumberoftrade(zero-based).

ToretrievethetotalnumberoftradesinopenpositionuseOpenEntriesCount

Example

OpenEntryComission(1)willreturnavalueof1iftherehasbeenoneunitoftheselectedcurrencycomissionforthesecondtradeoftheopenposition.

OpenEntryContracts

Returnsanumericalvalue,indicatingthequantityofcontractsofspecifiedentryorderintotheopenposition.

OpenEntryContracts(EntryIndex)

Example

OpenEntryContractswillreturnavalueof1forthefirsttradeofthe3contractsopenpositionifithastwoopentradesfor1and2contracts.

OpenEntryContracts(1)willreturnavalueof2forthesecondtradeofthe3contractsopenpositionifithastwoopentradesfor1and2contracts.

OpenEntryDate

Returnsanumericalvalue,indicatingthedateofspecifiedentryintotheopenposition.

OpenEntryDate(EntryIndex)

Example

OpenEntryDate(1)willreturn1110402fortheopenpositionifthesecondtradewasgeneratedonApril2nd,2011.

OpenEntryMaxProfit

Returnsanumericalvalue,indicatingmaximalvalueofOpenEntryProfitforthetimefromentryorderexecution.

OpenEntryMaxProfit(EntryIndex)

Example

OpenEntryMaxProfitwillreturnavalueof20forthefirsttradeoftheopenpositionifithaseverreached20unitsofthespecifiedcurrencymaximumprofit.

OpenEntryMaxProfitPerContract

Returnsanumericalvalue,indicatingmaximalvalueofOpenEntryProfitPerContractforthetimefromentryorderexecution.

OpenEntryMaxProfitPerContract(EntryIndex)

Example

OpenEntryMaxProfitPerContract(1)willreturnavalueof1.5forthefirsttradeoftheopenpositionifithaseverreached1.5unitsofthespecifiedcurrencypercontractprofit.

OpenEntryMinProfit

Returnsanumericalvalue,indicatingminimalvalueofOpenEntryProfitforthetimefromentryorderexecution.

OpenEntryMinProfit(EntryIndex)

Example

OpenEntryMinProfit(1)willreturnavalueof-15forthesecondtradeoftheopenpositionifithaseverreached15unitsofthespecifiedcurrencyloss.

OpenEntryMinProfitPerContract

Returnsanumericalvalue,indicatingminimalvalueofOpenEntryProfitPerContractforthetimefromentryorderexecution.

OpenEntryMinProfitPerContract(EntryIndex)

Example

OpenEntryMinProfitPerContract(1)willreturnavalueof-1.5forthesecondtradeoftheopenpositionifithaseverreached1.5unitsofthespecifiedcurrencypercontractloss.

OpenEntryPrice

Returnsanumericalvalue,indicatingthepriceofspecifiedentryintotheopenposition.

OpenEntryPrice(EntryIndex)

Example

OpenEntryPricewillreturnavalueof101forthefirsttradeoftheopenpositionifitwasexecutedat101pricelevel.

OpenEntryPrice(1)willreturnavalueof101.5forthesecondtradeoftheopenpositionifitwasexecutedat101.5pricelevel.

OpenEntryProfit

Returnsanumericalvalue,indicatingtheprofit(lossifnegative)ofspecifiedentryintotheopenpositioninthespecifiedcurrency.

OpenEntryProfit(EntryIndex)

Example

OpenEntryProfitwillreturnavalueof10forthefirsttradeoftheopenpositionifithas10unitsofthespecifiedcurrencyprofitatthemoment.

OpenEntryProfit(1)willreturnavalueof-10forthesecondtradeoftheopenpositionifithasreached10unitsofthespecifiedcurrencylossatthemoment.

OpenEntryProfitPerContract

Returnsanumericalvalue,indicatingtheprofit(lossifnegative)percontractofspecifiedentryinthespecifiedcurrency.

OpenEntryProfitPerContract(EntryIndex)

Example

OpenEntryProfitPerContractwillreturnavalueof1forthefirsttradeoftheopenpositionifithas1unitoftheselectedcurrencypercontractprofitatthemoment.

OpenEntryProfitPerContract(1)willreturnavalueof-0.5forthesecondtradeoftheopenpositionifithasreached0.5unitsoftheselectedcurrencypercontractlossatthemoment.

OpenEntryTime

Returnsanumericalvalue,indicatingthetimeofspecifiedentryintotheopenposition.

ThetimeisindicatedintheHHmmformat,whereHHisthehourin24hoursformatandmmareminutes.

OpenEntryTime(EntryIndex)

Example

OpenEntryTimewillreturnavalueof1015forthefirsttradeoftheopenpositionifitwasexecutedat10:15AM.

OpenEntryTime(1)willreturnavalueof1545forthesecondtradeoftheopenpositionifitwasexecutedat3:45PM.

PosTradeCommission

Returnsanabsolutenumericalvalue,indicatingthecommissionamountspentforthespecifiedtrade.

PosTradeCommission(PosAgo,TradeNumber)

Where:PosAgo-anumericalexpression,specifyingtheposition:

0-openposition;

TradeNumber-anumericalexpression,specifyingthenumberoftrade(zero-based).

ToretrievethetotalnumberoftradesinspecifiedpositionusePosTradeCount

Example

PosTradeCommission(0,1)willreturnavalueof5forthesecondtradeoftheopenposition,ifthecommissionforthistradeis5unitsoftheselectedcurrency.

PosTradeCount

PosTradeCount(PosBack)

0-openposition;

Thisfunctioncanonlybeusedinsignals.Pleasenotethatifthereisasingleentryandmultiplescalpingexits,eachexitwillhaveitsownentryinthiscaseandthecountwillincreaseaftereachpartialexit.

Example

PosTradeCount(1)willreturnavalueof2ifthereweretwoseparateentriesforthemostrecentlyclosedposition.

PosTradeEntryBar

Returnsanabsolutenumericalvalue,indicatingbarnumberofthetradeentryorder.

PosTradeEntryBar(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeEntryBar(0,1)willreturnavalueof25forthesecondtradeoftheopenposition,ifthistradewasopenedon25thbar.

PosTradeEntryCategory

Returnsanabsolutenumericalvalue,indicatingtradeentryordercategory.

Thefollowingtypesarepossible:

1=Stoporder(buynextbaratclose-1pointstop)2=Limitorder(buynextbaratclose+1pointlimit)3=Marketorder(buynextbarmarket)4=MarketatCloseorder(buythisbaratclose)5=MarketatOpenorder(buynextbaropen)6=Reservedforspecialorders7=Reservedforspecialorders8=StopLimitorder(buy1contractsnextbaratclose-2pointstopclose+2pointlimit)

PosTradeEntryCategory(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeEntryCategory(0,1)willreturnavalueof1forthesecondtradeoftheopenposition,iftheordertypewasStopOrder.

PosTradeEntryDateTime

Returnsdouble-precisiondecimalDateTimeforentryorder.AsanexampleseeComputerDateTime

PosTradeEntryDateTime(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeEntryDateTime(0,1)willreturnavalueof39448.25000000forthesecondtradeoftheopenposition,ifthistradewasopenedat6:00AMonJanuary1st,2008.

PosTradeEntryName

Returnsentryordername.EntryNameisindicatedonthechartandinOrderandPositionTrackerWindow.

PosTradeEntryName(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeEntryName(0,1)willreturnavalueof"buyLE"forthesecondtradeoftheopenposition,ifthistradewasopenedbytheorderwith"buyLE"name.

PosTradeEntryPrice

Returnsanabsolutenumericalvalue,indicatingtheexecutionpriceoftradeentryorder.

PosTradeEntryPrice(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeEntryPrice(0,1)willreturnavalueof100.2forthesecondtradeoftheopenposition,ifthistradewasopenedbytheorderfilledat100.2.

PosTradeExitBar

Returnsanabsolutenumericalvalue,indicatingbarnumberofthetradeexitorder.

PosTradeExitBar(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeExitBar(0,1)willreturnavalueof28forthesecondtradeoftheopenposition,ifthistradewasclosedon28thbar.

PosTradeExitCategory

Returnsanabsolutenumericalvalue,indicatingtradeexitordercategory.

Thefollowingtypesarepossible:

1=Stoporder(buynextbaratclose-1pointstop)2=Limitorder(buynextbaratclose+1pointlimit)3=Marketorder(buynextbarmarket)4=MarketatCloseorder(buythisbaratclose)5=MarketatOpenorder(buynextbaropen)6=Reservedforspecialorders7=Reservedforspecialorders8=StopLimitorder(buy1contractsnextbaratclose-2pointstopclose+2pointlimit)

PosTradeExitCategory(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeExitCategory(0,1)willreturnavalueof3forthesecondtradeoftheopenposition,iftheclosingordertypewasMarketOrder.

PosTradeExitDateTime

Returnsdouble-precisiondecimalDateTimeforexitorder.AsanexampleseeComputerDateTime

PosTradeExitDateTime(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeEntryDateTime(1,1)willreturnavalueof39448.25000000forthesecondtradeofthelastclosedposition,ifthistradewasclosedat6:00AMonJanuary1st,2008.

PosTradeExitName

Returnsexitordername.ExitNameisindicatedonthechartandinOrderandPositionTrackerWindow.

PosTradeExitName(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeExitName(0,1)willreturnavalueof"sellLX"forthesecondtradeoftheopenposition,ifthistradewasclosedbytheorderwith"sellLX"name.

PosTradeExitPrice

Returnsanabsolutenumericalvalue,indicatingtheexecutionpriceoftradeexitorder.

PosTradeExitPrice(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeExitPrice(0,1)willreturnavaluevalueof100.5forthesecondtradeoftheopenposition,ifthistradewasclosedbytheorderfilledat100.5.

PosTradeIsLong

ReturnsTruevalueifthetradewasopenedbybuyorder,otherwiseFalsevalueisreturned.

PosTradeIsLong(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeIsLong(0,1)willreturnTrueforthesecondtradeoftheopenposition,ifthistradewasopenedby"buy"order.

PosTradeIsOpen

ReturnsTruevalueifthetradeisopen,Falsevalueifthetradeisclosed.

Itmakessensetocheckthetradesoftheopenposition.

ForotherpositionsFalseisalwaysreturned.

PosTradeIsOpen(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeIsOpen(0,1)willreturnTrueforthesecondtradeoftheopenposition,ifthistradeisopened(therewasnoclosingorder).

PosTradeProfit

Returnsanabsolutenumericalvalue,indicatingtheprofit(orlossifnegative)ofthespecifiedtrade.

PosTradeProfit(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeProfit(0,1)willreturnavalueof3forthesecondtradeoftheopenposition,iftheprofitforthistradeis3unitsoftheselectedcurrency.

PosTradeSize

Returnsanabsolutenumericalvalue,indicatingthenumberofcontractsorsharesinthespecifiedtrade.

PosTradeSize(PosAgo,TradeNumber)

0-openposition;

Example

PosTradeSize(0,1)willreturnavalueof2forthesecondtradeoftheopenposition,ifthistradehadaquantityof2.

CommissionReturnsthecommissioncurrencyvalueenteredintheStrategyPropertieswindow.

Commission

Example

Commissionwillreturnavalueof10.00ifthecommissionhasbeensetto¤10

GetStrategyNameRetainedforbackwardcompatibility.

MarginReturnsavalueinunitsoftheselectedcurrencythatindicatesthemarginvaluepercontract.

Margin

Themarginvaluemaynotbereturnedforalltypesofthesecurities.Themarginvalueisreturnedforfuturesandoptions.

Example

Margin

SlippageReturnstheslippagecurrencyvalueenteredintheStrategyPropertieswindow.

Slippage

Example

Slippagewillreturnavalueof0.25iftheslippagehasbeensetto¤0.25

MC_Text_GetActiveReturnsanumericalvalueindicatingthetextIDnumberofthecurrentlyselectedtext;returnsavalueof-1ifnotextiscurrentlyselected.

MC_Text_GetActive

Example

Assignavalue,indicatingthetextIDnumberofthecurrentlyselectedtext,toValue1variable:Value1=MC_Text_GetActive;

Text_Anchor_to_Bars

Anchorsthecorrespondingtextdrawingtothevisiblebarindex;returnsavalueof0iftheoperationwasperformedsuccessfully,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

Text_Anchor_to_Bars(Text_ID,LogicalExpression)

Where:Text_IDisanumericalexpressionspecifyingthetextdrawingIDnumberLogicalExpressionisalogicalvalue;True=addoptionandFalse=removeoption

TextIDnumberisreturnedbyText_Newwhenthetextdrawingiscreated.

Example

AnchorthetextdrawingwithanIDnumberof3tothevisiblebarindex:

Value1=Text_Anchor_to_Bars(3,True);

Text_Delete

RemovesatextobjectwiththespecifiedIDnumberfromachart;returnsavalueof0iftheobjectwassuccessfullyremoved,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_Delete(ObjectID)

Anobject-specificIDnumberisreturnedbyText_Newwhenthetextobjectiscreated.

Example

RemovethetextobjectwithanIDnumberof3:

Value1=Text_Delete(3);

Text_GetActive

ReturnsanumericalvalueindicatingtheobjectIDnumberofthecurrentlyselectedtextobject;returnsavalueof-1ifnotextobjectsarecurrentlyselected.

Text_GetActive

Anobject-specificIDnumberisassignedbyText_Newwhenthetextobjectiscreated.

Example

Assignavalue,indicatingtheobjectIDnumberofthecurrentlyselectedtextobject,toValue1variable:

Value1=Text_GetActive;

Text_GetAttribute

ReturnsalogicalvalueindicatingthesettingforanattributeofatextobjectwiththespecifiedIDnumber;returnsavalueofTrueiftheattributeissettoon,andavalueofFalseiftheattributeissettoofforifthespecifiedobjectIDnumberisinvalid.

Thesettingsofthefollowingattributescanbereturned:border,bold,italic,strike-out,andunderline.

Text_GetAttribute(ObjectID,Attribute)

Parameters

Example

Assignatrue/falsevalue,indicatingthesettingof"bold"attributeforthetextobjectwithanIDnumberof3,toBoldvariable:

Variable:Bold(False);

Bold=Text_GetAttribute(3,1);

Text_GetBarNumber

ReturnsanumericalvaluerepresentingthebarnumberofthetextobjectwithaspecifiedID;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetBarNumber(ref);

Parameters:

ref-IDofthetextobject;

Example

GetthenumberofthebarwhereatextobjectwithID=1isplaced:

Text_GetBarNumber(1);

Text_GetBGColor

ReturnsanRGBcolornumberoralegacycolorvaluethatcorrespondtothebackgroundcolorofatextobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetBGColor(ObjectID)

Example

AssignanRGBcolornumber,correspondingtothebackgroundcolorofthetextobjectwithanIDnumberof3,toValue1variable:

Value1=Text_GetBGColor(3);

Assignalegacycolorvalue,correspondingtothebackgroundcolorofthetextobjectwithanIDnumberof3,toValue1variable:

[LegacyColorValue=True];Value1=Text_GetBGColor(3);

Text_GetBorder

Returnsalogicalvalue,indicatingwhetheraborderisaddedtoatextobjectwiththespecifiedIDnumber;returnsavalueofTrueiftheborderhasbeenadded,andavalueofFalseiftheborderhasnotbeenaddedorifthespecifiedobjectIDnumberisinvalid.

Text_GetBorder(ObjectID)

Example

Assignatrue/falsevalue,indicatingwhetheraborderisaddedtothetextobjectwithanIDnumberof3,toBordervariable:

Variable:Border(False);Border=Text_GetBorder(3);

Text_GetColor

ReturnsanRGBcolornumberoralegacycolorvaluethatcorrespondtothecolorofthetextcontainedinatextobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetColor(ObjectID)

Example

AssignanRGBcolornumber,correspondingtothecolorofthetextobjectwithanIDnumberof3,toValue1variable:

Value1=Text_GetColor(3);

Assignalegacycolorvalue,correspondingtothecolorofthetextobjectwithanIDnumberof3,toValue1variable:

[LegacyColorValue=True];Value1=Text_GetColor(3);

Text_GetDate

Returnsanumericalvalue,indicatingthedateofthebaratwhichatextobjectwiththespecifiedIDnumberhasbeenplaced;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetDate(ObjectID)

Example

Assignavalue,indicatingthedateofthebaratwhichatextobjectwiththeIDnumberof3hasbeenplaced,toValue1variable:

Value1=Text_GetDate(3);

Text_GetFirst

Returnsanumericalvalue,indicatinganobjectIDnumberoftheoldest(thefirsttobeaddedtothecurrentchart)textobjectofthespecifiedorigin;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetFirst(Origin)

Parameters

Origin-anumericalexpressionspecifyingtheoriginofthetextobject:

Iftheoldest(thefirstadded)textobjectisdeleted,thenextoldest(thesecondadded)textobjectbecomestheoldest(thefirstadded)textobject.

Example

Assignavalue,indicatinganobjectIDnumberoftheoldesttextobjectaddedtothechartbythecurrentstudy,toValue1variable:

Value1=Text_GetFirst(1);

Text_GetFontName

ReturnsastringexpressioncorrespondingtothenameofthefontassignedtoatextobjectwiththespecifiedIDnumber.

Text_GetFontName(ObjectID)

Example

Text_GetFontName(3)willreturnastringexpressioncorrespondingtothenameofthefontassignedtoatextobjectwiththeIDnumberof3

Text_GetHStyle

ReturnsthehorizontalplacementstyleofatextobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetHStyle(ObjectID)

Return

Horizontalplacementstyle:

0-totherightofthespecifiedbar1-totheleftofthespecifiedbar2-centeredonthespecifiedbar

Example

Assignavalue,indicatingthehorizontalplacementstyleofthetextobjectwithanIDnumberof3,toValue1variable:

Value1=Text_GetHStyle(3);

Text_GetLock

Lockedtextdrawingscannotbemovedmanually.KeywordreturnsavalueofTrueforLockeddrawings,andavalueofFalseforothers.

Text_GetLock(Text_ID)

Where:Text_ID-anumericalexpressionspecifyingthetextdrawingIDnumber

AtextIDnumberisreturnedbyText_Newwhenthetextdrawingiscreated.

Example

AssignLockpropertyofthetextdrawingwithanIDnumberof3toCondition1variable:

Condition1=Text_GetLock(3);

Text_GetNext

ReturnsanIDnumberofthefirstexistingtextobjectaddedsubsequenttoatextobjectwiththespecifiedIDnumber,withbothobjectsofaspecifiedorigin;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetNext(ObjectID,Origin)

Parameters

Origin-anumericalexpressionspecifyingtheoriginofthetextobjects:

Example

AssignavaluetoValue1variable,indicatinganIDnumberofthefirstexistingtextobjectaddedsubsequenttoatextobjectwiththeIDnumberof3,withbothobjectsaddedbythecurrentstudy:

Value1=Text_GetNext(3,1);

Text_GetSize

ReturnsanumericalvalueindicatingthefontsizeassignedtoatextobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetSize(ObjectID)

Example

Assignavalue,indicatingthefontsizeofthetextobjectwithanIDnumberof3,toValue1variable:

Value1=Text_GetSize(3);

Text_GetString

ReturnsastringexpressioncorrespondingtothetextcontainedinatextobjectwiththespecifiedIDnumber.

Text_GetString(ObjectID)

Example

Text_GetString(3)willreturnastringexpressioncorrespondingtothetextcontainedinthetextobjectwithanIDnumberof3

Text_GetTime

Returnsanumericalvalue,indicatingthetimeofthebaratwhichatextobjectwiththespecifiedIDnumberhasbeenplaced;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetTime(ObjectID)

Example

Assignavalue,indicatingthetimeofthebaratwhichatextobjectwiththeIDnumberof3hasbeenplaced,toValue1variable:

Value1=Text_GetTime(3);

Text_GetTime_DT

Returnsadouble-precisiondecimalDateTimevalueindicatingthetimeofthebaratwhichatextobjectwiththespecifiedIDnumberhasbeenplaced;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

ThetimeisindicatedintheDateTimeformat,wheretheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.DateTimeisafloatingpointvaluewithhighprecision.Itallowsaccessingmillisecondtimestampsofthebar.

Text_GetTime_DT(ObjectID)

Anobject-specificIDnumberisreturnedbyText_New_Dtwhenthetextobjectiscreated.

Example

Value1=Text_GetTime_DT(3);

Text_GetTime_s

Returnsanumericalvalueindicatingthetime,includingseconds,ofthebaratwhichatextobjectwiththespecifiedIDnumberhasbeenplaced;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetTime_s(ObjectID)

Anobject-specificIDnumberisreturnedbyText_New_swhenthetextobjectiscreated.

Example

Value1=Text_GetTime_s(3);

Text_GetValue

Returnsthepricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart),atwhichatextobjectwiththespecifiedIDnumberhasbeenplaced;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetValue(ObjectID)

Example

Assignavalue,indicatingthepricevalueatwhichatextobjectwiththeIDnumberof3hasbeenplaced,toValue1variable:

Value1=Text_GetValue(3);

Text_GetVStyle

ReturnstheverticalplacementstyleofatextobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_GetVStyle(ObjectID)

Return

Verticalplacementstyle:

0-belowthespecifiedpricevalue1-abovethespecifiedpricevalue2-centeredonthespecifiedpricevalue

Pricevaluerepresentstheverticalpositioncorrespondingtoavalueonthepricescaleofachart.

Example

Assignavalue,indicatingtheverticalplacementstyleofthetextobjectwithanIDnumberof3,toValue1variable:

Value1=Text_GetVStyle(3);

Text_Get_Anchor_to_Bars

Returnsthevalueofthe"anchortobar"optionofthetextdrawingwithaspecifiedID.

Text_Get_Anchor_to_Bars(Text_ID)

Where:Text_IDisanumericalexpressionspecifyingthetextdrawingIDnumber

TextIDnumberisreturnedbyText_Newwhenthetextdrawingiscreated.

Example

Assign"anchortobars"optionofthetextdrawingwithanIDnumberof3totheCondition1variable:

Condition1=Text_Get_Anchor_to_Bars(3);

Text_Lock

Lockscorrespondingtextdrawingsoitcannotbemovedmanually;returnsavalueof0iftheoperationwasperformedsuccessfully,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

Text_Lock(Text_ID,LogicalExpression)

Where:Text_ID-anumericalexpressionspecifyingthetextdrawingIDnumberLogicalExpression-alogicalvalue;True=AddandFalse=Remove

AtextIDnumberisreturnedbyText_Newwhenthetextdrawingiscreated.

Example

LockthetextdrawingwithanIDnumberof3:

Value1=Text_Lock(3,True);

UnlockthetextdrawingwithanIDnumberof5:

Value1=Text_Lock(5,False);

Text_New

Displaysatextobject,consistingofthespecifiedstringexpressionlocatedatthespecifiedbarandspecifiedpricevalue,onthechartthatthestudyisbasedon;returnsanobject-specificIDnumber,requiredtomodifytheobject.

Text_New(BarDate,BarTime,PriceValue,"Text")

Parameters

Text-thestringexpressiontobedisplayed

Example

Place,onthechartthatthestudyisbasedon,thetext"UpT"atthetopofabariftheOpenpricehasincreasedincrementallyoverthelastthreebars:

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Text_New(Date,Time,High,"UpT");

Text_New_BN

Displaysatextobjectconsistingofthespecifiedstringexpressionlocatedatthespecifiedbarandspecifiedpricevalueonthechartthatthestudyisbasedon;returnsanobject-specificIDnumberrequiredtomodifytheobject.

Text_New_BN(BarNumber,PriceValue,"Text")

Parameters

BarNumber-Numericalexpressionspecifyingnumberofthebar(horizontalposition).

Text-thestringexpressiontobedisplayed.

Example

Onthechartthatthestudyisbasedonplacethetext"UpT"atthetopofthebariftheOpenpricehasincreasedincrementallyoverthelastthreebars:

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Text_New_BN(currentbar,High,"UpT");

Text_New_Dt

Text_New_Dt(Bar_DateTime,PriceValue,"Text")

Parameters

Bar_DateTime-Numericalexpressionspecifyingdateandtimeofthebar(horizontalposition).TheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.DateTimeisafloatingpointvaluewithhighprecision.Itallowsaccessingmillisecondtimestampsofthebar.

Example

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Text_New_Dt(DateTime,High,"UpT");

Text_New_s

Text_New_s(BarDate,BarTime_s,PriceValue,"Text")

Parameters

Example

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Text_New_s(Date,Time_s,High,"UpT");

Text_New_self

Displaysatextobject,consistingofthespecifiedstringexpressionlocatedatthespecifiedbarandspecifiedpricevalue,ontheSubChartcontainingthestudy;returnsanobject-specificIDnumber,requiredtomodifytheobject.

Text_New_self(BarDate,BarTime,PriceValue,"Text")

Parameters

Example

Place,ontheSubChartcontainingthestudy,thetext"UpT"atthepointsoftheplotwheretheOpenpricehasincreasedincrementallyoverthelastthreebars:

Plot1(Close);IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Text_New_self(Date,Time,High,"UpT");

Text_New_Self_BNThesameasText_New_BN.Difference:DisplaysatextontheSubChartcontainingthestudy.

Text_New_Self_DT

Text_New_Self_DT(Bar_DateTime,PriceValue,"Text")

Parameters

Bar_DateTime-Numericalexpressionspecifyingdateandtimeofthebar(horizontalposition).TheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.DateTimeisafloatingpointvaluewithhighprecision.Itallowsaccessingmillisecondtimestampsofthebar.

Example

IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Text_New_Self_DT(DateTime,High,"UpT");

Text_New_self_s

Text_New_self_s(BarDate,BarTime_s,PriceValue,"Text")

Parameters

Example

Place,ontheSubChartcontainingthestudy,thetext"UpT"atthepointsoftheplotwheretheOpenpricehasincreasedincrementallyoverthelastthreebars:

Plot1(Close);IfOpen>Open[1]AndOpen[1]>Open[2]ThenValue1=Text_New_self_s(Date,Time_s,High,"UpT");

Text_SetAttribute

SetsanattributeofthetextinatextobjectwiththespecifiedIDnumber;returnsavalueof0iftheattributewassuccessfullyset,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Thefollowingtextattributescanbeset:border,bold,italic,strike-out,andunderline.

Text_SetAttribute(ObjectID,Attribute,LogicalExpression)

Parameters

LogicalExpression-alogicalvalue;True=onandFalse=off

Example

Settheattribute"bold"toonforthetextinatextobjectwiththeIDnumberof3:

Value1=Text_SetAttribute(3,1,True);

Text_SetBarNumber

AssignsthespecifiedbarnumbertothetextobjectwiththespecifiedIDnumber;returnsavalueof0ifthebarnumberwassuccessfullyassigned,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_SetBarNumber(ref,Barnumber)

Parameters:

ref-IDnumberofthetextobject;Barnumber-thenewbarnumberthatistobeassignedtothespecifiedobject.

Example

Assignthenewbarnumbervalueof100tothetextobjectwithID=1:

Text_SetBarNumber(1,100);

Text_SetBGColor

AssignsthespecifiedbackgroundcolortoatextobjectwiththespecifiedIDnumber;returnsavalueof0ifthecolorwassuccessfullyassigned,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_SetBGColor(ObjectID,BGColor)

Parameters

BGColor-anexpressionspecifyingthebackgroundcolor

Example

AssignthecolorbluetothebackgroundofatextobjectwiththeIDnumberof3:

Value1=Text_SetBGColor(3,Blue);

AssigntheRGBcolor2138336(Orange)tothebackgroundofatextobjectwiththeIDnumberof3:

Value1=Text_SetBGColor(3,2138336);

Assignthelegacycolor4(Green)tothebackgroundofatextobjectwiththeID

numberof3:

[LegacyColorValue=True];Value1=Text_SetBGColor(3,4);

Text_SetBorder

AddsorremovesaborderaroundthetextobjectwiththespecifiedIDnumber;returnsavalueof0iftheborderwassuccessfullyset,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Thecoloroftheborderisthesameasthecolorofthetextinthetextobject.

Text_SetBorder(ObjectID,LogicalExpression)

Where:ObjectID-anumericalexpressionspecifyingtheobjectIDnumberLogicalExpression-alogicalvalue;True=AddandFalse=Remove

Example

AddabordertothetextobjectwithanIDnumberof3:

Value1=Text_SetBorder(3,True);

RemoveaborderfromthetextobjectwithanIDnumberof3:

Value1=Text_SetBorder(3,False);

Text_SetColor

AssignsthespecifiedcolortothetextofatextobjectwiththespecifiedIDnumber;returnsavalueof0ifthecolorwassuccessfullyassigned,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_SetColor(ObjectID,TextColor)

Parameters

TextColor-anexpressionspecifyingthetextcolor

Example

AssignthecolorbluetothetextofatextobjectwiththeIDnumberof3:

Value1=Text_SetColor(3,Blue);

AssigntheRGBcolor2138336(Orange)tothetextofatextobjectwiththeIDnumberof3:

Value1=Text_SetColor(3,2138336);

Assignthelegacycolor4(Green)tothetextofatextobjectwiththeIDnumberof

[LegacyColorValue=True];Value1=Text_SetColor(3,4);

Text_SetFontName

AssignsthespecifiedfonttoatextobjectwiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

AnyfontintheFontsfoldercanbeused;thefolderisaccessiblefromtheControlPanelinWindowsXPoperatingsystem.

Text_SetFontName(ObjectID,"FontName")

Where:ObjectID-anumericalexpressionspecifyingtheobjectIDnumberFontName-astringexpressionspecifyingthefontname

Example

AssignfontVerdanatothetextobjectwiththeIDnumberof3:

Value1=Text_SetFontName(3,"Verdana");

Text_SetLocation

ModifiesthelocationofatextobjectwiththespecifiedIDnumber;returnsavalueof0ifthelocationoftheobjectwassuccessfullymodified,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_SetLocation(ObjectID,BarDate,BarTime,PriceValue)

Parameters

Example

MovethetextobjectwithanIDnumberof3tothetopofthecurrentbar:

Value1=Text_SetLocation(3,Date,Time,High);

Text_SetLocation_BN

ModifieslocationofatextobjectwiththespecifiedIDnumber;returnsavalueof0iflocationoftheobjectwassuccessfullymodified,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_SetLocation_BN(ObjectID,BarNumber,PriceValue)

Parameters

Example

Value1=Text_SetLocation_BN(3,currentbar,High);

Text_SetLocation_DT

Text_SetLocation_DT(ObjectID,Bar_DateTime,PriceValue)

Parameters

Bar_DateTime-anumericalexpressionspecifyingthedateandtimeofthebaratwhichtheobjectistobeplaced;thedateisindicatedintheDateTimeformat,wheretheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.DateTimeisafloatingpointvaluewithhighprecision.Itallowsaccessingmillisecondtimestampsofthebar.

Example

Value1=Text_SetLocation_DT(3,DateTime,High);

Text_SetLocation_s

Text_SetLocation_s(ObjectID,BarDate,BarTime_s,PriceValue)

Parameters

Anobject-specificIDnumberisreturnedbyText_New_swhenthetextobjectiscreated.

Example

Value1=Text_SetLocation_s(3,Date,Time_s,High);

Text_SetSize

AssignsthespecifiedfontsizetothetextofatextobjectwiththespecifiedIDnumber;returnsavalueof0ifthefontsizewassuccessfullyassigned,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_SetSize(ObjectID,FontSize)

Where:ObjectID-anumericalexpressionspecifyingtheobjectIDnumberFontSize-anumericalexpressionspecifyingthefontsize

Example

Assignthefontsizeof16tothetextofatextobjectwiththeIDnumberof3:

Value1=Text_SetSize(3,16);

Text_SetString

ReplaceswiththespecifiedstringexpressionthetextcontainedinatextobjectwiththespecifiedIDnumber;returnsavalueof0ifthestringexpressionwassuccessfullyreplaced,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_SetString(ObjectID,"Text")

Where:ObjectID-anumericalexpressionspecifyingtheobjectIDnumberText-thenewstringexpressiontobedisplayedinthetextobject

Example

Replacethetext,containedinatextobjectwiththeIDnumberof3,withthestringexpression"NewText":

Value1=Text_SetString(3,"NewText");

Text_SetStyle

Setstheplacementstyleofatextobjectrelativetothebarandtothepricevaluespecifiedfortheobject;returnsavalueof0iftheplacementstyleoftheobjectwassuccessfullymodified,andavalueof-2ifthespecifiedobjectIDnumberisinvalid.

Text_SetStyle(ObjectID,HorizPl,VertPl)

Parameters

HorizPl-anumericalexpressionspecifyingthehorizontalplacementstyleforthetextobject:

0-totherightofthespecifiedbar1-totheleftofthespecifiedbar2-centeredonthespecifiedbar

VertPl-anumericalexpressionspecifyingtheverticalplacementstyleforthetextobject:

0-belowthespecifiedpricevalue1-abovethespecifiedpricevalue2-centeredonthespecifiedpricevalue

Pricevaluerepresentstheverticalpositioncorrespondingtoavalueonthepricescaleofachart.

Example

CenterthetextobjectwithanIDnumberof3onthebarandonthepricevalue,specifiedfortheobject:

Value1=Text_SetStyle(3,2,2);

DoubleQuote

Displaysthedouble-quote(")characterinastring.

Example

ThisexampledemonstrateshowthewordHelloindoublequotescanbedisplayedonthelastbaraboveHigh:

Variable:ID(-1);IfLastBarOnChartThenID=Text_New(Date,Time,High+1Point,DoubleQuote+"Hello"+DoubleQuote);

Returnsthepositionofaspecifiedstringexpressioninsideanotherspecifiedstringexpression.

Thepositionofthestringbeinglocatedisindicatedbythenumberofcharactersfromtheleftsideofthestringbeingevaluated.

InStr(String1,String2)

Where:String1-astringtobeevaluatedString2-astringtobelocated

Incasethesearchreturnsnoresults0isreturned

Incaseifthesoughtwordoccursmorethanonce,thefirstpositionwillbereturned

Searchiscasesensetive

Example

InStr("Fridayistheexpirationday","Friday");

willreturnavalueof1,indicatingthatthestring"Friday"beginsatposition1oftheString"Fridayistheexpirationday"

InStr("Fridayistheexpirationday","Monday");

willreturnavalueof0,indicatingthatthestring"Monday"doesnotexistintheString"Fridayistheexpirationday"

LeftStr

Returnsoneormoreleftmostcharactersfromthespecifiedstringexpression.

LeftStr(String,sSize)

Where:String-astringexpressionfromwhichthecharactersaretobetakensSize-anumericalexpressionspecifyingthenumberofcharacterstobereturned

Example

LeftStr("HelloWorld",5);willreturnastringexpression"Hello"

LowerStr

Convertstheuppercaselettersofaspecifiedstringexpressiontoalowercase.

LowerStr("String")

Where:String-astringexpressiontobeconverted

Example

LowerStr("ReturnonAccount");willreturnastringexpression"returnonaccount"

MidStr

Returnsapart,startingfromaspecifiedpositionandofaspecifiedlength,ofaspecifiedstringexpression.

MidStr("String",Pos,Num)

Where:String-astringexpressionthespecifiedpartistobetakenfromPos-anumericalexpressionspecifyingtheposition,fromtheleftsideofthestring,ofthestartingcharacterofthepartNum-anumericalexpressionspecifyingthelength,incharacters,ofthepart

Example

MidStr("Largestwinningtrade",1,7);willreturnastringexpression"Largest"

NewLine

Startsanewlineandreturnscarriage.

Usethe"+"charactertoaddNewLinetoastringexpression.

Example

FileAppend("c:\testfile.txt","Wecanseeanewbarfor"+NumToStr(Date,0)+NewLine);

NumToStr

Returnsaspecifiednumericalexpressionintheformofastringexpression.

NumToStr(Expression,Dec)

Where:Expression-anumericalexpressiontobeconvertedtoastringexpressionDec-anumericalexpressionspecifyingthenumberofdecimalplacesthereturnedstringexpressionistocontain

Example

NumToStr(1500.5,3);willreturnastringexpression"1500.500"

RightStr

Returnsoneormorerightmostcharactersfromthespecifiedstringexpression.

RightStr(String,sSize)

Where:String-astringexpressionfromwhichthecharactersaretobetakensSize-anumericalexpressionspecifyingthenumberofcharacterstobereturned

Example

RightStr("HelloWorld",5);willreturnastringexpression"World"

Spaces

Returnsastringexpressionconsistingofaspecifiednumberofspaces.

Spaces(Num)

Where:Num-anumericalexpressionspecifyingthenumberofspaces

Example

Theexampleinsertstwoblankspacesbetweentheletters"a"and"b":

Print("a"+Spaces(2)+"b");

StrLen

Returnsthelength,incharacters,ofaspecifiedstringexpression.

StrLen("String")

Where:String-astringexpressiontobeevaluated

Example

StrLen("Drawdown");willreturnavalueof8

StrToNum

Convertsaspecifiedstringexpressiontoanumericalvalue.

StrToNum("String")

Ifnon-numericcharactersareencounteredtherestoftheexpressionisignored.

Example

StrToNum("2500.70");willreturnavalueof2500.70

Returnsthestring,formedupbythetransferredarguments.

Text(Param1,Param2,...,ParamN);

Where:Param(i)isstringexpression,numericexpressionorTrue/Falsevalue.

Example

Text_new(D,T,C,Text("BarDate/Timeis",Date:0:0,"/",Time:0:0));

UpperStr

Convertsthelowercaselettersofaspecifiedstringexpressiontouppercase.

UpperStr("String")

Example

UpperStr("msft");willreturnastringexpression"MSFT"

MC_TL_GetActiveReturnsanumericalvalueindicatingthetrendlineIDnumberofthecurrentlyselectedtrendline;returnsavalueof-1ifnotrendlinesarecurrentlyselected.

MC_TL_GetActive

Atrendline-specificIDnumberisassignedbyMC_TL_Newwhenthetrendlineiscreated.

Example

Assignavalue,indicatingthetrendlineIDnumberofthecurrentlyselectedtrendline,toValue1variable:

Value1=MC_TL_GetActive;

MC_TL_NewThesameasTL_New.

MC_TL_New_BNThesameasTL_New_BN.

MC_TL_New_DTThesameasTL_New_DT.

MC_TL_New_SelfThesameasTL_New_Self.

MC_TL_New_Self_BNThesameasTL_New_Self_BN.

MC_TL_New_Self_DTThesameasTL_New_Self_DT.

TL_Anchor_to_Bars

Anchorsthecorrespondingtrendlinedrawingtothevisiblebarindex;returnsavalueof0iftheoperationwasperformedsuccessfully,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_Anchor_to_Bars(TL_ID,LogicalExpression)

Where:TL_IDisanumericalexpressionspecifyingthetrendlineIDnumberLogicalExpressionisalogicalvalue;True=AddoptionandFalse=Removeoption

Atrendline-specificIDnumberisreturnedbyTL_Newwhenthetrendlineiscreated.

Example

AnchorthetrendlinewithanIDnumberof3tothevisiblebarindex:

Value1=TL_Anchor_to_Bars(3,True);

TL_Delete

RemovesatrendlinewiththespecifiedIDnumberfromachart;returnsavalueof0ifthetrendlinewassuccessfullyremoved,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_Delete(TL_ID)

Where:TL_ID-anumericalexpressionspecifyingthetrendlineIDnumber

Example

RemovethetrendlinewithanIDnumberof3:

Value1=TL_Delete(3);

TL_GetActive

ThisreservedwordreturnsanumericvaluerepresentingtheIDofthecurrentlyactivetrendline.

TL_GetActive

Whenthereservedwordperformsitsoperationsuccessfully,trendlineIDisreturned.

Whenareservedwordcannotperformitsoperation,itreturnsanerrorcode.

Example

Value1=TL_GetActive;

AssignstheIDofthecurrentlyactivetrendlinetoValue1.

Value1isanynumericvariableorarray.

Trendlinereservedwordshouldbeassignedtoanumericvariableorarrayinordertodeterminewhetherthereservedwordperformeditsoperationsuccessfullyornot.

TL_GetAlert

ReturnsthealertstatusforatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetAlert(TL_ID)

Return

Alertstatus:

0-Alertdisabled

1-Breakoutintra-bar

AnalertistriggerediftheHighcrossesoverthetrendlineortheLowcrossesunderthetrendline.Alerttriggeringconditionsareevaluatedintra-bar.

2-Breakoutonclose

AnalertistriggerediftheCloseofthepreviousbarwasbelowthetrendlineandtheCloseofthecurrentbarisabovethetrendline,oriftheCloseofthepreviousbarwasabovethetrendlineandtheCloseofthecurrentbarisbelowthetrendline.AlerttriggeringconditionsareevaluatedatCloseofabar.

Example

Assignavalue,indicatingthealertstatusforatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetAlert(3);

TL_GetBeginDate

Returnsanumericalvalue,indicatingthedateofthestartingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

Ofthetwoendpointsofatrendline,thepointwiththeearlierdateandtimeisalwaysconsideredtobethestartingpoint;ifthetrendlineisvertical,thepointwiththelowerpricevalueisconsideredtobethestartingpoint.

TL_GetBeginDate(TL_ID)

Example

Assignavalue,indicatingthedateofthestartingpointofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetBeginDate(3);

TL_GetBeginTime

Returnsanumericalvalue,indicatingthetimeofthestartingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetBeginTime(TL_ID)

Example

Assignavalue,indicatingthetimeofthestartingpointofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetBeginTime(3);

TL_GetBeginTime_s

Returnsanumericalvalueindicatingthetime,includingseconds,ofthestartingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetBeginTime_s(TL_ID)

Atrendline-specificIDnumberisreturnedbyTL_New_swhenthetrendlineiscreated.

Example

Assignavalue,indicatingthetimeofthestartingpointofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetBeginTime_s(3);

TL_GetBeginVal

Returnsthepricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart)ofthestartingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetBeginVal(TL_ID)

Example

Assignavalue,indicatingthepricevalueofthestartingpointofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetBeginVal(3);

TL_GetBegin_BN

ReturnsabarnumbervalueofthestartingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetBegin_BN(TL_ID)

Example

TL_GetBegin_BN(value1);willreturn5ifTrendLinewithID=Value1startsonfifthbarofpriceseries.

TL_GetBegin_Dt

ReturnsaDateTimevalue,indicatingthedateandtimeofthestartingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetBegin_Dt(TL_ID)

Atrendline-specificIDnumberisreturnedbyTL_New_Dtwhenthetrendlineiscreated.

Example

TL_GetBegin_Dt(value1);willreturn41422.752623935186ifTrendLinewithID=Value1startsat08:30:00.722on5/28/2013

TL_GetColor

ReturnsanRGBcolornumberoralegacycolorvaluethatcorrespondtothecolorofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetColor(TL_ID)

Example

AssignanRGBcolornumber,correspondingtothecolorofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetColor(3);

Assignalegacycolorvalue,correspondingtothecolorofatrendlinewiththeIDnumberof3,toValue1variable:

[LegacyColorValue=True];Value1=TL_GetColor(3);

TL_GetEndDate

Returnsanumericalvalue,indicatingthedateoftheendingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

Ofthetwoendpointsofatrendline,thepointwiththelaterdateandtimeisalwaysconsideredtobetheendingpoint;ifthetrendlineisvertical,thepointwiththehigherpricevalueisconsideredtobetheendingpoint.

TL_GetEndDate(TL_ID)

Example

Assignavalue,indicatingthedateoftheendingpointofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetEndDate(3);

TL_GetEndTime

Returnsanumericalvalue,indicatingthetimeoftheendingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetEndTime(TL_ID)

Example

Assignavalue,indicatingthetimeoftheendingpointofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetEndTime(3);

TL_GetEndTime_s

Returnsanumericalvalueindicatingthetime,includingseconds,oftheendingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetEndTime_s(TL_ID)

Example

Assignavalue,indicatingthetimeoftheendingpointofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetEndTime_s(3);

TL_GetEndVal

Returnsthepricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart)oftheendingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetEndVal(TL_ID)

Example

Assignavalue,indicatingthepricevalueoftheendingpointofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetEndVal(3);

TL_GetEnd_BN

ReturnsabarnumbervalueoftheendingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetEnd_BN(TL_ID)

Where:TL_ID-numericalexpressionspecifyingthetrendlineIDnumber

Example

TL_GetEnd_BN(value1);willreturn8ifTrendLinewithID=Value1endsoneighthbarofpriceseries.

TL_GetEnd_Dt

ReturnsaDateTimevalue,indicatingthedateandtimeoftheendingpointofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetEnd_Dt(TL_ID)

Where:TL_ID-numericalexpressionspecifyingthetrendlineIDnumber

Example

TL_GetEnd_Dt(value1);willreturn41422.752623935186ifTrendLinewithID=Value1endsat08:30:00.722on5/28/2013

TL_GetExtLeft

Returnsalogicalvalue,indicatingwhetherthetrendlinewiththespecifiedIDnumberisextendedtotheleft;returnsavalueofTrueifthetrendlineisextended,andavalueofFalseifthetrendlineisnotextendedorifthespecifiedtrendlineIDnumberisinvalid.

TL_GetExtLeft(TL_ID)

Example

Assignatrue/falsevalue,indicatingwhetherthetrendlinewithanIDnumberof3isextendedtotheleft,toExtLvariable:

Variable:ExtL(False);ExtL=TL_GetExtLeft(3);

TL_GetExtRight

Returnsalogicalvalue,indicatingwhetherthetrendlinewiththespecifiedIDnumberisextendedtotheright;returnsavalueofTrueifthetrendlineisextended,andavalueofFalseifthetrendlineisnotextendedorifthespecifiedtrendlineIDnumberisinvalid.

TL_GetExtRight(TL_ID)

Example

Assignatrue/falsevalue,indicatingwhetherthetrendlinewithanIDnumberof3isextendedtotheright,toExtRvariable:

Variable:ExtR(False);ExtR=TL_GetExtRight(3);

TL_GetFirst

Returnsanumericalvalue,indicatingthetrendlineIDnumberoftheoldest(thefirsttobedrawnonthecurrentchart)trendlineofthespecifiedorigin;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetFirst(Origin)

Parameters

Origin-anumericalexpressionspecifyingtheoriginofthetrendline:

1-drawnbythecurrentstudy2-drawnbyastudyotherthenthecurrentstudy,ordrawnmanuallybytheuser3-drawnbyanystudy,ordrawnmanuallybytheuser4-drawnbythecurrentstudy,ordrawnmanuallybytheuser5-drawnbyastudyotherthenthecurrentstudy6-drawnbyanystudy7-drawnmanuallybytheuser

Iftheoldest(thefirsttobedrawn)trendlineisdeleted,thenextoldest(thesecondtobedrawn)trendlinebecomestheoldest(thefirstdrawn)trendline.

Example

Assignavalue,indicatingthetrendlineIDnumberoftheoldesttrendlinedrawnonthechartbythecurrentstudy,toValue1variable:

Value1=TL_GetFirst(1);

TL_GetLock

Lockedtrendlinedrawingscannotbemovedmanually.KeywordreturnsavalueofTrueforlockeddrawings,andavalueofFalseforunlocked.

TL_GetLock(TL_ID)

Example

AssignLockpropertyofthetrendlinedrawingwithanIDnumberof3toCondition1variable:

Condition1=TL_GetLock(3);

TL_GetNext

ReturnsanIDnumberofthefirstexistingtrendlinedrawnsubsequenttoatrendlinewiththespecifiedIDnumber,withbothtrendlinesofaspecifiedorigin;returnsavalueof-2ifthespecifiedobjectIDnumberisinvalid.

TL_GetNext(TL_ID,Origin)

Parameters

TL_ID-anumericalexpressionspecifyingthetrendlineIDnumber

Origin-anumericalexpressionspecifyingtheoriginofthetrendlines:

1-drawnbythecurrentstudy2-drawnbyastudyotherthenthecurrentstudy,ordrawnmanuallybytheuser3-drawnbyanystudy,ordrawnmanuallybytheuser4-drawnbythecurrentstudy,ordrawnmanuallybytheuser5-drawnbyastudyotherthenthecurrentstudy6-drawnbyanystudy7-drawnmanuallybytheuser

Example

AssignavaluetoValue1variable,indicatingtheIDnumberofthefirstexistingtrendlinedrawnsubsequenttoatrendlinewiththeIDnumberof3,withbothtrendlinesdrawnbythecurrentstudy:

Value1=TL_GetNext(3,1);

TL_GetSize

ReturnsanumericalvalueindicatingthewidthofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetSize(TL_ID)

Example

Assignavalue,indicatingthewidthofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetSize(3);

TL_GetStyle

Returnsanumericalvalue,indicatingthestyleofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_GetStyle(TL_ID)

Return

Trendlinestyles:

1 ToolSolid ______________________2 ToolDashed -------------------3 ToolDotted ............................................4 ToolDashed2 _________________5 ToolDashed3 __________________

Example

Assignavalue,indicatingthestyleofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetStyle(3);

TL_GetValue

Returnsapricevalue,atthespecifieddateandtime,ofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

Ifthetrendlinedoesnotextendtothespecifieddateandtime,apricevaluealongthesameslopeasthetrendlinewillbereturned.

TL_GetValue(TL_ID,Date,Time)

Parameters

Date-anumericalexpressionspecifyingthedate;thedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth

Time-anumericalexpressionspecifyingthetime;thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM

Example

Assignthepricevalue,at10:00AMonJanuary17th,ofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetValue(3,1080117,1000);

TL_GetValue_BN

Returnsapricevalue,atthespecifiedbarnumber,ofatrendlinewiththespecifiedIDnumber;returnsavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

Ifthetrendlinedoesnotextendtothespecifiedbar,apricevaluealongthesameslopeasthetrendlinewillbereturned.

TL_GetValue_BN(TL_ID,Barnumber)

Parameters

TL_ID-anumericalexpressionspecifyingthetrendlineIDnumber;

Barnumber-anumericalexpressionspecifyinganumberofabar;

Example

Assignthepricevalueatbarnumber100ofatrendlinewiththeIDnumberof3toValue1variable:

Value1=TL_GetValue_BN(3,100);

TL_GetValue_Dt

TL_GetValue_Dt(TL_ID,DT)

Parameters

TL_ID-anumericalexpressionspecifyingthetrendlineIDnumber.

DT-anumericalexpressionspecifyingthetrendlinestartingpointdateandtime;indicatedintheDateTimeformat.TheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.

Example

TL_GetValue_Dt(value1,41422.752623935186);willreturnthepriceoftrendlinewithID=Value1at08:30:00.882of5/28/2013

TL_GetValue_s

TL_GetValue_s(TL_ID,Date,Time_s)

Parameters

Date-anumericalexpressionspecifyingthedate;thedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth

Time_s-anumericalexpressionspecifyingthetime,includingseconds;thetimeisindicatedinthe24-hourHHmmssformat,where130000=1:00:00PM

Example

Assignthepricevalue,at10:00:00AMonJanuary17th,ofatrendlinewiththeIDnumberof3,toValue1variable:

Value1=TL_GetValue_s(3,1080117,100000);

TL_Get_Anchor_to_Bars

Returnsthevalueofthe"anchortobar"optionofthetrendlinedrawingwithaspecifiedID.

TL_Get_Anchor_to_Bars(TL_ID)

Where:TL_IDisanumericalexpressionspecifyingthetrendlineIDnumber

Example

Assignthe"anchortobars"optionofthetrendlinedrawingwithanIDnumberof3totheCondition1variable:

Condition1=TL_Get_Anchor_to_Bars(3);

TL_Lock

Lockscorrespondingtrendlinedrawingsoitcannotbemovedmanually;returnsavalueof0iftheoperationwasperformedsuccessfully,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_Lock(TL_ID,LogicalExpression)

Where:TL_ID-anumericalexpressionspecifyingthetrendlineIDnumberLogicalExpression-alogicalvalue;True=AddandFalse=Remove

Example

LockthetrendlinewithanIDnumberof3:

Value1=TL_Lock(3,True);

UnlockthetrendlinewithanIDnumberof5:

Value1=TL_Lock(5,False);

TL_New

Displaysatrendline,withthespecifiedstartingandendingpoints,onthechartthatthestudyisbasedon;returnsatrendline-specificIDnumber,requiredtomodifythetrendline.

TL_New(sDate,sTime,sPriceValue,eDate,eTime,ePriceValue)

Parameters

sDate-anumericalexpressionspecifyingthetrendlinestartingpointdate;thedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth

sTime-anumericalexpressionspecifyingthetrendlinestartingpointtime;thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM

sPriceValue-anumericalexpressionspecifyingthetrendlinestartingpointpricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart)

eDate-anumericalexpressionspecifyingthetrendlineendingpointdate

eTime-anumericalexpressionspecifyingthetrendlineendingpointtime

ePriceValue-anumericalexpressionspecifyingthetrendlineendingpointpricevalue

Example

Displayatrendline,thatbeginsat9:00AMatapricevalueof1381,andendsat3:00PMatapricevalueof1337,onJanuary17th,2008,onthechartthatthestudyisbasedon:

Value1=TL_New(1080117,900,1381,1080117,1500,1337);

TL_New_BN

Displaysatrendlinewiththespecifiedstartingandendingpointsonthechartthatthestudyisbasedon;returnsatrendline-specificIDnumberrequiredtomodifythetrendline.

InsteadofseparateDateandTimevaluesorasingleDateTimevalue,barnumberofpriceseriesisused.

TL_New_BN(b_BarNumber,b_Price,e_BarNumber,e_Price);

Parameters

b_BarNumber-anumericalexpressionspecifyingthetrendlinestartingpointbarnumber.

b_Price-anumericalexpressionspecifyingthetrendlinestartingpointpricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart).

e_BarNumber-anumericalexpressionspecifyingthetrendlineendingpointbarnumber.

e_Price-anumericalexpressionspecifyingthetrendlineendingpointpricevalue.

Example

Displayatrendlinethatwillconnectclosepriceofthefirstbarofpriceserieswiththecurrentcloseprice.

onceValue2=close;

Value1=TL_New_BN(1,Value2,currentbar,Close);

ifValue1<>Value1[1]thentl_delete(Value1[1]);

TL_New_Dt

InsteadofseparateDateandTimevalues,asingleDateTimevalueisused.Itallowsaccessingmillisecondtimestampsofthebar.

TL_New_Dt(b_DateTime,b_Price,e_DateTime,e_Price);

Parameters

b_DateTime-anumericalexpressionspecifyingthetrendlinestartingpointdateandtime;isindicatedintheDateTimeformat.TheintegerportionoftheDateTimevalueindicatesthenumberofdaysthathaveelapsedsinceJanuary1st,1900,andthefractionalportionoftheDateTimevalueindicatesthefractionofthedaythathaspassedsincemidnight.

b_Price-anumericalexpressionspecifyingthetrendlinestartingpointpricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart)

e_DateTime-anumericalexpressionspecifyingthetrendlineendingpointtime;thedateisindicatedintheDateTimeformat.

e_Price-anumericalexpressionspecifyingthetrendlineendingpointpricevalue

Example

Displayatrenlinethatwillconnectacloseprice100barsbackwiththecurrentcloseprice.

Value1=TL_New_Dt(DateTime[100],Close[100],DateTime,Close);

TL_New_s

TL_New_s(sDate,sTime_s,sPriceValue,eDate,eTime_s,ePriceValue)

Parameters

sTime_s-anumericalexpressionspecifyingthetrendlinestartingpointtime,includingseconds;thetimeisindicatedinthe24-hourHHmmssformat,where130000=1:00:00PM

eTime_s-anumericalexpressionspecifyingthetrendlineendingpointtime,includingseconds

Example

Displayatrendline,thatbeginsat9:00:00AMatapricevalueof1381,andendsat3:00:00PMatapricevalueof1337,onJanuary17th,2008,onthechartthatthestudyisbasedon:

Value1=TL_New_s(1080117,90000,1381,1080117,150000,1337);

TL_New_self

Displaysatrendline,withthespecifiedstartingandendingpoints,ontheSubChartcontainingthestudy;returnsatrendline-specificIDnumber,requiredtomodifythetrendline.

TL_New_self(sDate,sTime,sPriceValue,eDate,eTime,ePriceValue)

Parameters

sTime-anumericalexpressionspecifyingthetrendlinestartingpointtime;thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM

eTime-anumericalexpressionspecifyingthetrendlineendingpointtime

Example

Displayatrendline,thatbeginsat9:00AMatapricevalueof1381,andendsat3:00PMatapricevalueof1337,onJanuary17th,2008,ontheSubChartcontainingthestudy:

Value1=TL_New_self(1080117,900,1381,1080117,1500,1337);

TL_New_Self_BNThesameasTL_New_BN.Difference:DisplaysatrendlineontheSubChartcontainingthestudy.

TL_New_Self_Dt

TL_New_Self_Dt(b_DateTime,b_Price,e_DateTime,e_Price);

Parameters

e_DateTime-anumericalexpressionspecifyingthetrendlineendingpointtime;thedateisindicatedintheDateTimeformat.

e_Price-anumericalexpressionspecifyingthetrendlineendingpointpricevalue

Example

Displayatrenlinethatwillconnectacloseprice100barsbackwiththecurrentclosepriceontheSubChartcontainingthestudy.

Value1=TL_New_Self_Dt(DateTime[100],Close[100],DateTime,Close);

TL_New_Self_s

TL_New_s(sDate,sTime_s,sPriceValue,eDate,eTime_s,ePriceValue)

Parameters

sTime_s-anumericalexpressionspecifyingthetrendlinestartingpointtime,includingseconds;thetimeisindicatedinthe24-hourHHmmssformat,where130000=1:00:00PM

eTime_s-anumericalexpressionspecifyingthetrendlineendingpointtime,includingseconds

Example

Displayatrendline,thatbeginsat9:00:00AMatapricevalueof1381,andendsat3:00:00PMatapricevalueof1337,onJanuary17th,2008,ontheSubChartcontainingthestudy:

Value1=TL_New_s(1080117,90000,1381,1080117,150000,1337);

TL_SetAlert

SetsthealertstatusforatrendlinewiththespecifiedIDnumber;returnsavalueof0ifalertstatuswassuccessfullymodified,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_SetAlert(TL_ID,AlertStatus)

Parameters

AlertStatus-anumericalexpressionspecifyingthealertstatusforthetrendline:

0-Alertdisabled

1-Breakoutintra-bar

AnalertistriggerediftheHighcrossesoverthetrendlineortheLowcrossesunderthetrendline.Alerttriggeringconditionsareevaluatedintra-bar.

2-Breakoutonclose

AnalertistriggerediftheCloseofthepreviousbarwasbelowthetrendlineandtheCloseofthecurrentbarisabovethetrendline,oriftheCloseofthepreviousbarwasabovethetrendlineandtheCloseofthecurrentbarisbelowthetrendline.AlerttriggeringconditionsareevaluatedatCloseofabar.

Example

Setalertstatusto"Breakoutonclose"foratrendlinewiththeIDnumberof3:

Value1=TL_SetAlert(3,2);

TL_SetBegin

ModifiesthestartingpointlocationofatrendlinewiththespecifiedIDnumber;returnsavalueof0ifthestartingpointlocationwassuccessfullymodified,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_SetBegin(TL_ID,sDate,sTime,sPriceValue)

Parameters

sDate-anumericalexpressionspecifyingthenewstartingpointdate;thedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth

sTime-anumericalexpressionspecifyingthenewstartingpointtime;thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM

sPriceValue-anumericalexpressionspecifyingthenewstartingpointpricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart)

Example

MovethestartingpointofthetrendlinewithanIDnumberof3to10:00AMonJanuary17thatapricevalueof1365:

Value1=TL_SetBegin(3,1080117,1000,1365);

TL_SetBegin_BN

Betweenthetwoendpointsofatrendline,thepointwiththeearlierdateandtimeisalwaysconsideredtobethestartingpoint;ifthetrendlineisvertical,thepointwiththelowerpricevalueisconsideredtobethestartingpoint.

InsteadofseparateDateandTimevaluesorasingleDateTimevalue,barnumberisused.

TL_SetBegin_BN(TL_ID,BarNumber,Price);

Parameters

BarNumber-anumericalexpressionspecifyingthetrendlinestartingpointbarnumber.

Price-anumericalexpressionspecifyingthetrendlinestartingpointpricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart).

Example

SetthebeginningpointofTrendLinewithID=3toclosepriceofcurrentbar

Value1=TL_SetBegin_BN(3,currentbar[100],Close[100]);

TL_SetBegin_DT

TL_SetBegin_DT(TL_ID,b_DateTime,b_Price);

Parameters

Atrendline-specificIDnumberisreturnedbyTL_New_DTwhenthetrendlineiscreated.

Example

SetthebeginningpointofTrendLinewithID=value1toopenprice100barsback

TL_SetBegin_DT(value1,DateTime[100],Open[100]);

TL_SetBegin_s

TL_SetBegin_s(TL_ID,sDate,sTime_s,sPriceValue)

Parameters

sDate-anumericalexpressionspecifyingthenewstartingpointdate;thedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth

sTime_s-anumericalexpressionspecifyingthenewstartingpointtime,includingseconds;thetimeisindicatedinthe24-hourHHmmssformat,where130000=1:00:00PM

sPriceValue-anumericalexpressionspecifyingthenewstartingpointpricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart)

Example

MovethestartingpointofthetrendlinewithanIDnumberof3to10:00:00AMonJanuary17thatapricevalueof1365:

Value1=TL_SetBegin_s(3,1080117,100000,1365);

TL_SetColor

AssignsthespecifiedcolortoatrendlinewiththespecifiedIDnumber;returnsavalueof0ifthecolorwassuccessfullyassigned,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_SetColor(TL_ID,TL_Color)

Parameters

TL_Color-anexpressionspecifyingthetrendlinecolor

TrendlinecolorcanbespecifiedbyanumericalexpressionrepresentinganRGBcolornumberoralegacycolorvalue,orbyoneof17basecolorwords.

Example

AssignthecolorbluetothetrendlinewithanIDnumberof3:

Value1=TL_SetColor(3,Blue);

AssigntheRGBcolor2138336(Orange)tothetrendlinewithanIDnumberof3:

Value1=TL_SetColor(3,2138336);

Assignthelegacycolor4(Green)tothetrendlinewithanIDnumberof3:

[LegacyColorValue=True];Value1=TL_SetColor(3,4);

TL_SetEnd

ModifiestheendingpointlocationofatrendlinewiththespecifiedIDnumber;returnsavalueof0iftheendingpointlocationwassuccessfullymodified,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_SetEnd(TL_ID,eDate,eTime,ePriceValue)

Parameters

eDate-anumericalexpressionspecifyingthenewendingpointdate;thedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth

eTime-anumericalexpressionspecifyingthenewendingpointtime;thetimeisindicatedinthe24-hourHHmmformat,where1300=1:00PM

ePriceValue-anumericalexpressionspecifyingthenewendingpointpricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart)

Example

MovetheendingpointofthetrendlinewithanIDnumberof3to14:15PMonJanuary17thatapricevalueof1350:

Value1=TL_SetEnd(3,1080117,1415,1350);

TL_SetEnd_BN

Betweenthetwoendpointsofatrendline,thepointwiththelaterdateandtimeisalwaysconsideredtobetheendingpoint;ifthetrendlineisvertical,thepointwiththehigherpricevalueisconsideredtobetheendingpoint.

InsteadofseparateDateandTimevaluesorasingleDateTimevalue,barnumberisused.

TL_SetEnd_BN(TL_ID,BarNumber,Price);

Parameters

BarNumber-anumericalexpressionspecifyingthetrendlineendingpointbarnumber.

Price-anumericalexpressionspecifyingthetrendlineendingpointpricevalue.

Example

SettheendingpointofTrendLinewithID=3toclosepriceofthecurrentbar

Value1=TL_SetEnd_BN(3,currentbar,Close);

TL_SetEnd_Dt

TL_SetEnd_Dt(TL_ID,e_DateTime,e_Price);

Parameters

e_DateTime-anumericalexpressionspecifyingthetrendlineendingpointdateandtime;thedateandtimeareindicatedintheDateTimeformat.

e_Price-anumericalexpressionspecifyingthetrendlineendingpointpricevalue.

Example

SettheendingpointofTrendLinewithID=value1toclosepriceofthecurrentbar

TL_SetEnd_Dt(value1,DateTime,Close);

TL_SetEnd_s

TL_SetEnd_s(TL_ID,eDate,eTime_s,ePriceValue)

Parameters

eDate-anumericalexpressionspecifyingthenewendingpointdate;thedateisindicatedintheYYYMMddformat,whereYYYisthenumberofyearssince1900,MMisthemonth,andddisthedayofthemonth

eTime_s-anumericalexpressionspecifyingthenewendingpointtime,includingseconds;thetimeisindicatedinthe24-hourHHmmssformat,where130000=1:00:00PM

ePriceValue-anumericalexpressionspecifyingthenewendingpointpricevalue(verticalposition,correspondingtoavalueonthepricescaleofachart)

Example

MovetheendingpointofthetrendlinewithanIDnumberof3to14:15:00PMonJanuary17thatapricevalueof1350:

Value1=TL_SetEnd_s(3,1080117,141500,1350);

TL_SetExtLeft

Addsorremovesaleft-sideextensionforatrendlinewiththespecifiedIDnumber;returnsavalueof0iftheoperationwasperformedsuccessfully,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_SetExtLeft(TL_ID,LogicalExpression)

Example

Addaleft-sideextensiontothetrendlinewithanIDnumberof3:

Value1=TL_SetExtLeft(3,True);

Removealeft-sideextensionfromthetrendlinewithanIDnumberof3:

Value1=TL_SetExtLeft(3,False);

TL_SetExtRight

Addsorremovesaright-sideextensionforatrendlinewiththespecifiedIDnumber;returnsavalueof0iftheoperationwasperformedsuccessfully,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_SetExtRight(TL_ID,LogicalExpression)

Example

Addaright-sideextensiontothetrendlinewithanIDnumberof3:

Value1=TL_SetExtRight(3,True);

Removearight-sideextensionfromthetrendlinewithanIDnumberof3:

Value1=TL_SetExtRight(3,False);

TL_SetSize

AssignsthespecifiedwidthtoatrendlinewiththespecifiedIDnumber;returnsavalueof0ifthelinewidthwassuccessfullyassigned,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_SetSize(TL_ID,LineWidth)

Where:TL_ID-anumericalexpressionspecifyingthetrendlineIDnumberLineWidth-anumericalexpressionspecifyingthetrendlinewidth;trendlinewidthcanrangefrom0to6

Example

Assignthewidthof5tothetrendlinewithanIDnumberof3:

Value1=TL_SetSize(3,5);

TL_SetStyle

AssignsthespecifiedstyletoatrendlinewiththespecifiedIDnumber;returnsavalueof0ifthetrendlinestylewassuccessfullyassigned,andavalueof-2ifthespecifiedtrendlineIDnumberisinvalid.

TL_SetStyle(TL_ID,TL_Style)

Parameters

TL_Style-aTLstyleconstantoranumericalexpressionspecifyingthetrendlinestyleasfollows:

Tool_Solid 1

______________________

Tool_Dashed 2 -------------------Tool_Dotted 3 ............................................Tool_Dashed2 4 _________________Tool_Dashed3 5 __________________

Example

SetthestyleofthetrendlinewithanIDnumberof3toToolDashed:

Value1=TL_SetStyle(3,2);

Value1=TL_SetStyle(3,Tool_Dashed);

Tool_Dashed

Constant,usedincombinationwithTL_SetStyletodesignatetheToolDashedstyle;canbesubstitutedbyanumericalvalueof2.

TL_SetStyle(TL_ID,Tool_Dashed)

TL_SetStyle(TL_ID,2)

Example

Value1=TL_SetStyle(3,Tool_Dashed);

Tool_Dashed2

Constant,usedincombinationwithTL_SetStyletodesignatetheToolDashed2style;canbesubstitutedbyanumericalvalueof4.

TL_SetStyle(TL_ID,Tool_Dashed2)

Example

SetthestyleofthetrendlinewithanIDnumberof3toToolDashed2:

Value1=TL_SetStyle(3,Tool_Dashed2);

Tool_Dashed3

Constant,usedincombinationwithTL_SetStyletodesignatetheToolDashed3style;canbesubstitutedbyanumericalvalueof5.

TL_SetStyle(TL_ID,Tool_Dashed3)

Example

Value1=TL_SetStyle(3,Tool_Dashed3);

Tool_Dotted

Constant,usedincombinationwithTL_SetStyletodesignatetheToolDottedstyle;canbesubstitutedbyanumericalvalueof3.

TL_SetStyle(TL_ID,Tool_Dotted)

Example

SetthestyleofthetrendlinewithanIDnumberof3toToolDotted:

Value1=TL_SetStyle(3,Tool_Dotted);

Tool_Solid

Constant,usedincombinationwithTL_SetStyletodesignatetheToolSolidstyle;canbesubstitutedbyanumericalvalueof1.

TL_SetStyle(TL_ID,Tool_Solid)

Example

SetthestyleofthetrendlinewithanIDnumberof3toToolSolid:

Value1=TL_SetStyle(3,Tool_Solid);

powerlanguage keyword reference - multicharts · magenta margin market marketposition...

Documents

customerendofseasonsale€¦ · magenta buzz magenta buzz...

magenta mobility brochure english

multicharts .net programming guide

magenta - manual

la guida su multicharts e l'analisi dei volumi by...

1 investware, inc. multicharts for system trading

magenta 2014

the powerlanguage platform © powerlanguage™ ltd key...

cmyk cyan cyan magenta magenta yellow yellow black black

trading alchemy manual for multicharts...instruction manual...

montage bg film 2008 09 - ekos96.com monta…black cyan...

magenta skateboard catalogue 2012

magenta beginning fedora

magenta - gbh 2013

the powerlanguage platform © powerlanguage™ ltd key...

multicharts 5.5 user guide · pdf filegann square ... 9...

magenta 4.0

magenta and magenta production

magenta - july / juillet 2013

magenta 07/2014