# 智能合約源文件的基本要素概覽(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智能合約文件結構
- 智能合約源文件的基本要素概覽
- 值類型
- 類型
- 布爾
- 整型
- 地址
- 字節數組
- 小數
- 字符串
- 十六進制字面量
- 枚舉
- 函數
- 引用類型
- 引用類型
- 數據位置
- 數組
- 數據結構
- 雜項
- 映射
- 左值運算符
- 類型間的轉換
- 類型推斷
- 單位
- 貨幣單位
- 時間單位
- 語言內置特性
- 特殊變量及函數
- 數學和加密函數
- 地址相關
- 進階
- 入參和出參
- 控制結構
- 函數調用
- 創建合約實例
- 表達式的執行順序
- 賦值
- 作用范圍和聲明
- 異常
- 內聯匯編
- 合約詳解
- 合約
- 可見性或權限控制
- 訪問函數
- 函數修改器
- 常狀態變量
- 回退函數
- 事件
- 繼承
- 接口
- 其它
- 庫
- 狀態變量的存儲模型
- 內存變量的存局
- 調用數據的布局