Трейт scala.collection.mutable.ReusableBuilder

трейт ReusableBuilder[-Elem, +To] extends Builder[Elem, To]

ReusableBuilder — это маркерный трейт, указывающий, что Builder может быть повторно использован для построения более чем одного экземпляра коллекции. В частности, вызов result(), за которым следует clear(), создаст коллекцию и сбросит билдер, чтобы начать построение новой коллекции того же типа.

В общем случае, после result(), не допускается вызов любого метода, кроме clear(). Подклассы должны реализовывать и документировать другие разрешённые последовательности операций (например, вызов других методов после result() для получения различных снимков создаваемой коллекции).

Абстрактные методы

Исходный код

переопределённый def clear(): Unit

Очищает содержимое этого билдера. После выполнения этого метода билдер не будет содержать элементов.

Если выполняется сразу после вызова result(), это позволяет построить новый экземпляр того же типа коллекции.

Исходный код

переопределённый def result(): To

Создаёт коллекцию из добавленных элементов.

После вызова result, поведение всех остальных методов неопределено, за исключением clear(). Если вызвать clear(), билдер сбрасывается и может быть использован для построения другого экземпляра.

Наследованные методы

Исходный код@inline

final def ++=(xs: IterableOnce[Elem]): ReusableBuilder[Elem, To]

Псевдоним для addAll

Исходный код@inline

final def +=(elem: Elem): ReusableBuilder[Elem, To]

Псевдоним для addOne

Исходный код

def addAll(xs: IterableOnce[Elem]): ReusableBuilder[Elem, To]

Добавляет все элементы, сгенерированные IterableOnce, в эту коллекцию.

Исходный код

def addOne(elem: Elem): ReusableBuilder[Elem, To]

Добавляет один элемент в эту нарастающую коллекцию.

Исходный код

def knownSize: Int

Исходный код

def mapResult[NewTo](f: To => NewTo): Builder[Elem, NewTo]

Билдер, полученный из этого билдера, с применением преобразования f к результату.

Исходный код

final def sizeHint(coll: IterableOnce[_], delta: Int): Unit

Подсказка, что ожидается, что размер result этого билдера будет таким же, как у заданной коллекции, плюс некоторое значение delta. Эта подсказка будет использована только если у коллекции известен размер. Некоторые классы билдеров оптимизируют свои представления на основе подсказки. Однако реализации билдеров по-прежнему должны работать правильно, даже если подсказка неверна, т. е. добавлено разное количество элементов.

Исходный код

def sizeHint(size: Int): Unit

Подсказка о том, сколько элементов ожидается добавить при следующем вызове result. Некоторые классы билдеров оптимизируют свои представления на основе подсказки. Однако реализации билдеров по-прежнему должны работать правильно, даже если подсказка неверна, т. е. добавлено разное количество элементов.

Исходный код

final def sizeHintBounded(size: Int, boundingColl: Iterable[_]): Unit

Подсказка о том, сколько элементов ожидается добавить при следующем вызове result, вместе с верхней границей, заданной размером другой коллекции. Некоторые классы билдеров оптимизируют свои представления на основе подсказки. Однако реализации билдеров по-прежнему должны работать правильно, даже если подсказка неверна, т. е. добавлено разное количество элементов.