Spec-Zone.ru › Scala 2.12 Library

Класс scala.collection.mutable.GrowingBuilder

класс GrowingBuilder[Elem, To <: Growable[Elem]] extends Builder[Elem, To]

Канонический билдер для коллекций, которые могут расти, то есть поддерживают эффективное += метод, который добавляет элемент в коллекцию.

GrowableBuilders могут создавать только один экземпляр коллекции, которую они наращивают.

Источник
GrowingBuilder.scala
С

2.8

Линейные надтипы

Конструкторы экземпляров

new GrowingBuilder(empty: 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

Неявный
Этот член добавляется неявным преобразованием из GrowingBuilder[Elem, To] в any2stringadd[GrowingBuilder[Elem, To]] с помощью метода any2stringadd в scala.Predef.
Definition Classes
any2stringadd

def ++=(xs: TraversableOnce[Elem]): GrowingBuilder.this.type

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

xs

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

returns

сама изменяемая коллекция.

Definition Classes
Growable

def +=(x: Elem): GrowingBuilder.this.type

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

returns

сам билдер.

Definition Classes
GrowingBuilder → Builder → Growable

def +=(elem1: Elem, elem2: Elem, elems: Elem*): GrowingBuilder.this.type

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

elem1

первый добавляемый элемент.

elem2

второй добавляемый элемент.

elems

остальные добавляемые элементы.

returns

сама изменяемая коллекция

Definition Classes
Growable

def ->[B](y: B): (GrowingBuilder[Elem, To], B)

Неявный
Этот член добавляется неявным преобразованием из GrowingBuilder[Elem, To] в ArrowAssoc[GrowingBuilder[Elem, 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

final def asInstanceOf[T0]: T0

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

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

returns

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

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

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

def clear(): Unit

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

Definition Classes
GrowingBuilder → Builder → Growable → Clearable

def clone(): AnyRef

Создает копию объекта-приемника.

Значение метода clone зависит от платформы.

returns

копия объекта-приемника.

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

не определен в SLS как член AnyRef

var elems: To

Attributes
protected

def ensuring(cond: (GrowingBuilder[Elem, To]) ⇒ Boolean, msg: ⇒ Any): GrowingBuilder[Elem, To]

Implicit
Этот член добавлен неявным преобразованием из GrowingBuilder[Elem, To] в Ensuring[GrowingBuilder[Elem, To]] выполненным методом Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: (GrowingBuilder[Elem, To]) ⇒ Boolean): GrowingBuilder[Elem, To]

Implicit
Этот член добавлен неявным преобразованием из GrowingBuilder[Elem, To] в Ensuring[GrowingBuilder[Elem, To]] выполненным методом Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean, msg: ⇒ Any): GrowingBuilder[Elem, To]

Implicit
Этот член добавлен неявным преобразованием из GrowingBuilder[Elem, To] в Ensuring[GrowingBuilder[Elem, To]] выполненным методом Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean): GrowingBuilder[Elem, To]

Implicit
Этот член добавлен неявным преобразованием из GrowingBuilder[Elem, To] в Ensuring[GrowingBuilder[Elem, To]] выполненным методом Ensuring в scala.Predef.
Definition Classes
Ensuring

final def eq(arg0: AnyRef): Boolean

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

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

    Он согласован: для любых не-null экземпляров x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false.Для любого не-null экземпляра 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: Any): Boolean

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

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

returns

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

Definition Classes
AnyRef → Any

def finalize(): Unit

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

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

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

не определён в SLS как член AnyRef

def formatted(fmtstr: String): String

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

Implicit
Этот член добавляется неявным преобразованием из GrowingBuilder[Elem, To] в StringFormat[GrowingBuilder[Elem, To]] с помощью метода StringFormat в scala.Predef.
Definition Classes
StringFormat
Annotations
@inline()

final def getClass(): Class[_]

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

returns

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

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 mapResult[NewTo](f: (To) ⇒ NewTo): Builder[Elem, NewTo]

Создаёт новый билдер, применяя функцию преобразования к результатам этого билдера.

NewTo

тип коллекции, возвращаемой результатом f.

f

функция преобразования.

returns

новый билдер, такой же, как текущий, но с применением функции преобразования к результату этого билдера.

Definition Classes
Builder
Note

Исходный билдер больше не должен использоваться после вызова mapResult.

final def ne(arg0: AnyRef): Boolean

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

returns

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

Definition Classes
AnyRef

final def notify(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

не определён в SLS как член AnyRef

final def notifyAll(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

не определён в SLS как член AnyRef

def result(): To

Создаёт коллекцию из добавленных элементов. Это заключительная операция: содержимое билдера после этой операции неопределено, и больше методов вызывать нельзя.

возвращает

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

Определяющие классы
GrowingBuilder → Builder

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

Даёт подсказку о том, что ожидается, что result этого билдера будет иметь тот же размер, что и заданная коллекция, плюс некоторая величина delta. Это будет предоставлено только в том случае, если известно, что коллекция имеет метод size с низкой стоимостью. В настоящее время это предполагается, если и только если коллекция является типа IndexedSeqLike. Некоторые классы билдеров оптимизируют свою структуру на основе подсказки. Тем не менее, реализации билдера по-прежнему должны работать корректно, даже если подсказка неверна, то есть добавлено другое количество элементов.

coll

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

delta

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

Определяющие классы
Builder

def sizeHint(coll: TraversableLike[_, _]): Unit

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

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

coll

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

Определяющие классы
Builder

def sizeHint(size: Int): Unit

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

size

подсказка о количестве элементов, которые будут добавлены.

Определяющие классы
Builder

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

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

size

подсказка о количестве элементов, которые будут добавлены.

boundingColl

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

Определяющие классы
Builder

final def synchronized[T0](arg0: ⇒ T0): T0

Определяющие классы
AnyRef

def toString(): String

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

возвращает

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

Определяющие классы
AnyRef → Any

final def wait(): Unit

Определяющие классы
AnyRef
Аннотации
@throws( ... )

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

Определяющие классы
AnyRef
Аннотации
@throws( ... )

final def wait(arg0: Long): Unit

Определяющие классы
AnyRef
Аннотации
@throws( ... ) @native()

def →[B](y: B): (GrowingBuilder[Elem, To], B)

Неявный
Этот член добавлен неявным преобразованием из GrowingBuilder[Elem, To] в ArrowAssoc[GrowingBuilder[Elem, To]] с помощью метода ArrowAssoc в scala.Predef.
Определяющие классы
ArrowAssoc

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

Spec-Zone.ru

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