跳到主要内容

WTF Cairo极简教程: 9. 枚举

我最近在学cairo-lang，巩固一下细节，也写一个WTF Cairo极简教程，供小白们使用。教程基于cairo 2.2.0版本。

推特：@0xAA_Science｜@WTFAcademy_

WTF Academy 社群：Discord｜微信群｜官网 wtf.academy

所有代码和教程开源在 github: github.com/WTFAcademy/WTF-Cairo

在本章节中，我们将介绍在Cairo中使用enum（枚举）的方法。

Cairo 中的枚举​

Cairo 中的枚举是一种定义一组命名值（变量）的方法，每个值都有一个关联的数据类型。使用枚举可以提高代码的可读性并减少错误。

使用enum关键字定义枚举，并在其后给出一个首字母大写的名称。

#[derive(Drop, Serde)]
enum Colors { 
    Red: (), 
    Green: (), 
    Blue: (), 
}

与Rust不同，Cairo枚举中的变量具有关联类型。在上面的示例中，Colors枚举中的Red、Green和Blue变量具有单位类型()。在以下示例中，我们定义了一个具有不同变量类型的Actions枚举：

#[derive(Copy, Drop)]
enum Actions { 
    Forward: u128, 
    Backward: u128, 
    Stop: (),
}

创建枚举变量​

您可以使用以下语法创建枚举变量：

let forward = Actions::Forward((1_u128));

在函数中返回枚举​

枚举可以在函数中返回：

// 返回红色
#[external(v0)]
fn get_red(self: @ContractState) -> Colors {
    Colors::Red(())
}

#[external(v0)]
fn create_enum(self: @ContractState) {
    // create enum
    let forward = Actions::Forward((1_u128));
    let red = get_red(self);
}

总结​

在本教程中，我们介绍了如何定义枚举、创建枚举变量以及在函数中返回枚举。这些知识将帮助您在Cairo中创建更具可读性和抗错误性的代码。