Clarifying description of the Capacity property in the Array class

[iPhilip]

Clarifies that the Capacity property in the Array class affects the current allocated memory capacity of the array. As is, the documentation does not clearly distinguish the difference between the Length and the Capacity properties. Some users are confusing the two. For example, see this post.

The following code snippet distinguishes the two:

arr := [10, 20, 30]
MsgBox arr.Length    ; 3 — three elements
MsgBox arr.Capacity  ; 3 or more — depends on internal allocation

arr.Capacity := 100  ; pre-allocate for 100 elements (no reallocation needed as you push)
arr.Push(40)
MsgBox arr.Length    ; 4
MsgBox arr.Capacity  ; still 100