# 智能合约源文件的基本要素概览(Structure of a Contract)
- 合约类似面向对象语言中的类。
- 支持继承
每个合约中可包含`状态变量(State Variables)`,`函数(Functions)`,`函数修饰符(Function Modifiers)`,`事件(Events)`,`结构类型(Structs Types)`和`枚举类型(Enum Types)`。
[TOC]
## 状态变量(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}
}
```
- Solidity语言
- 入门说明
- Solidity智能合约文件结构
- 智能合约源文件的基本要素概览
- 值类型
- 类型
- 布尔
- 整型
- 地址
- 字节数组
- 小数
- 字符串
- 十六进制字面量
- 枚举
- 函数
- 引用类型
- 引用类型
- 数据位置
- 数组
- 数据结构
- 杂项
- 映射
- 左值运算符
- 类型间的转换
- 类型推断
- 单位
- 货币单位
- 时间单位
- 语言内置特性
- 特殊变量及函数
- 数学和加密函数
- 地址相关
- 进阶
- 入参和出参
- 控制结构
- 函数调用
- 创建合约实例
- 表达式的执行顺序
- 赋值
- 作用范围和声明
- 异常
- 内联汇编
- 合约详解
- 合约
- 可见性或权限控制
- 访问函数
- 函数修改器
- 常状态变量
- 回退函数
- 事件
- 继承
- 接口
- 其它
- 库
- 状态变量的存储模型
- 内存变量的存局
- 调用数据的布局