array.reserve [method]

array.reserve( int capacity )

reserves the space for the requested number of elements in the array, returns the array for chaining

• capacity must be larger than or equal to 0
• if previous capacity was less than passed to the method, capacity will be increased to the requested amount
• if previous capacity was more than or equal to what was passed to the method, nothing will change

a = [ 5, 6, 7 ];
a.capacity( 1 ); // nothing happens
a.capacity( 5 ); // a.capacity = 5 and two variable additions can now happen without reallocations