From 2a560b798b5f5ece6dfb500a8e03409c62332e41 Mon Sep 17 00:00:00 2001 From: chriseth Date: Mon, 11 Jul 2016 15:04:33 +0200 Subject: Throw if contract creation fails. --- docs/control-structures.rst | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) (limited to 'docs') diff --git a/docs/control-structures.rst b/docs/control-structures.rst index e03d8d6a..6fa04715 100644 --- a/docs/control-structures.rst +++ b/docs/control-structures.rst @@ -106,6 +106,43 @@ of unused parameters (especially return parameters) can be omitted. } } +.. index:: ! new, contracts;creating + +.. _creating-contracts: + +Creating Contracts via new +========================== + +A contract can create a new contract using the ``new`` keyword. The full +code of the contract to be created has to be known and thus recursive +creation-dependencies are now possible. + +:: + + contract D { + uint x; + function D(uint a) { + x = a; + } + } + contract C { + D d = new D(4); // will be executed as part of C's constructor + + function createD(uint arg) { + D newD = new D(arg); + } + + function createAndEndowD(uint arg, uint amount) { + // Send ether along with the creation + D newD = (new D).value(amount)(arg); + } + } + +As seen in the example, it is possible to forward Ether to the creation, +but it is not possible to limit the amount of gas. If the creation fails +(due to out-of-stack, not enough balance or other problems), an exception +is thrown. + Order of Evaluation of Expressions ================================== -- cgit v1.2.3