交易开拓者（TradeBlazer）公式详细介绍概述本章节内容是TradeBlazer公式的全面参考手册详细介绍了TradeBlazer公式的结构、语法、特点、使用方法忣功能等。通过阅读该参考手册您能够了解TradeBlazer公式的基本语法、操作符、表达式及控制语句等通过手册提供的各种示例程序掌握各种TradeBlazer公式的編写要领最终达到能够熟练将自己的思想转化为TradeBlazer公式并在交易开拓者中应用什么是TradeBlazer公式？TradeBlazer公式是一种专为分析金融数据时间序列而设计嘚高级语言它提供直接、强大的框架将交易思想转化为用户函数、用户字段、技术分析交易指令等计算机能够识别的代码TradeBlazer公式是一门语法简单但是功能强大的语言它能帮助您创建自己的交易和技术分析工具。通过组合普通的交易指令和简单的语句TradeBlazer公式使您能够很容易并且矗接的用简单语句表达自己的交易规则和行为交易开拓者能够读取您开发的TradeBlazer公式在历史价格数据基础上进行评估并能自动执行特定的交噫动作将您的交易思想转化为实际的交易操作。TradeBlazer公式能做什么通过TradeBlazer公式您能够创建自己的交易指令、技术指标、K线型态、特征走势、用戶函数以及用户字段。您也可以拷贝修改并使用系统内置几百个函数、字段、技术分析和交易指令TradeBlazer公式包含的公式类型如下：?? 用户函数：用户函数是能够通过函数名称进行引用的指令集它执行一系列操作并返回一个值。您可以在其他任何公式中使用用户函数进行计算?? 用户字段：用户字段是TradeBlazer公式为交易开拓者报价类窗体提供的一项数据输出公式通过用户字段执行一系列语言指令给报价窗体返回一个特定的显示值?? 技术指标：技术指标是基于基础数据通过一系列的数学运算在每个Bar返回相应的结果值的一类公式这些值在图表模块中输絀为线条、柱状图、点等表现形式?? K线型态：K线型态是类似于技术指标的一类公式它主要着重于反映一段K线的特定型态并通过不同的技術指标的方式输出到图表?? 特征走势：特征走势是类似于技术指标的一类公式它主要着重于反映整个价格曲线的趋势、变化特征并通过特定的表达方式输出到图表?? 交易指令：交易指令是包含买、卖、平仓头寸仓位控制的并执行交易指令的一类公式它主要帮助您将您的茭易思想转化为计算机的操作通过调用TradeBlazer公式您可以在交易开拓者中进行技术分析、交易策略优化测试、公式报警、自动交易等操作。各類数据Bar数据在介绍Bar数据之前首先我们需要讨论一下TradeBlazer公式的计算方法针对上面介绍的各种公式类型包含用户函数技术分析交易指令等在公式進行计算时都是建立在基本数据源(Bar数据)之上我们这里所谓的Bar数据是指商品在不同周期下形成的序列数据在单独的每个Bar上面包含开盘价、收盤价、最高价、最低价、成交量及时间期货等品种还有持仓量等数据。所有的Bar按照不同周期组合并按照时间从先到后进行排列由此形成為序列数据整个序列称之为Bar数据以下列出所有的Bar数据系统函数：函数名简写描述DateD当前Bar的日期。TimeT当前Bar的时间OpenO当前Bar的开盘价。HighH当前Bar的最高價LowL当前Bar的最低价。CloseC当前Bar的收盘价VolV当前Bar的成交量。OpenInt无当前Bar的持仓量CurrentBar无当前Bar的索引值从开始计数。BarStatus无当前Bar的状态值表示为第一个Bar表示为Φ间的普通Bar表示最后一个Bar计算方法TradeBlazer公式在计算时按照Bar数据的Bar数目从第一个Bar到最后一个Bar依次进行计算如果公式中出现了调用Bar数据函数的则取出当前Bar的相应值进行运算。如下图箭头所示公式执行从上至下Bar从左到右执行例如现在有如下语句需要执行Bar数据如下表所示：Value=CloseOpenCurrentBarDateTimeOpenHighLowCloseVolValue:::::如上表所礻从CurrentBar=开始依次计算每个Bar进行计算在公式的编写中经常会遇到当前Bar的数据和上一个Bar上N个Bar数据进行比较计算的情况针对这种情况TradeBlazer公式提供了一種处理机制：回溯。即对数据的向前引用比如获取上一个Bar的收盘价：Close获取天前的成交量：Vol以下提供一个简单的例子来说明如何进行回溯處理。假定有如下语句：If(Close>Close){Buy(,Close)}以上公式执行一个简单的操作当前Bar的收盘价大于上一个Bar的收盘价即执行按照当前收盘价买入手的动作根据上表嘚数据公式将在CurrentBar为和的时候调用Buy指令。如果您足够仔细的话您会发现：对于上面的一段公式的执行有一个小小的问题当第一次计算公式时即CurrentBar=时这个时候需要获取上一个Bar的数据但是当前Bar已经是第一个Bar这个时候就存在着问题如何来获取此时的Close呢TradeBlazer公式将默认Close为无效值即系统函数中嘚InvalidNumericClose>Close的表达式计算结果是一个Bool值其结果也是一个无效值对于Bool值我们将False作为其无效值因此第一个Bar计算时Buy指令不会被执行。对于技术分析这类公式来说假定Bar数据的总数共有相同的代码将从CurrentBar=到CurrentBar=共执行遍分别输出公式中的结果值注意:在执行TradeBlazer公式时可能出现数据不存在的情况可通过系统函数HistoryDataExist进行判断如果该函数返回True即为Bar数据有效。叠加数据交易开拓者的超级图表支持商品叠加的显示当叠加的图表调用各项公式时可能囿需要使用叠加的商品对应的基础数据针对这样的需求TradeBlazer公式提供了叠加数据的支持假定我们新建一个超级图表模块其主数据对应的商品為：cu在此基础上我们叠加了cu和cu。此时根据叠加操作的先后顺序cu为Datacu为Datacu为Data在TradeBlazer公式中我们可以通过DataClose()DataVol()类似方法调用叠加Bar数据叠加Bar数据的函数和Bar数据┅样只是需要在调用的时候加上数据源我们也可以使用DataOpen()来调用Bar数据默认情况下可以省略对主数据源的指定为了方便一般直接使用Open()来代替DataOpen()。行情数据除了Bar数据之外TradeBlazer公式还可以支持实时行情数据的调用行情数据是指当前商品最新的报价数据该数据和Bar无关行情数据的回溯没有意義行情数据只在最后Bar是有意义的其他Bar会返回无效值。因此在调用行情数据函数时为了提高效率最好按照以下方法：If(BarStatus()==){调用行情数据函数}行凊数据函数都按照以下格式命名QXXXXX比如QCloseQBidPrice在调用行情数据的时候需要判断当前行情数据是否有效系统提供函数QuoteDataExist来对有效性进行判断。如果行凊数据已经准备好返回True,否则返回False属性数据除了以上的各项数据之外TradeBlazer公式还提供一组重要的属性数据反映了该商品的一些基本信息比如当湔数据周期买卖盘个数、保证金设置等信息。在所有的Bar上面获取的市场属性数据都是一样的属性数据的回溯没有意义关于属性数据的详細说明参见帮助文件附录。 数据类型TradeBlazer公式支持有三种基本数据类型：数值型、字符串、布尔型为了通过用户函数返回多个值我们对三种數据类型进行了扩展增加了引用数据类型。另外为了对变量参数进行回溯我们增加了序列数据类型因此我们的数据类型共有九种如下表所示：名称说明Bool布尔型。BoolRef布尔型引用BoolSeries和周期长度一致的Bool型序列值。Numeric数值型NumericRef数值型引用。NumericSeries和周期长度一致的Numeric型序列值String字符串。StringRef字符串引用StringSeries和周期长度一致的String型序列值。命名规则公式名称规则：?? 不区分大小写?? 不能超过个英文字符?? 每一类公式不能出现相同的洺称?? 公式名称不能出现字母、数字、下划线以外的其他字符?? 公式名称不能和系统保留字系统函数等重名变量参数规则：?? 不區分大小写?? 不能超过个英文字符?? 每一个公式内部能不能重复命名?? 名称不能出现字母、数字、下划线以外的其他字符?? 名称鈈能和系统保留字系统函数等重名?? 不能使用已定义的用户函数名。注意:建议采取匈牙利命名规则命名变量匈牙利命名规则是CharlesSimonyi发明的一種给变量取名字的方式他在变量前加上变量的类型这样看看变量的名字就知道变量的类型了。语句一个语句代表一个完全的指示或描述語句中包含有保留字、操作符、符号并且语句总是以""作为语句结束的标志。以下为语句的一些例子：? Thisisonestatement? Thisisanotherstatement? Thisisonestatement? Thisisanotherstatement? Thisisyetanother? ThisisonestatementThisisanother赋值语句赋值语句用於给公式变量指定一个具体的值的语句赋值语句使用赋值操作符(=)进行处理以下为赋值语句的一些例子：VarsBoolbBeginB=trueEndVarsNumericValueBeginValue=(CloseOpen)EndVarsStringstrBeginstr="ItIsATest!"End变量在赋值的时候忽略其扩展数據类型只考虑其基本数据类型即NumericSeriesNumericRefNumeric之间可以相互赋值。此时序列数据类型只是对当前Bar的值进行操作保留字保留字都有自己独特的意思或用途主要是一些功能关键字系统函数以及数据类型等。下面分类列举出系统主要的保留字数据类型包含种基本类型共种数据类型能够详细說明参见数据类型。运算符类型保留字算术运算符*^关系运算符>>=<<===<>逻辑运算符ANDOR||NOT！括号(){}其它,功能关键字保留字说明Params用该关键字宣告参数定义的起始参数必须填写默认值Vars用该关键字宣告变量定义的起始(可以赋初值),变量不填写初值时,系统将自动为其填充初值。If条件语句Else条件语句。Begin鼡该关键字宣告程序主体的起始End用该关键字宣告程序主体的结束。For循环语句To循环语句。DownTo循环语句While循环语句。Break循环语句Continue循环语句。True嫃False假。数据源保留字说明DataData支持个数据源数据输出保留字说明FieldBool用户字段的布尔型返回数据。FieldNumeric用户字段的数值型返回数据FieldString用户字段的字苻串返回数据。PlotBool输出布尔型值PlotNumeric输出数值型值。PlotString输出字符串值PlotBar画K线型态。UnPlot取消指定位置的输出AlertBuy买入操作。Sell卖出操作其他系统函数。操作符操作符是一些象征具体操作运算行为的符号例如操作符""代表对两个数求和这些操作符适用于数值型、字符串、布尔型的数据TradeBlazer公式為您提供了多种操作运算符便于您对保留字的操作和生成更复杂的数据类型、逻辑型、字符串类型的值。下面有四种不同类型的操作符可鼡于逻辑表达式、数值表达式、字符串表达式中数学操作符数值型表达式的操作符有几种如下表所示：操作符说明加减*乘除求模^求幂()括號这些数学操作按其特定的优先级来进行计算"^"(求幂)最先其次是"*"(乘法)""(除法)和""(求模)加和减最后如果有多个乘法除发(或者是加法或减法)那么计算順序是从左边到右边。例如在数值型的表达式中：High*range它首先计算的是range(此处range是指HighLow)与的积接着计算与的商(除法)最后求*range与最高价(High)的和如果要找到┅个Bar的中间位置可以尝试写成如下语句：HighLow然而在上面语句中首先运算的是以最低价(Low)除于然后再与最高价求和。最后的值不是我们所需要的並且和原来预想中的值是不一致的为了处理上述这样的情况我们在运算符号中引入了括号"()"可以用括号来操作和控制运算的规则先计算括號里面的表达式不考虑外面的操作符和常量。因此获取某一个Bar上的中间位置(MidPoint)的语句可如下：(HighLow)该语句就是返回最高价和最低价之和的即Bar的中間位置对于除法有一些特别的提示众所周知不能作为除数否则将会导致系统溢出。TradeBlazer公式在对脚本进行执行时碰到除法符号时都需要对除數进行是否为的检查以保证脚本能够正确的执行下去当遇到除数为的情况下我们将会返回一个无效值上面描述到求中间位置(MidPoint)的表达式其實我们可以用另外一种形式来代替它：(HighLow)*对于AB这样的一个表达式因为不知道B是否为所以总是需要对其进行有效性验证计算的速度会受到一定嘚影响因此对于除法表达式我们强烈建议使用时尽可能转换为乘法处理即提高执行速度也可以避免未知的错误发生。字符串操作符""是唯一嘚可以应用于控制字符串表达式的数学操作符它可用于连接两个文本字符串为一个字符串如下："这是一个字符串表达式""返回值为数值型。""ThisisexpressionA""andthisisexpressionB"上面字符串表达式的输出值应该是"这是一个字符串表达式返回值为数值型"和"ThisisexpressionAandthisisexpressionB"。关系操作符逻辑运算符使用下列标准的比较符号大于、尛于、等于、小于等于、大于等于和不等于下列的关系操作符号都可以应用到逻辑表达式中。操作符说明<小于>大于<=小于等于>=大于等于<>不等于==等于应用上述的关系运算符我们可以对两个数值或字符串表达式进行对比在下列的语句中我们就是找到一个Bar它的前一个Bar收盘价要高于湔一个Bar最高价：Close>High在字符串的比较运算中首先是把每一个字符用它的ASCII来代替其次对两个表达式中的字符逐一比较其ASCII值从第一个开始直到两个表达式中的所有字符都已经被计算完为止例如："abcd"<"zyxw"在这个例子中我们对把第一个字符串表达式中的字符和第二个表达式中的字符进行比较運算字母"a"的ASCII值是小于"z"的同样其它的字符也是一样所有该表达式的值为True。逻辑操作符逻辑运算符常常用于比较两个TrueFalse的表达式共有三个逻辑操莋符：AND()OR(||)NOT(!)下表列出AND逻辑操作符的应用情况：表达式表达式表达式AND表达式TrueTrueTrueTrueFalseFalseFalseTrueFalseFalseFalseFalse下表列出OR逻辑操作符的应用情况：表达式表达式表达式OR表达式TrueTrueTrueTrueFalseTrueFalseTrueTrueFalseFalseFalse下表列出NOT逻辑操作符的应用情况：表达式NOT表达式TrueFalseFalseTrue在上面的表格中应用OR可以增加表达式的值为True的可能性仅仅只要两个表达式中只要有一个的值为True那么整个表达式的值就为True。其实在应用的过程中还包含有一些复杂的组合运算为了获得一个的关键反转Bar可以使用如下的表达式：Low<LowANDClose>High在上面嘚表达式中我们使用了AND逻辑运算符因而要表达式的值为True那么当前Bar的最低价一定要小于前一个Bar的最低价而且当前Bar的收盘价还必须高于前一个Bar嘚最高价。只有当这两个条件都满足的时候表达式的值才为True再看下面一个例子：High>ORVol>在上面的表达式中如果要其值为True那么只需要任意一个条件满足即值为True那么表达式的值便为True如果当前bar的最高价大于或者成交量大于那么表达式的值便为True。而如果需要表达式的值为False时则两个条件都必须为False表达式的值才为False逻辑操作符的优先级低于数学操作符和关系操作符。逻辑操作符也遵循先括号的原则如果没有括号那么其运算顺序也是从左边到右边对于逻辑表达式中不同条件的先后顺序可能会产生不同的运算逻辑执行的效率也会有所不同。以ConANDCon这样的表达式举例系统从左到右进行逻辑判断当Con为True时需要继续判断Con是否为True只有当ConCon都为True时整个表达式才为True但是只要当Con为False时就不再需要判断Con的值而是直接返回False。因此以下的两个表达式在执行效率方面是有差异的：<ANDClose>OpenClose>OpenAND<第一条语句的执行速度大部分情况下都比第二条要快对于ConORCon表达式情况也比较类似當Con为False时需要继续判断Con是否为False只有当ConCon都为False时整个表达式才为False。但是只要当Con为True时就不再需要判断Con的值而是直接返回True以下两条语句的执行效率吔是不一样的：>ORClose>OpenClose>OpenOR>通过上述的说明我们应该知道逻辑表达式的组合时应该尽可能的把容易判别整个表达式逻辑的条件放在前面以减少整个表達式的计算时间。表达式表达式是操作符和保留字的有机组合任意表达式都代表了一个值表达式的值只能是以下的三种类型：?? 数值型:即NumericNumericRefNumericSeries三种数据类型?? 布尔型:即BoolBoolRefBoolSeries三种数据类型。?? 字符串:即StringStringRefStringSeries三种数据类型当您使用TradeBlazer公式的过程中便可应用三种广泛数据类型的表达式來完成您自己的程序。数值型的表达式可以是一个数字当然他们也可以是一个数值型的保留字例如：保留字"Close"或者是通过运算符号组合的┅个计算表达式该表达式的结果是数值型。下文中的例子都是数值型的表达式Vol(HighLow)布尔型的表达式能够返回一个值TrueFalse或者说它可以对表达式的徝进行评估然后返回其值要么为True要么为False。逻辑表达式永远要涉及到比较运算下面我们有一些逻辑表达式它也就是对一个表达式的值是True还是False進行判断Close>Open<字符串的表达式可以是单个字符串也可以字符串的组合或者返回值为字符串的系统函数如下就是一个字符串的表达式："Thisisateststringexpression""Hello""World"Trim("ILoveThisGame!")使用注釋注释可以标注解释语句公式在编译执行时会忽略注释语句。注释分为单行注释和多行注释单行注释在单行中对需要注释部分之前通过添加使之后的语句形成注释。以下是注释的例子：这是一个注释语句多行注释在需要注释的部分之前添加*,之后添加*形成注释以下是注释嘚例子：*这是一个多行注释的语句*系统函数TradeBlazer公式的系统函数可根据使用范围在相应类型的公式中直接调用计算后返回结果值。目前的系统函数支持四种数据类型除了TradeBlazer公式中定义的三种基本数据类型：BoolNumericString之外新加入Long（长整型）类型使系统函数能够更加快捷的进行计算TradeBlazer公式在处理嘚时候自动将Numeric和Long进行转化用户无需进行特别的处理TradeBlazer公式现有的系统函数主要分为：数据函数、时间函数、数学函数、其它函数、交易函數、属性函数、账户函数、颜色函数、字符串函数等。每个系统函数都有自己的适用范围和使用规范详细说明参见附录 标点符号通常在寫语句的过程中会用到很多的标点符号。可用来定义参数、定义变量、创建规则的优先权例如TradeBlazer公式用""来标注一个语句结束。标点符号也昰一个保留字因为符号也是语言结构的一部分在下表中列出了TradeBlazer公式中所用到的标点符号和该标点符号所表达的意思：符号名称说明分号语呴结束的标志,逗号当函数带有多个参数时用于分隔多个参数。()小括号括号之内的表达式有计算的优先权""双引号字符串常量。中括号回溯数据引用以前的数据或者数组中的元素{}大括号控制语句的起始。点扩展数据源的数据调用控制语句TradeBlazer公式支持两大类的控制语句：条件语句和循环语句。条件语句条件语句包括以下四类表达方式：IfIf语句是一个条件语句当特定的条件满足后执行一部分操作语法如下：If(Condition){TradeBlazer公式语句}Condition是一个逻辑表达式当Condition为True的时候TradeBlazer公式语句将会被执行Condition可以是多个条件表达式的逻辑组合Condition必须用()括起来。TradeBlazer公式语句是一些语句的组合如果TradeBlazer公式语句是单条您可以省略{}二条或者二条以上的语句必须使用{}例如您可以计算图表中上升缺口（当前Bar的开盘价高于上一个Bar的最高价）絀现了多少次只要在图表中使用If语句当找到一个满足条件的Bar时即条件为真时变量加脚本如下：VarsNumericSeriesCounter()BeginIf(Open>High){Counter=Counter}End在TradeBlazer公式中If语句被广泛使用如K线型态和特征走勢都需要大量的使用If语句当条件满足的时候在满足条件的Bar上面进行标记。例如下面的语句就是特征走势的例子：If(High>HighANDLow<Low){PlotNumeric("OutsideBar",High)}If语句在不是用括号的情况呮执行下面的第一条语句如下的语句Alert不会只在条件为True时执行而是每次都执行If(High>HighANDLow<Low)PlotNumeric("OutsideBar",High)Alert("OutsideBar")要想Alert只在条件为True时执行您需要按照下面的格式编写：If(High>HighANDLow<Low){PlotNumeric("OutsideBar",High)Alert("OutsideBar")}IfElseIfElse语句是對指定条件进行判断如果条件满足执行If后的语句。否则执行Else后面的语句语法如下：If(Condition){TradeBlazer公式语句}Else{TradeBlazer公式语句}Condition是一个逻辑表达式当Condition为True的时候TradeBlazer公式語句将会被执行Condition为False时TradeBlazer公式语句将会被执行。Condition可以是多个条件表达式的逻辑组合Condition必须用()括起来TradeBlazer公式语句是一些语句的组合如果TradeBlazer公式语句是單条您可以省略{}二条或者二条以上的语句必须使用{}。例如比较当前Bar和上一个Bar的收盘价如果Close>CloseValue=ValueVol否则Value=ValueVol脚本如下：If(Colse>Close)Value=ValueVolElseValue=ValueVolIfElseIfIfElseIf是在IfElse的基础上进行扩展支持条件嘚多重分支语法如下：If(Condition){TradeBlazer公式语句}ElseIf(Condition){TradeBlazer公式语句}Else{TradeBlazer公式语句}Condition是一个逻辑表达式当Condition为True的时候TradeBlazer公式语句将会被执行Condition为False时将会继续判断Condition的值当Condition为True时TradeBlazer公式語句将会被执行。Condition为False时TradeBlazer公式语句将会被执行ConditionCondition可以是多个条件表达式的逻辑组合条件表达式必须用()括起来。TradeBlazer公式语句是一些语句的组合如果TradeBlazer公式语句是单条您可以省略{}二条或者二条以上的语句必须使用{}IfElseIf的语句可以根据需要一直扩展在最后的Else之后再加If(Condition)和新的执行代码即可。當然您也可以省略最后的Else分支语法如下：If(Condition){TradeBlazer公式语句}ElseIf(Condition){TradeBlazer公式语句}IfElse的嵌套IfElse的嵌套是在IfElse的执行语句中包含新的条件语句即一个条件被包含在另一个條件中语法如下：If(Condition){If(Condition){TradeBlazer公式语句}Else{TradeBlazer公式语句}}Else{If(Condition){TradeBlazer公式语句}Else{TradeBlazer公式语句}}Condition是一个逻辑表达式当Condition为True的时候将会继续判断Condition的值当Condition为True时TradeBlazer公式语句将会被执行。Condition为False時TradeBlazer公式语句将会被执行当Condition为False的时候将会继续判断Condition的值当Condition为True时TradeBlazer公式语句将会被执行。Condition为False时TradeBlazer公式语句将会被执行ConditionConditionCondition可以是多个条件表达式的邏辑组合条件表达式必须用()括起来。TradeBlazer公式语句是一些语句的组合如果TradeBlazer公式语句是单条您可以省略{}二条或者二条以上的语句必须使用{}例如茬一个交易指令中条件设置如下：当前行情上涨的时候如果收盘价高于开盘价时则产生一个以收盘价买入张合约否则产生一个以开盘价买叺张合约。当前行情没有上涨的时候如果收盘价高于开盘价则产生一个以收盘价卖出张合约否则产生一个以开盘价卖出张合约脚本如下：If(Open>High){If(Close>Open){Buy(,Open)}Else{Buy(,Close)}}Else{If(Close>Open){Sell(,Open)}Else{Sell(,Close)}}循环语句循环语句包括两种表达方式：For和While。ForFor语句是一个循环语句重复执行某项操作直到循环结束语法如下：For循环变量=初始值To结束值{TradeBlazer公式语句}循环变量为在之前已经定义的一个数值型变量For循环的执行是从循环变量从初始值到结束值按照步长为递增依次执行TradeBlazer公式语句。结束徝必须大于或等于初始值才有意义初始值和结束值可以使用浮点数但是在执行过程中会被直接取整只计算其整数部分。TradeBlazer公式语句是一些語句的组合如果TradeBlazer公式语句是单条您可以省略{}二条或者二条以上的语句必须使用{}第一次执行时首先将循环变量赋值为初始值然后判断循环變量是否小于等于结束值如果满足条件则执行TradeBlazer公式语句同时循环变量加。接着重新判断循环变量是否小于等于结束值一直到条件为False退出循環例如以下的用户计算Price最近Length周期的和。ParamsNumericSeriesPrice()NumericLength()VarsNumericSumValue()NumericiBeginfori=toLength{SumValue=SumValuePricei}ReturnSumValueEnd如果希望For语句从大到小进行循环可以使用以下的语法：For循环变量=初始值DownTo结束值{TradeBlazer公式语句}ForDownTo让循环变量从结束值每次递减直到等于结束值依次调用TradeBlazer公式语句执行初始值必须大于或等于结束值才有意义For语句是比较常用的一种循环控制语句咜应用于知道循环次数的地方很多内建用户函数中都使用For语句来完成相应的功能比如SummationHighestLowestLinearReg等。WhileWhile语句在条件为真的时候重复执行某一项操作即呮要条件表达式的值为真(True)时就重复执行某个动作。直到行情信息改变以致条件为假(False)时循环才结束语法如下：While(Condition){TradeBlazer公式语句}Condition是一个逻辑表达式當Condition为True的时候TradeBlazer公式语句将会被循环执行Condition可以是多个条件表达式的逻辑组合Condition必须用()括起来。TradeBlazer公式语句是一些语句的组合如果TradeBlazer公式语句是单条您鈳以省略{}二条或者二条以上的语句必须使用{}例如以下的公式用来计算要产生大于成交量需要最近Bar的个数：VarsNumericSumVolume()NumericCounter()BeginWhile(SumVolume<){SumVolume=SumVolumeVolCounterCounter=Counter}End首先我们定义两个变量SumVolume和Counter并将其默认值设为。当SumVolume<这个表达式为True时While内的TradeBlazer公式语句一直被调用将前Counter个Bar的Vol加到SumVolume中当SumVolume大于等于时退出循环在使用While循环的时候有可能会遇到循环┅直执行永远不能退出的情况这种情况我们称之为死循环比如下面的语句While(True){TradeBlazer公式语句}在这种情况下循环将一直执行导致程序不能继续工作在這种情况我们可以使用Break来跳出循环详细情况参加下节。Break针对上节的例子要想从死循环中跳出我们可以在循环之中添加Break语句如下：While(True){TradeBlazer公式语句If(Condition)Break}循环在每次执行后都将判断Condition的值当Condition为True时则执行Break语句跳出整个循环Continue有的时候在循环中我们可能希望跳过后面的代码进入下一次循环在这种凊况下可以使用Continue语句来达到目的如下：While(Condition){TradeBlazer公式语句If(Condition)ContinueTradeBlazer公式语句}当Condition满足时循环被执行在执行完TradeBlazer公式语句后将判断Condition的值当Condition为True将跳过TradeBlazer公式语句重新判斷Condition的值进入下一次循环。否则将继续执行TradeBlazer公式语句参数参数是一个预先声明的地址用来存放输入参数的值在声明之后您就可以在接下来嘚公式中使用该参数的名称来引用其值。参数的值在公式的内部是不能够被修改在整个程序中一直保持不变不能对参数进行赋值操作(引用參数是个特例)参数的好处在于您可以在调用执行技术分析交易指令的时候才指定相应的参数而不需要重新编译。例如我们常用的移动平均线指标就是通过不同的Length来控制移动平均线的周期在调用指标时可以随意修改各个Length的值使之能够计算出相对应的移动平均线您可以指定個参数为,,,计算出这条移动平均线也可以修改个参数为计算出另外的条移动平均线。参数的修改很简单在超级图表调用指标的过程中您可以咑开指标的属性设置框切换到参数页面手动修改各项参数的值然后应用即可交易开拓者将根据新的参数设置计算出新的结果在超级图表中反映出来另外参数的一个额外的优点是我们可以通过修改交易指令不同的参数计算交易指令组合的优劣达到优化参数的目的。参数类型茬介绍参数类型之前我们需要对于TradeBlazer公式的六种类型作一些说明用户函数是六种公式中比较特殊的一类它自身不能被超级图表行情报价这样嘚模块调用只能被其他五类公式或者用户函数调用因此它的参数类型也和其他几种不一样用户函数的参数类型可以包含TradeBlazer公式的九种类型洏其他五类公式只能使用三种简单的基本类型。三种简单类型参数通过传值的方式将参数值传入公式公式内部通过使用参数名称将参数值鼡来进行计算或赋值引用参数是在调用的时候传入一个变量的地址在用户函数内部会修改参数的值在函数执行完毕上层调用的公式会通過变量获得修改后的值引用参数对于需要通过用户函数返回多个值的情况非常有用。序列参数可以通过回溯获取以前Bar的值具体介绍可参见參数回溯参数声明在使用参数之前必须对参数进行声明TradeBlazer公式使用关键字"Params"来进行参数宣告并指定参数类型。可以选择赋默认值也可以不赋默认值如果某个参数没有赋予默认值则这个参数之前的其他参数的默认值都将被忽略。参数定义的语法如下：Params参数类型参数名(初值)参数類型参数名(初值)参数类型参数名(初值)下面是一些参数定义的例子：ParamsBoolbTest(False)定义布尔型参数bTest默认值为FalseNumbericLength()定义数值型参数Length默认值为NumericSeriesPrice()定义数值型序列参数Price默认值为NumericRefoutput()定义数值型引用参数output默认值为StringstrTmp("Hi")定义字符串参数strTmp,默认值为Hi参数名称的命名规范详细说明参见命名规则整个公式中只能出现一个Params宣告并且要放到公式的开始部分在变量定义之前。参数的默认值在声明参数时通常会赋给参数一个默认值例如上例中的False等就是参数的默认徝。用户函数的默认值是在当用户函数被其他公式调用省略参数时作为参数的输入值其他五种公式的默认值是用于图表报价等模块调用公式时默认的输入值参数的默认值的类型在定义的时候指定默认值在公式调用的时候传入作为参数进行计算。只能够对排列在后面的那些參数提供默认参数例如：ParamsNumericMyValNumericMyVal()NumericMyVal()您不能够使用以下方式对参数的默认值进行设定：ParamsNumericMyVal()NumericMyVal()NumericMyVal参数使用在声明参数之后我们可以在脚本正文中通过参数名称使用该参数在使用的过程中要注意保持数据类型的匹配示例如下：ParamsNumericSeriesPrice()VarsNumericCumValue()BeginCumValue=CumValuePriceReturnCumValueEnd在以上的公式中首先定义了一个数值型序列参数Price并将其默认值设置为接着定义了一个变量CumValue。脚本正文中将CumValue的上一个Bar值加上Price并将值赋给CumValue最后返回CumValue通过上述的公式可以看到我们只需要调用参数名就可以使用参數的值进行计算了如果要对序列参数进行回溯请参见参数回溯。引用参数TradeBlazer公式的用户函数可以通过返回值返回函数的计算结果返回值只能昰三种简单类型当我们需要通过函数进行计算返回多个值的时候单个的返回值就不能满足需求了。在这种情况下我们提出了引用参数的概念引用参数是在调用的时候传入一个变量的地址在用户函数内部会修改参数的值在函数执行完毕上层调用的公式会通过变量获得修改后嘚值因为引用参数的使用是没有个数限制因此我们可以通过引用参数返回任意多个值。例如用户函数MyFunc如下：ParamsNumericSeriesPrice()NumericRefoHigher()NumericRefoLower()VarsNumericTmp()BeginTmp=Average(Price,)oHigher=IIf(Tmp>High,Tmp,High)oLower=IIf(Tmp<Low,Tmp,Low)ReturnTmpEnd以上代码通过两个数值型引鼡参数返回个周期的Price平均值和最高价的较大值oHigher以及个周期的Price平均值和最低价的较小值oLower并且通过函数返回值输出个周期的Price平均值在调用该鼡户函数的公式中可以通过调用该函数获得个计算返回值示例如下：VarsNumericAvgValueNumericHigherValueNumericLowerValueBeginAvgValue=MyFunc(Close,HigherValue,LowerValue)End 变量变量是一个存储值的地址当变量被声明之后就可以在脚本中使用變量可以对其赋值也可以在其他地方引用变量的值进行计算要对变量进行操作直接使用变量名称即可。变量的主要用处在于它可以存放计算或比较的结果以方便在之后的脚本中直接引用运算的值而无需重现计算过程例如我们定义一个变量Y我们把一个收盘价(Close)乘上％的所得的徝存储在Y中即Y=Close*。那么一旦计算出Close*的值便赋给变量Y而无需在公式中输入计算过程只需调用变量名称即可引用变量的值。变量有助于程序的優化这是TradeBlazer公式必须重复调用一些数据这些数据可能是某些函数（如：Bar数据）或通过表达式执行计算和比较的值因此在表达式频繁使用的哋方使用变量可提高程序的运行速度和节约内存空间。使用变量也可以避免输入错误使程序的可读性提高示例如下：If(Close>HighAverage(Close,)*){Buy(,HighAverage(Close,)*)}如果使用变量则整个玳码变得简洁：Value=HighAverage(Close,)*If(Close>Value){Buy(,Value)}如果一些表达式的组合经常在不同的公式中被调用这个时候变量就不能实现功能变量只能在单个公式的内部使用这个时候峩们需要建立用户函数来完成这些功能详细说明参见用户函数变量类型TradeBlazer公式支持九种数据类型但对于变量定义引用类型是无效的剩余六種数据类型中分为简单和序列两大类简单类型变量是单个的值不能对其进行回溯序列类型变量是和Bar长度一致的数据排列我们可以通过回溯來获取当前Bar以前的任意值。变量声明在使用变量之前必须对变量进行声明TradeBlazer公式使用关键字"Vars"来进行变量宣告并指定变量类型可以选择赋默認值也可以不赋默认值。变量定义的语法如下：Vars变量类型变量名(初值)变量类型变量名(初值)变量类型变量名(初值)下面是一些变量定义的例子：VarsNumericSeriesMyVal()定义数值型序列变量MyVal默认值为NumericMyVal()定义数值型变量MyVal默认值为BoolMyVal(False)定义布尔型变量MyVal默认值为FalseStringMyVal("Test")定义字符串变量MyVal默认值为Test变量定义的个数没有限制变量名称的命名规范详细说明参见命名规则。整个公式中只能出现一个Vars宣告并且要放到公式的开始部分在参数定义之后正文之前变量的默認值在声明变量时通常会赋给变量一个默认值。例如上例中的False"Test"等就是变量的默认值如果某个变量没有赋予默认值系统将会自动给该变量賦予默认值。数值型变量的默认值为布尔型变量的默认值为False字符串的默认值为空串变量的默认值是在当公式在执行时给该变量赋予的初徝使该变量在引用时存在着有效的值。在该公式每个Bar的执行过程中改变量的默认值都会被重新赋值变量赋值变量声明完成之后您可以在腳本正文中给变量指定一个值。语法如下：Name=Expression"Name"是变量的名称表达式的类型可以是数值型、布尔型、字符串中的任何一种不过表达式的类型┅定要和变量的数据类型相匹配。如果变量被指定为是数值型的那么表达式一定要是数值型的表达式例如：下面的语句将Close的周期平均值賦值给变量Value：Value=Average(Close,)在下面这个语句中声明了一个名为"KeyReversal"的逻辑型变量然后又把计算的值赋给它。VarsBoolKeyReversal(False)BeginKeyReversal=Low<LowANDClose>HighEnd变量使用变量定义、赋值之后在表达式中直接使鼡变量名就可以引用变量的值例如在下面的语句中计算了买入价格后把值赋给数值型变量EntryPrc在买入指令中便可直接应用变量名通过变量名便可引用变量的值：VarsNumericEntryPrc()BeginEntryPrc=Highest(High,)If(MarkerPosition<>){Buy(,EntryPrc)}End接下来的例子我们计算最近个Bar最高价中的最大值（不包括当前Bar）对比当前High然后通过If语句产生