PeakScript

版本发布页面

https://github.com/Jenocn/PeakScript/releases

介绍

PeakScript是一个脚本语言,在第一次加载脚本时创建一组运行时的对象,之后的调用不会多次进行解析,从而运行效率非常好,提供了c++和c#两个版本的解释器,通用易接入

---

语句结束符

• ;分号或\n换行为一条语句的结束符

变量声明

var或the

用于声明一个变量
例如:
var num = 0; 表示声明一个名为num的变量,并初始化为数值0
var num; 表示声明一个名为num的变量,默认值为null

变量声明&赋值符

set

检查一个变量是否存在,不存在则声明,存在则直接赋值
例如:

set value = 0; // 声明一个value变量  
set value = "Hello World"; // value已经存在,则直接赋值  

常量声明

const 用于声明一个常量

可以直接作为声明符,后可跟变量声明符
例如:
const num = 10; 声明一个num常量
const var num = 10; 亦可,同上

赋值

当变量声明之后,则可以直接赋值
例如:num = 99;

数据类型

PeakScript使用的是动态数据类型,number,bool,string,null,array,object

number类型

常见的小数,整数和负数

bool类型

true或false两种值,提供两种别名yes,no

string类型

字符串类型,字符串类型符号有3种,分别为:
上点号: `Hello World`
双引号: "Hello World"
单引号: 'Hello World'
不同的符号之间可以嵌套

null类型

表示空

array类型

表示一个数组,数组的声明符号为[]中括号,数组中可以存在不同的数据类型,也可以嵌套数组
例如:
var arr = [1, "Hello", false, null, [1, 2]];
数组可以通过下标访问:
例如:
arr[0],arr[4][0]
数组下标可以是任何返回整数的表达式
例如:
var i = 0; arr[i]; arr[1 + 1];

object类型

表示一个对象,对象可以包括一组变量和方法
对象声明:

// 和function一样, object声明标识可不写,如:`MyObj {}`
objcet MyObj {
	var v0 = 0;
	var v1 = 1;
	function sum() {
		return v0 + v1;
	}
}

对象调用:

MyObj.v0 = 10;
MyObj.v1 = 20;
echo MyObj.sum();

new操作符

new操作符可以对任何变量使用, 表示根据变量当前的值生成一个新的变量
例如:

var obj = new MyObj;
var arr = new array0;

• 对于number,bool,null,string,function无需使用new操作符来生成新的对象,直接赋值即可
• 对于array,object则必须使用new才能生成一个新的对象

enum枚举

例如:

enum Type {
	None = 0,
	value0,
	value1,
	value2,
	special0 = 1001,
	special1,
	special2,
}

函数

函数声明,前置声明符号function可写可不写
例如声明一个返回两个数总和的函数:

sum(a, b) {  
	return a + b;  
}  
var ret = sum(1, 2); // 返回3  

支持函数重载:

sum(a, b, c) {
	return a + b + c;
}

运算符

算术运算符

常规的+,-,*,/,%,(,)

关系运算符

常规的>,>=,<,<=,==,!=,

逻辑运算符

常规的||,&&,提供两种别名and,or

自赋值运算符

常规的+=,-=,*=,/=,%=

自增,自减运算符

++,--,与c++一样,符号前置时返回计算后的值,符号后置时返回计算前的值

非运算符

!,非运算符后可跟表达式或变量,返回这个表达式的非值

代码块

与大多数语言一样,在当前作用域下新建一个作用域空间,代码块中可以访问上面的变量和函数,代码块中的变量遵循就近原则
例如:

var num = 10;  
{  
    var num = 9;  
    echo num; // 9  
}  
echo num; // 10  

代码块{,}也可以使用关键字begin,end表示

条件语句

if,else if,else
if后可跟表达式,表达式可以有(,),也可以不写,执行的代码若只有一条语句可以不写大括号{,}
例如:

if (true) {  
} else if (true) {  
} else {  
}  

循环语句

loop循环

指定次数的循环
例如:

loop(3) {  
    echo "Hello"; // 将会循环3次    
}  

支持得到当前的下标:

loop(i in 3) {  
    echo i; // 将会打印 0 1 2  
}  

跟if一样,可以有(,),也可以不写,后面只有一条语句可以不写大括号(后面的循环语句都一样)

while循环

常规的while循环,与c++一样

var num = 0;  
while (num < 10) {  
	// todo...  
	num++;  
}  

do - while循环

常规的,先执行一遍,然后判断条件
例如常见用法:

do {  
	// todo...  
} while (false);  

foreach循环

此循环只可用在数组上
例如:

var arr = [1, 2, 3, 4];  
foreach(var item in arr) {  
	echo item; // 遍历输出    
}  

此循环可以简写为for:

for (item in arr) {  
	echo item; // 遍历输出  
}  

for循环

常规的,例如:

for (var i = 0; i < 10; ++i) {  
	echo i; // 0 ~ 9  
}  

break和continue

循环中遇到break则直接跳出当前循环,遇到continue则立即执行下一次循环

模块 import/export

import 引用模块

添加模块后则可以调用对应模块空间的对象
格式:

import "ModuleName";

ModuleName:

• 使用ModulePool事先添加的模块制定名称
• 其他代码文件中export的名称
• peak脚本代码的文件名

export 导出模块

导出当前代码空间
格式:

export "ModuleName";

ModuleName不能与已存在的模块名重复

异常处理

try {  
	// 执行语句  
} catch {  
	// 若try当中存在错误的语句,则执行  
} finally {  
	// 无论如何最后都会执行  
}  

注释

单行注释: //或#
多行注释:/*与*/之间

内置函数

echo命令

用于打印变量的值或者函数的说明
例如: echo "Hello World"; // Hello World

print函数

同echo但print作为一个函数存在 例如:
print("Hello"); // Hello

len函数

返回一个数组或者字符串的长度
例如:
len("abc"); // 返回3
len([1, 2, 3]); // 返回3

type函数

返回当前参数数值类型的字符串
例如: type(""); // 返回 string
type(0); // 返回 number
type(true); // 返回 bool
type(null); // 返回 null
type([1]); // 返回 array
type(print); // 返回 function
type(MyObj); // 返回 object

is_xxx函数

判断一个变量是否为某个类型的值
例如:
is_null(); // 返回是否为null
is_string(); // 返回是否为string
is_number(); // 返回是否为number
is_bool(); // 返回是否为bool
is_array(); // 返回是否为array
is_function(); // 返回是否为function
is_object(); // 返回是否为object

to_string函数

将任意类型转换为字符串并返回

to_number函数

将字符串转换为number类型并返回

API调用

在peak命名空间下的三个类

VirtualMachine 虚拟机

• LoadXXX系列方法用于加载脚本
• LocateXXX系列方法用于重定位解释器的一些预设方法
• GetXXX方法用于获取解释器的一些内置对象

VirtualJourney 虚拟“旅途”

• Execute方法用于执行脚本
• FindVariable用于获取空间中的对象
• AddVariable用于添加对象到空间中