Solidity 入门

基本语法

版本指令

所有Solidity源码都必须指明版本，用于标明Solidity编译器的版本，这是为了避免将来新的编译器破坏代码

pragma solidity ^0.4.20; // 声明版本

// 定义一个合约
contract AntFamily {

}

状态变量

状态变量是定义在合约内部，但是不在函数内部的变量，会永久保存在合约存储空间中，也就说它们会被写入区块链中

pragma solidity ^0.4.20;

contract AntFamily {

  uint dnaDigits = 12;

}

数学运算

在 Solidity 中，数学运算与其它程序设计语言相同:

• 加法: x + y
• 减法: x - y
• 乘法: x * y
• 除法: x / y
• 取模: x % y
• 幂运算：x ** y

// 表示6的2次方
uint a = 6 ** 2;

结构体

通过结构体来定义新的类型，结构体允许生成一个更复杂的数据类型，可以有多个属性

struct Book {
    string name;
    uint page;
}

函数定义

习惯上函数里的变量都是以(_)开头 (不是硬性规定) 以区别全局变量

function buyBook(string _name, uint _count) {

}

数组

如果想建立一个集合，可以使用数组这种数据类型，支持两种数组: 静态数组和动态数组

// 固定长度为3的静态数组:
uint[3] fixedArray;
// 固定长度为5的string类型的静态数组:
string[6] stringArray;
// 动态数组，长度不固定，可以动态添加元素:
uint[] dynamicArray;

也可以建立一个结构体类型的数组:

Book[] books;

状态变量被永久保存在区块链中，所以在合约中创建动态数组来保存结构化的数据是非常有意义的

公共数组:

Book[] public books;

数组和结构体的使用

如下传见了Ant结构体，和Ant类型的数组，定义了ceateAnt函数:

pragma solidity ^0.4.20;

contract AntFamily {

  uint dnaDigits = 12;
  uint dnaModulus = 10 ** dnaDigits;

  struct Ant {
    string name;
    uint dna;
  }

  Ant[] public ants;

  function createAnt(string _name, uint _dna) {
    ants.push(Ant(_name,_dna)); // 创建一个结构体并添加到数组中
  }

}

keccak256散列函数的使用

该函数将一个字符串转换为一个256位的16进制数字

//bc6bb462e38af7da48e0ae7b5cbae860141c04e5af2cf92328cd6548df111fcb
keccak256('xxx');
//3a60bbc72c8477330650d5aae5e7d73f0d15a6efe7e8aab4fa3c33a3a8c3b467
keccak256('xxy');

事件

事件是合约和区块链通讯的一种机制，应用可以“监听”某些事件，并做出反应，使用event关键字来定义事件，使用emit关键字在函数中触发事件

pragma solidity ^0.4.20;

contract AntFamily {

  event NewAnt(uint indexed antId,string name,uint dna);

  uint dnaDigits = 12;
  uint dnaModulus = 10 ** dnaDigits;

  struct Ant {
    string name;
    uint dna;
  }

  Ant[] public ants;

  function createAnt(string _name, uint _dna) {
    uint id = ants.push(Ant(_name, _dna))-1;
    emit NewAnt(id,_name,_dna);
  }

  function createRandomAnt(string _name) {
    uint rand = uint(keccak256(_name));
	uint randDna = rand % dnaModulus;
    createAnt(_name, randDna);
  }

}

复杂组合

pragma solidity ^0.4.20;

contract AntFamily {

  event NewAnt(uint indexed antId, string name, uint dna);

  event NewHouse(uint indexed houseId,string name,uint existGoods,uint maxGoods);

  uint dnaDigits = 12;
  uint dnaModulus = 10 ** dnaDigits;

  struct Ant {
    string name;
    uint dna;
  }

  struct House {
    string name;
    uint existGoods;
    uint maxGoods;
  }

  Ant[] public ants;

  House[] public houses;

  function createAnt(string _name, uint _dna) {
    uint id = ants.push(Ant(_name, _dna)) - 1;
    emit NewAnt(id, _name, _dna);
  }

  function createRandomAnt(string _name) {
    uint rand = uint(keccak256(_name));
		uint randDna = rand % dnaModulus;
    createAnt(_name, randDna);
  }

  function createHouse(string _houseName,uint _existGoods,uint _maxGoods) {
    uint houseId = houses.push(House(_houseName,_existGoods,_maxGoods))-1;
    emit NewHouse(houseId,_houseName,_existGoods,_maxGoods);
  }

}

映射

//可以用来通过userId 存储/查找的用户名
mapping (uint => string) userIdToName;

使用:

pragma solidity ^0.4.20;

contract AntFamily {

  event NewAnt(uint indexed antId, string name, uint dna);
  event NewHouse(uint indexed houseId, string name, uint existGoods, uint maxGoods);

  uint dnaDigits = 12;
  uint dnaModulus = 10 ** dnaDigits;

  struct Ant {
    string name;
    uint dna;
  }

	struct House {
    string name;
    uint existGoods;
    uint maxGoods;
  }

  Ant[] public ants;
	House[] public houses;

  mapping (uint => identity) public antToOwner;
  mapping (identity => uint) ownerAntCount;
  mapping (uint => identity) houseToOwner;

  function createAnt(string _name, uint _dna) {
    uint id = ants.push(Ant(_name, _dna)) - 1;
    antToOwner[id] = msg.sender;
    ownerAntCount[msg.sender]++;

    emit NewAnt(id, _name, _dna);
  }

  function createRandomAnt(string _name) {
    uint rand = uint(keccak256(_name));
		uint randDna = rand % dnaModulus;
    createAnt(_name, randDna);
  }

  function createHouse(string _houseName, uint _existGoods, uint _maxGoods) {
    uint houseId = houses.push(House(_houseName, _existGoods, _maxGoods)) - 1;
    houseToOwner[houseId] = msg.sender;

    emit NewHouse(houseId, _houseName, _existGoods, _maxGoods);
  }

}

require

使得函数在执行过程中，当不满足某些条件时抛出错误，并停止执行

function sayHiToBob(string _name) public returns (string) {
  // 比较 _name 是否等于 "Bob". 如果不成立，抛出异常并终止程序
  require(keccak256(_name) == keccak256("Bob"));
  // 如果返回 true, 运行如下语句
  return "Hi!";
}

这样调用函数 sayHiToBob（“Bob”），它会返回“Hi！”。而如果你调用的时候使用了其他参数，它则会抛出错误并停止执行。 因此，在调用一个函数之前，用 require 验证前置条件是非常有必要的