智能合约源文件的基本要素概览（Structure of a Contract）

优质

小牛编辑

140浏览

2023-12-01

合约类似面向对象语言中的类。
支持继承

每个合约中可包含状态变量(State Variables)，函数(Functions),函数修饰符（Function Modifiers）,事件（Events）,结构类型(Structs Types)和枚举类型(Enum Types)。

状态变量（State Variables）

变量值会永久存储在合约的存储空间


pragma solidity ^0.4.0;

// simple store example
contract simpleStorage{
    uint valueStore; //state variable
}

详情见类型（Types）章节，关于所有支持的类型和变量相关的可见性（Visibility and Accessors）。

函数（Functions）

智能合约中的一个可执行单元。

示例

pragma solidity ^0.4.0;
contract simpleMath{
    //Simple add function,try a divide action?
    function add(uint x, uint y) returns (uint z){
        z = x + y;
    }
}

上述示例展示了一个简单的加法函数。

函数调用可以设置为内部（Internal）的和外部（External）的。同时对于其它合同的不同级别的可见性和访问控制(Visibility and Accessors)。具体的情况详见后面类型中关于函数的章节。

函数修饰符(Function Modifiers)

函数修饰符用于增强语义。详情见函数修饰符相关章节。

事件（Events）

事件是以太坊虚拟机(EVM)日志基础设施提供的一个便利接口。用于获取当前发生的事件。

示例

pragma solidity ^0.4.0;
contract SimpleAuction {
    event aNewHigherBid(address bidder, uint amount);
    
    function  bid(uint bidValue) external {
        aNewHigherBid(msg.sender, msg.value);
    }
}

关于事件如何声明和使用，详见后面事件相关章节。

结构体类型（Structs Types）

自定义的将几个变量组合在一起形成的类型。详见关于结构体相关章节。

示例

pragma solidity ^0.4.0;
contract Company {
    //user defined `Employee` struct type
    //group with serveral variables
    struct employee{
        string name;
        uint age;
        uint salary;
    }
    
    //User defined `manager` struct type
    //group with serveral variables
    struct manager{
        employee employ;
        string title;
    }
}

枚举类型

特殊的自定义类型，类型的所有值可枚举的情况。详情见后续相关章节。

示例

pragma solidity ^0.4.0;
contract Home {
    enum Switch{On,Off}
}