Function array-total-size

Syntax:

Arguments and Values:

array—an array.

Barmar observes that nothing requires the implementation to enforce ARRAY-TOTAL-SIZE-LIMIT. It's a requirement on the user to be prepared to lose if he exceeds it, but it is not a requirement on the implementation to make him lose in that case.size—a non-negative integer.

Description:

17.3.0 9Returns the array total size of the array.

Examples:

 (array-total-size (make-array 4)) → 4
 (array-total-size (make-array 4 :fill-pointer 2)) → 4
 (array-total-size (make-array 0)) → 0
 (array-total-size (make-array '(4 2))) → 8
 (array-total-size (make-array '(4 0))) → 0
 (array-total-size (make-array '())) → 1

Affected By:

None.

Exceptional Situations:

Should signal an error of type type-error if its argument is not an array.

See Also:

make-array, array-dimensions

Notes:

If the array is a vector with a fill pointer, the fill pointer is ignored when calculating the array total size.

Since the product of no arguments is one, the array total size of a zero-dimensional array is one.

 (array-total-size x)
    ≡ (apply #'* (array-dimensions x))
    ≡ (reduce #'* (array-dimensions x))