add
container.expanding_array.add
Precondition
pre # prevent i32-overflow in capacity safety: (length+1).highest_one_bit < i32.max.highest_one_bit
0.095dev (GIT hash cad6e82a0e3c9c244c113471b376798c2d702f2d)
pre # prevent i32-overflow in capacity safety: (length+1).highest_one_bit < i32.max.highest_one_bit
in case i == length.
expand is not thread-safe.
Complexity: O(1) if no allocation is required, O(length+1) otherwise.
Cumulative complexity of adding an element to an empty `expanding_array`
and repeatedly growing the result `add` by a total of `n` elements is
`O(n)`.
`add` called repeatedly on the same `expanding_array` creates copies
of the underlying array data and hence has performance in `O(length)`.