doc/6.2.constructing-arrays

   1
   2 constructing arrays of objects
   3 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   4
   5   Initialization lists for arrays of objects with constructors,
   6 have an alternative meaning in lwc and they're used to call the
   7 constructor for each element of the array.
   8
   9 For an object 'A' with constructor, the declaration
  10
  11         A x [] = { E1, E2, E3 }
  12
  13 will call:
  14
  15         x[0].ctor (E1);
  16
  17 if E1 is not enclosed in parentheses, or
  18
  19         x[0].ctor E1;
  20
  21 if it is, or
  22
  23         x [0] E1
  24
  25 if E1 starts with a '.'
  26 Same for x[1] and x[2].
  27
  28 If the size of the array is specified, then lwc will call
  29 the ctor with no arguments for the remaining elements. For example in:
  30
  31         A y [10] = { };
  32
  33 lwc will produce:
  34
  35         y[0].ctor();
  36         y[1].ctor();
  37         ...
  38         y[9].ctor();
  39
  40
  41 The feature will be avoided if lwc detects nested braces in the initializer.
  42
  43 An example with all the possible cases:
  44
  45         class A {
  46                 int i, j;
  47                 A ()    { i = j = 0; }
  48                 A (int x)       { i = j = x; }
  49                 A (int x, int y)        { i = x, j = y; }
  50                 void altctor (int x)    { j = -(i = x); }
  51         };
  52
  53         int f ()
  54         {
  55                 A a [7] = {
  56                         1,              //  a[0].ctor (1)
  57                         (1),            //  a[1].ctor (1)
  58                         (1,2),          //  a[2].ctor (1, 2)
  59                         (),             //  a[3].ctor ()
  60                         .altctor (3)    //  a[4].altctor (3)
  61                                         //  a[5].ctor(), a[6].ctor()
  62                 };
  63
  64                 // Not done. Nested braces. Remains as is
  65                 A b [] = { { 1, 2 }, { 3, 4 } };
  66         }
  67
  68 The feature, normally should work for 'new' and 'localloc'. And it is.
  69 The syntax is that the initializer must follow the array brackets. Example:
  70
  71         int f ()
  72         {
  73                 A *p1 = new A [] { 1, 2, 3, altctor (123) };
  74                 A *p2 = localloc A [12] { };
  75                 A *p3 = new A [5] { (1, 2), (3, 4) };
  76         }
  77
  78
  79 *!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!
  80 KNOWN BUG: They are not destructed though !!!!
  81 *!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!*!