FuelLabs/sway项目中的函数详解：从基础到可变参数

最新推荐文章于 2025-05-30 09:04:16 发布

原创最新推荐文章于 2025-05-30 09:04:16 发布 · 219 阅读

6 ·

CC 4.0 BY-SA版权

FuelLabs/sway项目中的函数详解：从基础到可变参数

sway 赋能每个人构建可靠、高效的智能合约。项目地址: https://gitcode.com/gh_mirrors/sw/sway

什么是Sway函数？

在FuelLabs/sway项目中，函数是执行特定任务的自包含代码块，使用fn关键字声明。函数可以接收输入参数并返回结果，是构建智能合约逻辑的基础单元。

基本函数语法

让我们看一个简单的函数示例：

fn equals(first_param: u64, second_param: u64) -> bool {
    first_param == second_param
}

这个名为equals的函数：

接收两个64位无符号整数参数
返回一个布尔值
比较两个参数是否相等

调用方式如下：

fn main() {
    equals(5, 5); // 返回true
    equals(5, 6); // 返回false
}

可变参数的高级用法

在Sway中，函数参数默认是不可变的。如果需要修改传入的参数，需要使用ref mut组合关键字。

基本可变参数示例

fn increment(ref mut num: u32) {
    *num += 1;
}

这个increment函数：

使用ref mut声明可变参数
可以直接修改传入的变量值
需要通过解引用操作符*来访问和修改值

调用示例：

fn main() {
    let mut num = 0;
    increment(num); // num现在变为1
}

注意事项

调用函数时，传入的变量本身必须声明为mut可变
ref和mut必须同时使用，不能单独使用其中一个
这是Sway中唯一可以使用ref关键字的地方

复杂数据类型的可变参数

ref mut同样适用于更复杂的数据类型：

// 元组类型
fn increment_tuple(ref mut t: (u32, u32)) {
    t.0 += 1;
    t.1 += 1;
}

// 枚举类型
enum Color {
    Red: u32,
    Green: u32,
    Blue: u32,
}

fn darken(ref mut color: Color) {
    match color {
        Color::Red(ref mut val) => *val -= 10,
        Color::Green(ref mut val) => *val -= 10,
        Color::Blue(ref mut val) => *val -= 10,
    }
}

调用示例：

fn main() {
    let mut my_tuple = (0, 0);
    increment_tuple(my_tuple); // 变为(1, 1)
    
    let mut my_color = Color::Red(100);
    darken(my_color); // Red值变为90
}