Spec-Zone.ru › Scala 2.13 Library

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

trait Builder[-A, +To] extends Growable[A]

Базовый трейт для билдеров коллекций.

После вызова result() поведение билдера (который также не является scala.collection.mutable.ReusableBuilder) неопределено. Не следует вызывать дополнительные методы. Для мутабельных коллекций, являющихся собственными не-переиспользуемыми билдерами, result() просто возвращает this.

Self Type
Builder[A, To]
Source
Builder.scala
See also

scala.collection.mutable.ReusableBuilder для билдеров, которые можно переиспользовать после вызова result()

Linear Supertypes
Growable[A], Clearable, AnyRef, Any
Known Subclasses
Map, TrieMap, Builder, VectorBuilder, AbstractMap, AbstractSet, AnyRefMap, AnyRefMapBuilder, ArrayBuilder, ofBoolean, ofByte, ofChar, ofDouble, ofFloat, ofInt, ofLong, ofRef, ofShort, ofUnit, BitSet, CollisionProofHashMap, GrowableBuilder, HashMap, HashSet, ImmutableBuilder, LinkedHashMap, LinkedHashSet, ListBuffer, LongMap, LongMapBuilder, Map, WithDefault, MapOps, MultiMap, PriorityQueue, ReusableBuilder, SeqMap, Set, SetOps, SortedMap, WithDefault, SortedMapOps, SortedSet, SortedSetOps, StringBuilder, TreeMap, TreeSet, UnrolledBuffer, Accumulator, AnyAccumulator, DoubleAccumulator, IntAccumulator, LongAccumulator, SystemProperties, ListMap, OpenHashMap

Абстрактные члены-значения

abstract def addOne(elem: A): Builder.this.type

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

elem

элемент для добавления.

returns

само нарастающее коллекцию

Definition Classes
Growable

abstract def clear(): Unit

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

Definition Classes
Builder → Clearable

abstract def result(): To

Члены-значения конкретного типа

final def !=(arg0: Any): Boolean

Тестирование двух объектов на неравенство.

returns

true если !(this == that), иначе false.

Definition Classes
AnyRef → Any

final def ##(): Int

Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для чисел возвращает значение хэша, согласованное с равенством значений: если два экземпляра типа значения сравниваются как true, то ## вернёт одно и то же значение хэша для каждого из них. Для null возвращает код хэша, где null.hashCode вызывает NullPointerException.

returns

значение хэша, согласованное с ==

Definition Classes
AnyRef → Any

def +(other: String): String

Неявный
Этот член добавлен неявным преобразованием из Builder[A, To] в any2stringadd[Builder[A, To]] выполненным методом any2stringadd в scala.Predef.
Definition Classes
any2stringadd

final def ++=(xs: IterableOnce[A]): Builder.this.type

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

Definition Classes
Growable
Annotations
@inline()

final def +=(elem: A): Builder.this.type

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

Definition Classes
Growable
Annotations
@inline()

def ->[B](y: B): (Builder[A, To], B)

Неявный
Этот член добавлен неявным преобразованием из Builder[A, To] в ArrowAssoc[Builder[A, To]] выполненным методом ArrowAssoc в scala.Predef.
Definition Classes
ArrowAssoc
Annotations
@inline()

final def ==(arg0: Any): Boolean

Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).

returns

true если объект получателя эквивалентен аргументу; false в противном случае.

Definition Classes
AnyRef → Any

def addAll(xs: IterableOnce[A]): Builder.this.type

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

xs

IterableOnce, производящий элементы для добавления.

returns

сам изменяемый набор.

Definition Classes
Growable

final def asInstanceOf[T0]: T0

Приводит объект получателя к типу T0.

Обратите внимание, что успех приведения типа во время выполнения зависит от семантики стирания Scala. Поэтому выражение 1.asInstanceOf[String] выбросит ClassCastException во время выполнения, в то время как выражение List(1).asInstanceOf[List[String]] этого не сделает. В последнем примере, потому что аргумент типа стирается во время компиляции, невозможно проверить, содержатся ли элементы списка в нужном типе.

returns

объект получателя.

Definition Classes
Any
Исключения

ClassCastException если объект получателя не является экземпляром стирания типа T0.

def clone(): AnyRef

Создать копию объекта-получателя.

Реализация метода clone по умолчанию зависит от платформы.

returns

копию объекта-получателя.

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.CloneNotSupportedException]) @native()
Note

not specified by SLS as a member of AnyRef

def ensuring(cond: (Builder[A, To]) => Boolean, msg: => Any): Builder[A, To]

Implicit
Этот член добавляется неявным преобразованием из Builder[A, To] в Ensuring[Builder[A, To]] с помощью метода Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: (Builder[A, To]) => Boolean): Builder[A, To]

Implicit
Этот член добавляется неявным преобразованием из Builder[A, To] в Ensuring[Builder[A, To]] с помощью метода Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean, msg: => Any): Builder[A, To]

Implicit
Этот член добавляется неявным преобразованием из Builder[A, To] в Ensuring[Builder[A, To]] с помощью метода Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean): Builder[A, To]

Implicit
Этот член добавляется неявным преобразованием из Builder[A, To] в Ensuring[Builder[A, To]] с помощью метода Ensuring в scala.Predef.
Definition Classes
Ensuring

final def eq(arg0: AnyRef): Boolean

Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).

Метод eq реализует отношение эквивалентности для не-нулевых экземпляров AnyRef, и обладает тремя дополнительными свойствами:

    Он согласован: для любых не-нулевых экземпляров x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false. Для любого не-нулевого экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращают false. null.eq(null) возвращает true.

При переопределении методов equals или hashCode, важно убедиться, что их поведение согласуется с равенством ссылок. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и должны иметь одинаковое хэш-значение (o1.hashCode == o2.hashCode).

returns

true если аргумент является ссылкой на объект-получатель; false в противном случае.

Definition Classes
AnyRef

def equals(arg0: AnyRef): Boolean

Метод равенства для ссылочных типов. Реализация по умолчанию делегирует в eq.

См. также equals в scala.Any.

returns

true если объект-получатель эквивалентен аргументу; false в противном случае.

Definition Classes
AnyRef → Any

def finalize(): Unit

Вызывается сборщиком мусора для объекта-получателя, когда больше нет ссылок на объект.

Подробности о том, когда и будет ли вызываться метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями зависят от платформы.

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.Throwable])
Примечание

не указано SLS как член AnyRef

def formatted(fmtstr: String): String

Возвращает строку, отформатированную в соответствии с заданной строкой format. Форматные строки аналогичны строкам String.format (@см. java.lang.String.format).

Неявный
Этот член добавляется неявным преобразованием из Builder[A, To] в StringFormat[Builder[A, To]] выполняемым методом StringFormat в scala.Predef.
Definition Classes
StringFormat
Annotations
@inline()

final def getClass(): Class[_ <: AnyRef]

Возвращает представление класса объекта во время выполнения.

returns

объект класса, соответствующий типу получателя во время выполнения.

Definition Classes
AnyRef → Any
Annotations
@native()

def hashCode(): Int

Метод hashCode для ссылочных типов. См. hashCode в scala.Any.

returns

значение кода хеширования для этого объекта.

Definition Classes
AnyRef → Any
Annotations
@native()

final def isInstanceOf[T0]: Boolean

Проверяет, соответствует ли динамический тип объекта-получателя типу T0.

Обратите внимание, что результат теста учитывает семантику стирания Scala. Поэтому выражение 1.isInstanceOf[String] вернёт false, в то время как выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, поскольку аргумент типа стирается во время компиляции, невозможно проверить, содержатся ли элементы списка в указанном типе.

returns

true если объект-получатель является экземпляром стирания типа T0; false в противном случае.

Definition Classes
Any

def knownSize: Int

returns

Количество элементов в собираемой коллекции, если его можно вычислить, иначе -1. По умолчанию всегда возвращает -1.

Definition Classes
Growable

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

final def ne(arg0: AnyRef): Boolean

Эквивалентно !(this eq that).

returns

true если аргумент не является ссылкой на объект-получатель; false в противном случае.

Definition Classes
AnyRef

final def notify(): Unit

Разбуждает один поток, ожидающий монитор объекта-получателя.

Definition Classes
AnyRef
Annotations
@native()
Примечание

не указано SLS как член AnyRef

final def notifyAll(): Unit

Разбуждает все потоки, ожидающие монитор объекта-получателя.

Definition Classes
AnyRef
Annotations
@native()
Примечание

не указано SLS как член AnyRef

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

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

coll

коллекция, которая служит подсказкой для размера результата.

delta

поправка, которая добавляется к coll.size для создания подсказки размера.

def sizeHint(size: Int): Unit

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

size

подсказка о том, сколько элементов будет добавлено.

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

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

size

подсказка о том, сколько элементов будет добавлено.

boundingColl

ограничивающая коллекция. Если это IndexedSeqLike, то размеры, большие, чем размер коллекции, уменьшаются.

final def synchronized[T0](arg0: => T0): T0

Definition Classes
AnyRef

def toString(): String

Создает строковое представление этого объекта. По умолчанию представление зависит от платформы. На платформе Java это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.

returns

строковое представление объекта.

Definition Classes
AnyRef → Any

final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.InterruptedException])

final def wait(arg0: Long, arg1: Int): Unit

Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.InterruptedException])

final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws(classOf[java.lang.InterruptedException]) @native()

© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.13.0/scala/collection/mutable/Builder.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API