Spec-Zone.ru › Scala 2.12 Library

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

класс MapBuilder[A, B, Coll <: GenMap[A, B] with GenMapLike[A, B, Coll]] extends ReusableBuilder[(A, B), Coll]

Канонический билдер для неизменяемых карт, работающий с методом + карты для добавления новых элементов. Коллекции строятся из их empty элемента с использованием этого метода +.

A

Тип ключей для карты, созданной этим билдером.

B

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

Coll

Тип фактической коллекции, создаваемой этим билдером.

Source
MapBuilder.scala
Since

2.8

Линейные супертипы

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

новый MapBuilder(empty: Coll)

empty

Пустой элемент коллекции.

Члены-значения

final def !=(arg0: Any): Boolean

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

возвращает

true если !(this == that), в противном случае false.

Definition Classes
AnyRef → Any

final def ##(): Int

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

возвращает

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

Definition Classes
AnyRef → Any

def +(other: String): String

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

def ++=(xs: TraversableOnce[(A, B)]): MapBuilder.this.type

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

xs

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

возвращает

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

Definition Classes
Growable

def +=(x: (A, B)): MapBuilder.this.type

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

возвращает

сам билдер.

Definition Classes
MapBuilder → Builder → Growable

def +=(elem1: (A, B), elem2: (A, B), elems: (A, B)*): MapBuilder.this.type

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

elem1

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

elem2

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

elems

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

возвращает

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

Definition Classes
Growable

def ->[B](y: B): (MapBuilder[A, B, Coll], B)

Неявный
Этот член добавлен неявным преобразованием из MapBuilder[A, B, Coll] в ArrowAssoc[MapBuilder[A, B, Coll]] с помощью метода 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).

возвращает

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

Definition Classes
AnyRef → Any

final def asInstanceOf[T0]: T0

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

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

возвращает

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

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

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

def clear(): Unit

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

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

Definition Classes
MapBuilder → ReusableBuilder → Builder → Growable → Clearable

def clone(): AnyRef

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

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

returns

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

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

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

var elems: Coll

Attributes
protected

def ensuring(cond: (MapBuilder[A, B, Coll]) ⇒ Boolean, msg: ⇒ Any): MapBuilder[A, B, Coll]

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

def ensuring(cond: (MapBuilder[A, B, Coll]) ⇒ Boolean): MapBuilder[A, B, Coll]

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

def ensuring(cond: Boolean, msg: ⇒ Any): MapBuilder[A, B, Coll]

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

def ensuring(cond: Boolean): MapBuilder[A, B, Coll]

Неявный
Этот член добавлен неявным преобразованием из MapBuilder[A, B, Coll] в Ensuring[MapBuilder[A, B, Coll]] через метод 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).

возвращает

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

Классы-определения
AnyRef

def equals(arg0: Any): Boolean

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

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

возвращает

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

Классы-определения
AnyRef → Any

def finalize(): Unit

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

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

Атрибуты
protected[lang]
Классы-определения
AnyRef
Аннотации
@throws( classOf[java.lang.Throwable] )
Примечание

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

def formatted(fmtstr: String): String

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

Неявный
Этот член добавлен неявным преобразованием из MapBuilder[A, B, Coll] в StringFormat[MapBuilder[A, B, Coll]] посредством метода StringFormat в scala.Predef.
Классы-определения
StringFormat
Аннотации
@inline()

final def getClass(): Class[_]

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

возвращает

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

Классы-определения
AnyRef → Any
Аннотации
@native()

def hashCode(): Int

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

возвращает

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

Классы-определения
AnyRef → Any
Аннотации
@native()

final def isInstanceOf[T0]: Boolean

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

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

возвращает

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

Классы-определения
Any

def mapResult[NewTo](f: (Coll) ⇒ NewTo): Builder[(A, B), NewTo]

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

NewTo

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

f

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

возвращает

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

Классы-определения
Builder
Примечание

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

final def ne(arg0: AnyRef): Boolean

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

возвращает

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

Классы-определения
AnyRef

final def notify(): Unit

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

Классы определений
AnyRef
Аннотации
@native()
Примечание

не указано SLS в качестве члена AnyRef

final def notifyAll(): Unit

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

Классы определений
AnyRef
Аннотации
@native()
Примечание

не указано SLS в качестве члена AnyRef

def result(): Coll

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

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

возвращает

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

Классы определений
MapBuilder → ReusableBuilder → Builder

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

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

coll

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

delta

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

Классы определений
Builder

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

Указывает, что ожидается, что размер этого билдера будет равен размеру заданной коллекции плюс некоторое значение 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 toParArray: ParArray[T]

Неявный
Этот член добавлен неявным преобразованием из MapBuilder[A, B, Coll] в CollectionsHaveToParArray[MapBuilder[A, B, Coll], T] выполняемым методом CollectionsHaveToParArray в scala.collection.parallel. Это преобразование произойдет только в том случае, если неявное значение типа (MapBuilder[A, B, Coll]) ⇒ GenTraversableOnce[T] находится в области видимости.
Классы определений
CollectionsHaveToParArray

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): (MapBuilder[A, B, Coll], B)

Неявный
Этот член добавлен с помощью неявного преобразования из MapBuilder[A, B, Coll] в ArrowAssoc[MapBuilder[A, B, Coll]] выполненное методом 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/MapBuilder.html

Spec-Zone.ru

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