ot::Heap::Array::GetCapacity() const method

Returns the current capacity of array (number of elements that can fit in current allocated buffer). The allocated buffer and array capacity are automatically increased (by the `Array` itself) when new elements are added to array. Removing elements does not change the buffer and the capacity. A desired capacity can be reserved using `ReserveCapacity()` method.