add-new!

Adds a new element to a sequence, possibly modifying the sequence.

Adds new-element to source-sequence if it is not already an element of source-sequence, as determined by the test function.  If new-element is already a member of source-sequence, then source-sequence is returned unmodified.

If an element is added, add-new! operates just as add! would.

The test function may be non-commutative: it is always called with an element from source-sequence as its first argument and new-element as its second argument.

add-new! (list (3, 4, 5), 1)
  ⇒  #(1, 3, 4, 5)
add-new! (list (3, 4, 5), 4)
  ⇒  #(3, 4, 5)

Exported from

Modifiers

open

Arguments

source-sequenceAn instance of <sequence>.
new-elementAn instance of <object>.
test:An instance of <function>.  The default is ==.

Values

result-sequenceAn instance of <sequence>.
Adds a new element to a sequence, possibly modifying the sequence.
Adds an element to a sequence, possibly modifying the sequence.
The common-dylan module.
Whenever possible, we have tried to keep the Dylan module pristine and unextended, preferring to add our extensions to separate modules or libraries.
The class of collections whose keys are consecutive integers starting from zero.
The class of all Dylan objects.
The class of objects that can be applied to arguments.
Compares two objects for identity.