Return an upper bound on the largest number of elements this list can hold.
Note that the return value of this function does not guarantee that this list can successfully grow that large, or even close to that large without running out of resources.
maximum number of elements this list can hold