AMXXPawn 参数

1. 简介

参数（Parameter）是函数与外部交互的接口，决定了函数如何接受输入数据。

关键概念：

1. 形参（Formal Parameter）

函数声明、定义语句中列出的变量，用于描述需要哪些数据。

static testfunc(param) { } // param是形参

2. 实参（Actual Argument）

调用函数时传入的表达式（字面量、常量、变量或函数返回值等）。

public plugin_init() { const constant = 1; // 常量 new variable; // 变量 // 调用server_print函数，传入字符串字面量、常量、变量、函数返回值作为实参 server_print("[AMXX]字面量! c:%d v:%d f:%d", constant, variable, random(5)); }

参数的作用：

• 传递数据：将外部数据传入函数内部进行处理。
• 定制行为：通过不同参数值改变函数的执行逻辑。
• 提高复用性：同一函数通过不同参数处理多种情况，减少重复代码。

常见参数类型：

1. 位置参数（Positional Arguments）

调用函数时，可以按声明顺序输入实参，称为位置参数（位置实参）：

// 按顺序，param1是1号参数，param2是2号参数 static testfunc(param1, param2) return param1 + param2; public plugin_init() { // 调用testfunc函数，按顺序填写param1和param2的值，此时10和20是位置参数 testfunc(10, 20); }

2. 命名参数（Named Arguments）

调用函数时，可指定实参对应的形参名称，称为命名参数（命名实参）：

// 按顺序，param1是1号参数，param2是2号参数 static testfunc(param1, param2) return param1 + param2; public plugin_init() { // 调用testfunc函数，通过参数名显式赋值，顺序可打乱，此时20和10是命名参数 testfunc(.param2 = 20, .param1 = 10); }

注意：所有命名实参都必须后置，位置参数必须前置。

// 报错：位置实参只能出现在命名实参前 testfunc(.param2 = 20, 10);

3. 传值参数（Pass by Value）

• 形参绝非数组，实参可以是任意单值表达式。
• 形参是实参的副本，属于栈变量（临时变量），在调用函数时创建，退出函数后销毁。
• 对形参的修改不会影响实参。
// 参数param是按值传递 static testfunc(param) { // 更改param的值，不会影响实参 param = 20; } public plugin_init() { // 不用担心字面量10被更改 testfunc(10); // 不用担心变量arg被更改 new arg = 10; testfunc(arg); }

4. 传引用参数（Pass by Reference）

• 形参声明中含有&修饰符或[]维度声明，或者形参名称是...（可变参数）。
• 若形参是可变参数，实参可以是任意表达式，若是常量表达式，会生成临时变量代替实参被传入。
• 若形参是不可变参数，实参必须是变量。
• 形参和实参是同一个变量。
• 修改形参等于修改实参变量。
// 参数param1、param2、...是按引用传递 static testfunc(&param1, param2[1], ...) { // 更改param1和对应实参的值 param1 = 20; // 更改param1和对应实参的值 param2[0] = 20; // 更改可变参数（第3个实参）的值 setarg(.arg = 2, .index = 0, .value = 20); // 更改可变参数（第4个实参）的值 setarg(.arg = 3, .index = 0, .value = 20); } public plugin_init() { new arg1 = 10; new arg2[1] = 10; new arg3 = 10; testfunc(arg1, arg2, arg3, 10); // arg1、arg2、arg3会被改为20 // 第4个实参（常量表达式10）不会被更改，因为暗中有一个临时变量代替它被传入，被更改了 }

5. 数组参数

• 形参声明中含有[]维度声明，则形参是数组参数。
• 数组参数可传递多个数值，并且是强制按引用传递的，因此实参不能是常量和单值字面量。
// 参数param1和param2是数组参数 static testfunc(param1[], param2[3][2]) { }

6. 可变参数（Variadic Parameters）

• 声明形参时，用...作为名称，则表示声明可变参数。
• 其数量可变，数组结构可变（允许外界输入0或多个实参、不限制实参是否为数组，不限制实参数组结构）。
• 可变参数是强制按引用传递的，虽然不限制实参是什么表达式，但会自动创建变量代替外界输入的常量表达式。
// ...表示数量不限，结构不限；any:表示标签不限 static testfunc(any:...) { // 获取实参总数 new totalArgCount = numargs(); // 获取索引号为0的实参[0]偏移量 new arg0@0_addr = getarg(.arg = 0, .index = 0) / 4 + 0; // 获取索引号为0的实参[0][0]（假设索引号为0的实参是二维数组） new arg0@0@0 = getarg(.arg = 0, .index = arg0@0_addr + 0); // 将索引号为0的实参[0]设为 { arg0@0@0 * 10, 20, 30 } setarg(.arg = 0, .index = arg0@0_addr + 0, .value = arg0@0@0 * 10); setarg(.arg = 0, .index = arg0@0_addr + 1, .value = 20); setarg(.arg = 0, .index = arg0@0_addr + 2, .value = 30); // 获取索引号为0的实参[1]偏移量 new arg0@1_addr = getarg(.arg = 0, .index = 1) / 4 + 1; // 获取索引号为0的实参[1][0]（假设索引号为0的实参是二维数组） new arg0@1@0 = getarg(.arg = 0, .index = arg0@1_addr + 0); // 将索引号为0的实参[1]设为 { arg0@1@0 * 10, 50, 60 } setarg(.arg = 0, .index = arg0@1_addr + 0, .value = arg0@1@0 * 10); setarg(.arg = 0, .index = arg0@1_addr + 1, .value = 50); setarg(.arg = 0, .index = arg0@1_addr + 2, .value = 60); // 获取索引号为0的实参[2]偏移量 new arg0@2_addr = getarg(.arg = 0, .index = 2) / 4 + 2; // 获取索引号为0的实参[2][0]（假设索引号为0的实参是二维数组） new arg0@2@0 = getarg(.arg = 0, .index = arg0@2_addr + 0); // 将索引号为0的实参[2]设为 { arg0@2@0 * 10, 80, 90 } setarg(.arg = 0, .index = arg0@2_addr + 0, .value = arg0@2@0 * 10); setarg(.arg = 0, .index = arg0@2_addr + 1, .value = 80); setarg(.arg = 0, .index = arg0@2_addr + 2, .value = 90); } public plugin_init() { new array[3][3] = { { 1, 2, 3 }, { 4, 5, 6 }, { 7, 8, 9 } }; test(array); // array内部所有数值都被改为10倍 for (new i; i < sizeof array; i++) for (new j; j < sizeof array[]; j++) server_print("array[%d][%d] = %d", i, j, array[i][j]); }

7. 可选参数

• 若声明可变参数或拥有初始化表达式的参数，调用函数时可以选择是否输入对应实参。
• 若不输入可变参数，函数内获取实参，将得到垃圾数据（访问错误内存）。
• 若不输入拥有初始化表达式的参数，函数会得到该参数的默认值。
static testfunc(param1, param2 = 10, ...) { // param2的默认值是10，可变参数没有默认值，一旦省略，就不应该访问可变参数 } public plugin_init() { // param1是必需填的参数，param2和...是可选参数，可省略 testfunc(.param1 = 10); }

2. 参数声明语法

参数声明必须写在函数声明语句中的参数列表内。

注意：下文中，（）表示必填项目，【】表示可选项目。

3. 实参计算顺序

调用函数，输入多个实参时，若有需要运行时取值的表达式，实参计算顺序受到编译器优化影响，并不固定。

示例：

根据直觉，计算顺序应该从左至右计算，打印结果应为：

[AMXX] 2 2 3 3

实际打印：

[AMXX] 2 1 3 2

因此，建议提前计算各个参数的值，然后再调用函数，以保障可移植性和可维护性：