ArrayBuilder

scala.collection.mutable.ArrayBuilder
See theArrayBuilder companion object
sealed abstract class ArrayBuilder[T] extends ReusableBuilder[T, Array[T]], Serializable

A builder class for arrays.

Type parameters

T

the type of the elements for the builder.

Attributes

Companion
object
Source
ArrayBuilder.scala
Graph
Supertypes
trait Serializable
trait ReusableBuilder[T, Array[T]]
trait Builder[T, Array[T]]
trait Growable[T]
trait Clearable
class Object
trait Matchable
class Any
Show all
Known subtypes
class ofBoolean
class ofByte
class ofChar
class ofDouble
class ofFloat
class ofInt
class ofLong
class ofRef[T]
class ofShort
class ofUnit
Show all

Members list

Value members

Concrete methods

def addAll(xs: Array[_ <: T]): this.type

Add all elements of an array.

Add all elements of an array.

Attributes

Source
ArrayBuilder.scala
def addAll(xs: Array[_ <: T], offset: Int, length: Int): this.type

Add a slice of an array.

Add a slice of an array.

Attributes

Source
ArrayBuilder.scala
override def addAll(xs: IterableOnce[T]): this.type

Adds all elements produced by an IterableOnce to this growable collection.

Adds all elements produced by an IterableOnce to this growable collection.

Value parameters

elems

the IterableOnce producing the elements to add.

Attributes

Returns

the growable collection itself.

Definition Classes
Source
ArrayBuilder.scala
def clear(): Unit

Clears the contents of this builder.

Clears the contents of this builder. After execution of this method, the builder will contain no elements.

If executed immediately after a call to result(), this allows a new instance of the same type of collection to be built.

Attributes

Source
ArrayBuilder.scala
override def knownSize: Int

Current number of elements.

Current number of elements.

Attributes

Definition Classes
Source
ArrayBuilder.scala
def length: Int

Current number of elements.

Current number of elements.

Attributes

Source
ArrayBuilder.scala
final override def sizeHint(size: Int): Unit

Gives a hint how many elements are expected to be added in total by the time result is called.

Gives a hint how many elements are expected to be added in total by the time result is called.

Some builder classes will optimize their representation based on the hint. However, builder implementations are required to work correctly even if the hint is wrong, e.g., a different number of elements is added, or the hint is out of range.

The default implementation simply ignores the hint.

Value parameters

size

the hint how many elements will be added.

Attributes

Definition Classes
Source
ArrayBuilder.scala

Inherited methods

final def ++=(elems: IterableOnce[T]): Growable.this.type

Alias for addAll

Alias for addAll

Attributes

Inherited from:
Growable
Source
Growable.scala
final def +=(elem: T): Growable.this.type

Alias for addOne

Alias for addOne

Attributes

Inherited from:
Growable
Source
Growable.scala
def mapResult[NewTo](f: Array[T] => NewTo): Builder[T, NewTo]

A builder resulting from this builder my mapping the result using f.

A builder resulting from this builder my mapping the result using f.

Attributes

Inherited from:
Builder
Source
Builder.scala
final def sizeHint(coll: IterableOnce[_], delta: Int): Unit

Gives a hint that the result of this builder is expected to have the same size as the given collection, plus some delta.

Gives a hint that the result of this builder is expected to have the same size as the given collection, plus some delta.

This method provides a hint only if the collection has a known size, as specified by the following pseudocode:

if (coll.knownSize != -1)
  if (coll.knownSize + delta <= 0) sizeHint(0)
  else sizeHint(coll.knownSize + delta)

If the delta is negative and the result size is known to be negative, then the size hint is issued at zero.

Some builder classes will optimize their representation based on the hint. However, builder implementations are required to work correctly even if the hint is wrong, i.e., if 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 (zero if omitted).

Attributes

Inherited from:
Builder
Source
Builder.scala
final def sizeHintBounded(size: Int, boundingColl: Iterable[_]): Unit

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.

Attributes

Inherited from:
Builder
Source
Builder.scala

Inherited and Abstract methods

def addOne(elem: T): Growable.this.type

Adds a single element to this growable collection.

Adds a single element to this growable collection.

Value parameters

elem

the element to add.

Attributes

Returns

the growable collection itself

Inherited from:
Growable
Source
Growable.scala
override def result(): Array[T]

Produces a collection from the added elements.

Produces a collection from the added elements.

After a call to result, the behavior of all other methods is undefined save for clear(). If clear() is called, then the builder is reset and may be used to build another instance.

Attributes

Returns

a collection containing the elements added to this builder.

Definition Classes
Inherited from:
ReusableBuilder
Source
ReusableBuilder.scala

Deprecated and Inherited methods

final def +=(elem1: T, elem2: T, elems: T*): Growable.this.type

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.

Attributes

Returns

the growable collection itself

Deprecated
true
Inherited from:
Growable
Source
Growable.scala