diff options
author | Alex Beregszaszi <alex@rtfs.hu> | 2017-03-16 20:46:26 +0800 |
---|---|---|
committer | GitHub <noreply@github.com> | 2017-03-16 20:46:26 +0800 |
commit | e7e22c703c9fe2a6cd6cbd7c4683ecfc090c657b (patch) | |
tree | 35ea5228bad151da2875326adcc06078afa96489 /docs | |
parent | e34a9600f27f7b48fb2473db6bc45377190301b0 (diff) | |
parent | 18a37ed799e36c1112deb0122fea1b72e17e21e5 (diff) | |
download | dexon-solidity-e7e22c703c9fe2a6cd6cbd7c4683ecfc090c657b.tar.gz dexon-solidity-e7e22c703c9fe2a6cd6cbd7c4683ecfc090c657b.tar.zst dexon-solidity-e7e22c703c9fe2a6cd6cbd7c4683ecfc090c657b.zip |
Merge pull request #1785 from ethereum/docs-address
Document all address methods in the global variables section
Diffstat (limited to 'docs')
-rw-r--r-- | docs/units-and-global-variables.rst | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/docs/units-and-global-variables.rst b/docs/units-and-global-variables.rst index e4f0ea43..7a43343f 100644 --- a/docs/units-and-global-variables.rst +++ b/docs/units-and-global-variables.rst @@ -128,17 +128,23 @@ Address Related ``<address>.balance`` (``uint256``): balance of the :ref:`address` in Wei -``<address>.send(uint256 amount) returns (bool)``: - send given amount of Wei to :ref:`address`, returns ``false`` on failure ``<address>.transfer(uint256 amount)``: send given amount of Wei to :ref:`address`, throws on failure +``<address>.send(uint256 amount) returns (bool)``: + send given amount of Wei to :ref:`address`, returns ``false`` on failure +``<address>.call(...) returns (bool)``: + issue low-level ``CALL``, returns ``false`` on failure +``<address>.callcode(...) returns (bool)``: + issue low-level ``CALLCODE``, returns ``false`` on failure +``<address>.delegatecall(...) returns (bool)``: + issue low-level ``DELEGATECALL``, returns ``false`` on failure For more information, see the section on :ref:`address`. .. warning:: There are some dangers in using ``send``: The transfer fails if the call stack depth is at 1024 (this can always be forced by the caller) and it also fails if the recipient runs out of gas. So in order - to make safe Ether transfers, always check the return value of ``send`` or even better: + to make safe Ether transfers, always check the return value of ``send``, use ``transfer`` or even better: Use a pattern where the recipient withdraws the money. .. index:: this, selfdestruct |