Virtools脚本语言(VSL)教程 - 函数

声明VSL

函数定义语法

函数定义确立了函数的名称、它的返回值类型、它的形参的类型和数量、及函数主题。

returnType functionName ( [paramList ] ) { functionBody }

paramList :
parameter , ...

parameter :
type parameterName

实例：

int Square(int i)

{

	return i*i;

}

函数参数

参数是函数期望接收到的值。在函数原型中，函数名后面跟着的括号里包含了函数参数与其类型的完整列表。参数声明指定了参数中存储的值的类型、大小及标识符。

在声明参数时，你可以指定缺省值。

void MakeAction(int actionNumber, bool logInConsole = false)

{

	// Make action according to actionNumber


	// ...


	

	if (logInConsole)

	{

		String message("Make Action Num ");

		message += actionNumber;

		bc.OutputToConsole(message);

	}

}



void main()

{

	MakeAction(0, true);

	MakeAction(1, false);

	

	// In this case, second parameter of MakeAction


	// is equal to default value false


	MakeAction(0); 

}

你也可以声明不带参数的函数。

float Pi()

{

	return 3.14156;

}

函数返回值

函数的返回值类型确立了函数返回值的大小和类型。
这里是一份所有类型说明符的清单：

• void
  char
  int
  float
  VSL enum
  VSL struct
  C/C++ struct/class

你可以声明不带返回值类型的函数。这种情况下，你得用"void"作类型名。

void Print(String s, int line)

{

	s += line;

	bc.OutputToConsole(s);

}

函数重载

VSL允许声明多个同名函数。这些函数叫做被重载的函数。重载函数让程序员能根据参数的类型和数量对某个函数补充不同的语义。

实例：

int Add(int a, int b) // Add two int


{

	return a + b;

}



float Add(float a, float b) // Add two float


{

	return a + b;

}

void main()

{

	float r1 = add(10.0,5.0); // Call first Add function


	int r2 = add(1,2); // Call second Add function


}

在你重载函数时，由VSL编译器选择所匹配的函数。某些情况下，你会处在一种模棱两可的境地，因为编译器不知道选哪个函数。

void main()

{

	float r = add(10.0, 5); // error, ambiguous call


}

这个函数的调用就是模棱两可的，因为所有函数都可用：
10.0 可以被计算成整数或5可以被计算成浮点数。

调用函数

在一个VSL脚本中，你可以调用当前脚本中定义的任何VSL函数、全局脚本中的函数或任何限定的C/C++函数。定义函数并不是执行它。定义函数是对该函数简单命名及指定当函数被调用时做什么。对函数进行调用实际上就是执行那些指定的行为。

递归

函数甚至可以被递归。即它可以调用它自己。例如，这里有一个计算Fibonacci数的函数：

int fibo(int n)

{

	if (n == 0)

		return 0;

	if (n == 1)

		return 1;

	return fibo(n-2)+fibo(n-1);

}



void main()

{

	fibo(3); // return 2


	fibo(4); // return 3


	fibo(5); // return 5


	fibo(6); // return 8


}

给VSL函数传递参数

VSL中所有基本类型(bool, char, int, float, str) 通过值来传递。值传递给函数，但如果该函数改变了该参数的值，此改变不会对全局或调用函数中产生影响。

void foo(int a)

{

	a = 10;

	bc.OutputToConsole(a); // Print 10 in the console


}



void main()

{

	int b = 3;

	foo(b);

	bc.OutputToConsole(b); // Print 3 in the console


}

VSL结构与C/C++结构/类由引用来传递。如果函数修改了所引用的参数，它也修改了那个原始的。

void ChangeVector(Vector v)

{

	v.x = 1.0;

	v.y = 2.0;

	v.z = 3.0;

}



void main()

{

	Vector v(0.0,0.0,0.0); // the members x, y and z are equal to 0.0


	

	ChangeVector(v);

	bc.OutputToConsole(v.x); // Print 1.0


	bc.OutputToConsole(v.y); // Print 2.0


	bc.OutputToConsole(v.z); // Print 3.0


}

给C/C++函数传递参数

在调用C/C++函数时，遵守C/C++中函数声明规则。VSL中不支持常量参数，但可以使用C/C++常数函数及使用带常量参数的C/C++函数。既然const关键字为被实现，你必须在使用带常量参数的C/C++函数时谨慎一些。