ZBScript C++脚本编译器（仅共享文档，勿索取源码）

pc引用与外部函数在脚本里的一次使用相关的指针，该指针也会作为函数执行的参数。该指针在编译时由编译器创建，与外部函数的一次使用相关联。该参数指向的数据可以由Check函数建立，根据特定的函数参数情况建立信息，然后在函数执行时根据这些信息作处理。一个典型的用法是外部插件已经使用了独立的参数格式，使用pc构造一个符合外部插件需要的参数对象。

如果检查不通过，msg返回错误信息。

4.4.5 执行函数功能

virtual bool Exec(CZBVector<Variable > & params,void * & pc,Variable & ret,string & msg,void * pe)

params由脚本执行程序传入，为函数本次执行的参数。这些参数可能是变量，每次执行都不同。

Pc与Check函数的pc参数相同，引用同一个与函数的一次引用相关的指针。如果Check函数将这个指针指向了一个有效数据结构，该结构此时传递给函数使用。

Ret返回函数执行结果。

Pe由脚本执行程序的参数给出，直接传递给函数。通常为函数执行所需的外部数据。

如果执行失败，msg返回出错信息。

注意区分函数返回值和本调用的返回值，仅当本调用返回true的时候ret才有意义。任何一个函数调用失败（本调用返回false）都将导致整个脚本执行失败（得不到脚本返回值）。

5 脚本示例（脚本编写者）

示例1 简单表达式：

123+4.5*3-max(1,2,3,0)

示例2 简单逻辑：

if(12>5)12+5;else 12*5

示例3 复杂逻辑，注意确保每个执行路径都返回有意义的结果：

int i;//int与long同义

double d=1.5+max(1,2,3);//float与double同义

string s=to_string(d);

do //do循环

{

++i;

}while(i<10);

while(i>0) //while循环

{

i-=d;

}

for(i=0;i<5;++i) //for循环

{

if(strlen(s+'abc')>=3) //if语句 if()...或if()...else...或if()...else if()...else...可以有多个else if

{

continue;

}

else

{

break;

}

return i+d;

6 编程示例（C++程序员）

6.1 简单调用

如果不使用环境变量，仅需要下面代码中红色字体的三行

//声明脚本对象和环境变量组，环境变量组不是必需的

zbstd_script::CZBScript * zbscript=new zbstd_script::CZBScript;

vector<pair<string,zbstd_script::Variable > > envs;

//添加了一个环境变量dis_total，类型为整数

pair<string,zbstd_script::Variable > tmppair;

zbstd_script::Variable tmpvar;

tmpvar.type=zbstd_script::Variable::LONG;

tmppair.first="dis_total";

tmppair.second=tmpvar;

envs.push_back(tmppair);

//执行编译，如果不需要环境变量可省去第二个参数

if(!zbscript->Compile(str,&envs))

{

MessageBox(zbscript->GetMessage().c_str(),"出错",MB_OK|MB_ICONSTOP);

}

//设置环境变量的值

envs[0].second=10L;

//执行脚本并显示结果

zbstd_script::Variable var;

if(!zbscript->Execute(var,&envs))

{

MessageBox(zbscript->GetMessage().c_str(),"出错",MB_OK|MB_ICONSTOP);

}

else

{

MessageBox(var.GetString().c_str(),"运行结果");

}

6.2 编写外部函数

可参考内部函数，下面是一个内部函数max的代码，这个函数可以这样使用

max(1,3,-1)，结果为3，因为3是三个参数中最大的

该函数实现为CMax类

Check函数检查是否至少有一个参数并且所有参数都是数值类型

Exec函数把所有参数转换为double类型比较大小，返回最大的

pc和pe参数没有使用

struct CMax : public CFunction

{

CMax():CFunction("max",Variable::DOUBLE){}

virtual string & help(string & ret)

{

ret=CFunction::help(ret);

ret+="取最大值，-N个参数，参数必须是数值/r/n";

return ret;

}

virtual bool Check(CZBVector<Variable > & params,void * & pc,string & msg)

{

msg="";

if(params.size()<1)msg+="参数不足/r/n";

for(size_t i=0;i<params.size();++i)

{

if(!params[i].isNumber())msg+="参数必须是数值/r/n";

}

return 0==msg.size();

}

virtual bool Exec(CZBVector<Variable > & params,void * & pc,Variable & ret,string & msg,void * pe)

{

size_t _max=0;

for(size_t i=1;i<params.size();++i)

{

if(params[i].GetDouble()>params[_max].GetDouble())_max=i;

}

ret=params[_max];

return true;

}

};

6.3 为外部plugin实现CFunction接口

6.3.1 已经存在的外部plugin接口

class BasePlugin

{

public:

virtual STATE init(){return 0;}

virtual STATE execute(const VParam& params,CEventPacket& inputPacket,long& retValue) = 0;

virtual STATE post(){return 0;}

}

这是一个常见的plugin接口，init对插件初始化，execute执行插件，post做插件清理。

Init和post通常由外部系统调用，需要用脚本解释器调用的是execute函数。

Execute函数的参数params是一个参数列表，大致相当于vector<string>，inputPacket是函数要处理的对象，retValue获得返回值。从这个函数的参数可以看出脚本解释器的pc和pe参数的必要性，pc可以实现外部plugin接口的params，pe则用来传递inputPacket。