reverse!

Returns a sequence containing the same elements as a source sequence, but in reverse order.  The result-sequence is generally of the same class as the source-sequence.

The source-sequence may be modified by this operation.  The result-sequence may or may not be freshly allocated.  The source-sequence and the result-sequence may or may not be ==.  Programs should never rely on this operation performing a side-effect on an existing sequence, but should instead use the value returned by the function.

The consequences are undefined if the source-sequence is unbounded (circular or infinite).

define variable *x* = list("bim", "bam", "boom")
*x*
  ⇒  #("bim", "bam", "boom")
reverse!(*x*)
  ⇒  #("boom", "bam", "bim")
*x*
  ⇒  {undefined}

Exported from

• Module common-dylan
• Module Dylan

Modifiers

open

Arguments

Values