Трейт ReusableBuilder.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(), билдер сбрасывается и может использоваться для построения другого экземпляра.

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

Исходный код

final def ++=(xs: IterableOnce[Elem]): Growable.this.type

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

Исходный код

final def +=(elem: Elem): Growable.this.type

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

Исходный код

def addAll(xs: IterableOnce[Elem]): Growable.this.type

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

Исходный код

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

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

Исходный код

def knownSize: Int

Исходный код

def mapResult[NewTo](f: To => NewTo): Builder[A, 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 вместе с верхней границей, заданной размером другой коллекции. Некоторые классы билдеров будут оптимизировать своё представление на основе указания. Однако реализации билдеров всё равно должны работать корректно, даже если указание неверно, то есть добавлено другое количество элементов.