A non-displaced array, with array-element-type t
.
If weakp is non- nil
, the array is made weak. If weakp is nil
, the array is made non-weak.
By default, arrays are non-weak, and keep alive all the objects that are stored in them. A weak array may remove a pointer if the object that it points to is not pointed to from somewhere else. When a pointer is removed like this, it is replaced in array with nil
.
Pointers are replaced by nil
after a garbage collector operation that identifies that they can be replaced. This means that if the object that is pointed to has been promoted to a higher generation, a garbage collection (mark and sweep) of the higher generation is required to remove the pointer. Note that by default the system does not automatically call mark-and-sweep
on generation 2 or higher.
The weakness state of an array can be changed many times.
array must not be a displaced array. The array-element-type
of array must be t
.