Builder
Base trait for collection builders.
After calling result()
the behavior of a Builder (which is not also a scala.collection.mutable.ReusableBuilder)
is undefined. No further methods should be called. It is common for mutable collections to be their own non-reusable
Builder, in which case result()
simply returns this
.
- See also:
scala.collection.mutable.ReusableBuilder for Builders which can be reused after calling
result()
- Source:
- Builder.scala
Value members
Abstract methods
Clears the contents of this builder.
Clears the contents of this builder. After execution of this method the builder will contain no elements.
- Source:
- Builder.scala
Result collection consisting of all elements appended so far.
Result collection consisting of all elements appended so far.
- Source:
- Builder.scala
Concrete methods
A builder resulting from this builder my mapping the result using f
.
A builder resulting from this builder my mapping the result using f
.
- Source:
- Builder.scala
Gives a hint how many elements are expected to be added
when the next result
is called.
Gives a hint how many elements are expected to be added
when the next result
is called. Some builder classes
will optimize their representation based on the hint. However,
builder implementations are still required to work correctly even if the hint is
wrong, i.e. a different number of elements is added.
- Value parameters:
- size
the hint how many elements will be added.
- Source:
- Builder.scala
Gives a hint that one expects the result
of this builder
to have the same size as the given collection, plus some delta.
Gives a hint that one expects the result
of this builder
to have the same size as the given collection, plus some delta. This will
provide a hint only if the collection has a known size
Some builder classes
will optimize their representation based on the hint. However,
builder implementations are still required to work correctly even if the hint is
wrong, i.e. a different number of elements is added.
- Value parameters:
- coll
the collection which serves as a hint for the result's size.
- delta
a correction to add to the
coll.size
to produce the size hint.
- Source:
- Builder.scala
Gives a hint how many elements are expected to be added
when the next result
is called, together with an upper bound
given by the size of some other collection.
Gives a hint how many elements are expected to be added
when the next result
is called, together with an upper bound
given by the size of some other collection. Some builder classes
will optimize their representation based on the hint. However,
builder implementations are still required to work correctly even if the hint is
wrong, i.e. a different number of elements is added.
- Value parameters:
- boundingColl
the bounding collection. If it is an IndexedSeqLike, then sizes larger than collection's size are reduced.
- size
the hint how many elements will be added.
- Source:
- Builder.scala
Inherited methods
Adds all elements produced by an IterableOnce to this growable collection.
Adds all elements produced by an IterableOnce to this growable collection.
- Value parameters:
- xs
the IterableOnce producing the elements to add.
- Returns:
the growable collection itself.
- Inherited from:
- Growable
- Source:
- Growable.scala
Adds a single element to this growable collection.
Adds a single element to this growable collection.
- Value parameters:
- elem
the element to add.
- Returns:
the growable collection itself
- Inherited from:
- Growable
- Source:
- Growable.scala
- Returns:
The number of elements in the collection under construction, if it can be cheaply computed, -1 otherwise. The default implementation always returns -1.
- Inherited from:
- Growable
- Source:
- Growable.scala
Deprecated and Inherited methods
Adds two or more elements to this growable collection.
Adds two or more elements to this growable collection.
- Value parameters:
- elem1
the first element to add.
- elem2
the second element to add.
- elems
the remaining elements to add.
- Returns:
the growable collection itself
- Deprecated
- Inherited from:
- Growable
- Source:
- Growable.scala