函式 修飾器modifier

使用 修飾器modifier 可以輕松改變函式的行為， 例如，它們可以在執行函式之前自動檢查某個條件， 修飾器modifier 是合約的可繼承屬性， 并可能被派生合約覆寫，

pragma solidity ^0.4.11;

contract owned {
    function owned() public { owner = msg.sender; }
    address owner;

    // 這個合約只定義一個修飾器，但并未使用： 它將會在派生合約中用到，
    // 修飾器所修飾的函式體會被插入到特殊符號 _; 的位置，
    // 這意味著如果是 owner 呼叫這個函式，則函式會被執行，否則會拋出例外，
    modifier onlyOwner {
        require(msg.sender == owner);
        _;
    }
}

contract mortal is owned {
    // 這個合約從 `owned` 繼承了 `onlyOwner` 修飾符，并將其應用于 `close` 函式，
    // 只有在合約里保存的 owner 呼叫 `close` 函式，才會生效，
    function close() public onlyOwner {
        selfdestruct(owner);
    }
}

contract priced {
    // 修改器可以接收引數：
    modifier costs(uint price) {
        if (msg.value >= price) {
            _;
        }
    }
}

contract Register is priced, owned {
    mapping (address => bool) registeredAddresses;
    uint price;

    function Register(uint initialPrice) public { price = initialPrice; }

    // 在這里也使用關鍵字 `payable` 非常重要，否則函式會自動拒絕所有發送給它的以太幣，
    function register() public payable costs(price) {
        registeredAddresses[msg.sender] = true;
    }

    function changePrice(uint _price) public onlyOwner {
        price = _price;
    }
}

contract Mutex {
    bool locked;
    modifier noReentrancy() {
        require(!locked);
        locked = true;
        _;
        locked = false;
    }

    // 這個函式受互斥量保護，這意味著 `msg.sender.call` 中的重入呼叫不能再次呼叫  `f`，
    // `return 7` 陳述句指定回傳值為 7，但修改器中的陳述句 `locked = false` 仍會執行，
    function f() public noReentrancy returns (uint) {
        require(msg.sender.call());
        return 7;
    }
}

如果同一個函式有多個 修飾器modifier，它們之間以空格隔開，修飾器modifier 會依次檢查執行，

警告: 在早期的 Solidity 版本中，有 修飾器modifier 的函式，return 陳述句的行為表現不同，

修飾器modifier 或函式體中顯式的 return 陳述句僅僅跳出當前的 修飾器modifier 和函式體， 回傳變數會被賦值，但整個執行邏輯會從前一個 修飾器modifier 中的定義的 “_” 之后繼續執行，

修飾器modifier 的引數可以是任意運算式，在此背景關系中，所有在函式中可見的符號，在 修飾器modifier 中均可見， 在 修飾器modifier 中引入的符號在函式中不可見（可能被多載改變），

reference: https://solidity-cn.readthedocs.io/zh/develop/contracts.html#modifiers

編譯器原始碼:

void ContractCompiler::appendModifierOrFunctionCode()
{
	solAssert(m_currentFunction, "");
	unsigned stackSurplus = 0;
	Block const* codeBlock = nullptr;
	vector<VariableDeclaration const*> addedVariables;

	m_modifierDepth++;

	if (m_modifierDepth >= m_currentFunction->modifiers().size())
	{
		solAssert(m_currentFunction->isImplemented(), "");
		codeBlock = &m_currentFunction->body();
	}
	else
	{
		ASTPointer<ModifierInvocation> const& modifierInvocation = m_currentFunction->modifiers()[m_modifierDepth];

		// constructor call should be excluded
		if (dynamic_cast<ContractDefinition const*>(modifierInvocation->name()->annotation().referencedDeclaration))
			appendModifierOrFunctionCode();
		else
		{
			ModifierDefinition const& modifier = m_context.functionModifier(modifierInvocation->name()->name());
			CompilerContext::LocationSetter locationSetter(m_context, modifier);
			solAssert(modifier.parameters().size() == modifierInvocation->arguments().size(), "");
			for (unsigned i = 0; i < modifier.parameters().size(); ++i)
			{
				m_context.addVariable(*modifier.parameters()[i]);
				addedVariables.push_back(modifier.parameters()[i].get());
				compileExpression(
					*modifierInvocation->arguments()[i],
					modifier.parameters()[i]->annotation().type
				);
			}
			for (VariableDeclaration const* localVariable: modifier.localVariables())
			{
				addedVariables.push_back(localVariable);
				appendStackVariableInitialisation(*localVariable);
			}

			stackSurplus =
				CompilerUtils::sizeOnStack(modifier.parameters()) +
				CompilerUtils::sizeOnStack(modifier.localVariables());
			codeBlock = &modifier.body();
		}
	}

	if (codeBlock)
	{
		m_returnTags.push_back(m_context.newTag());

		codeBlock->accept(*this);

		solAssert(!m_returnTags.empty(), "");
		m_context << m_returnTags.back();
		m_returnTags.pop_back();

		CompilerUtils(m_context).popStackSlots(stackSurplus);
		for (auto var: addedVariables)
			m_context.removeVariable(*var);
	}
	m_modifierDepth--;
}