Spec-Zone.ru › Scala 2.13 Library

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

Компаньон объект OpenHashMap

класс OpenHashMap[Ключ, Значение] extends AbstractMap[Ключ, Значение] with MapOps[Ключ, Значение, OpenHashMap, OpenHashMap[Ключ, Значение]] with StrictOptimizedIterableOps[(Ключ, Значение), Iterable, OpenHashMap[Ключ, Значение]] with MapFactoryDefaults[Ключ, Значение, OpenHashMap, Iterable] with DefaultSerializable

Мутабельная хэш-таблица на основе метода открытой адресации. Точная схема не определена, но она должна прилагать разумные усилия для того, чтобы вставка с последовательными хэш-кодами не была чрезмерно замедлена. В частности, сопоставления последовательных ключей-целых чисел должны работать без значительной потери производительности.

Key

тип ключей в этой карте.

Value

тип значений в этой карте.

Annotations
@deprecated
Deprecated

(Since version 2.13.0) Используйте HashMap или одну из специализированных версий (LongMap, AnyRefMap) вместо OpenHashMap

Source
OpenHashMap.scala
Since

2.7

Linear Supertypes
DefaultSerializable, java.io.Serializable, StrictOptimizedIterableOps[(Key, Value), Iterable, OpenHashMap[Key, Value]], AbstractMap[Key, Value], Map[Key, Value], MapOps[Key, Value, [X, Y]OpenHashMap[X, Y], OpenHashMap[Key, Value]], Shrinkable[Key], Builder[(Key, Value), OpenHashMap[Key, Value]], Growable[(Key, Value)], Clearable, Cloneable[OpenHashMap[Key, Value]], java.lang.Cloneable, Iterable[(Key, Value)], collection.AbstractMap[Key, Value], collection.Map[Key, Value], Equals, MapFactoryDefaults[Key, Value, [x, y]OpenHashMap[x, y], [x]Iterable[x]], collection.MapOps[Key, Value, [_, _]OpenHashMap[_, _], OpenHashMap[Key, Value]], PartialFunction[Key, Value], (Key) => Value, collection.AbstractIterable[(Key, Value)], collection.Iterable[(Key, Value)], IterableFactoryDefaults[(Key, Value), [x]Iterable[x]], IterableOps[(Key, Value), [_]Iterable[_], OpenHashMap[Key, Value]], IterableOnceOps[(Key, Value), [_]Iterable[_], OpenHashMap[Key, Value]], IterableOnce[(Key, Value)], AnyRef, Any

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

new OpenHashMap()

new OpenHashMap(initialSize: Int)

initialSize

начальный размер внутренней хэш-таблицы.

Члены типа

trait GenKeySet extends AnyRef

Обобщённый трайт, используемый реализациями набора ключей

Атрибуты
protected
Определяющие классы
MapOps

class KeySet extends AbstractSet[K] with GenKeySet with DefaultSerializable

Реализующий класс набора, возвращаемого методом keySet.

Атрибуты
protected
Определяющие классы
MapOps

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

final def !=(arg0: Any): Boolean

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

returns

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

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

final def ##(): Int

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

returns

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

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

def ++[V2 >: Value](xs: IterableOnce[(Key, V2)]): OpenHashMap[Key, V2]

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

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

final def ++[B >: (Key, Value)](suffix: IterableOnce[B]): Iterable[B]

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

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

final def ++=(xs: IterableOnce[(Key, Value)]): OpenHashMap.this.type

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

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

final def +=(elem: (Key, Value)): OpenHashMap.this.type

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

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

final def --=(xs: IterableOnce[Key]): OpenHashMap.this.type

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

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

def -=(elem1: Key, elem2: Key, elems: Key*): OpenHashMap.this.type

Удаляет два или более элементов из этой изменяемой коллекции.

elem1

первый элемент для удаления.

elem2

второй элемент для удаления.

elems

остальные элементы для удаления.

returns

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

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

final def -=(elem: Key): OpenHashMap.this.type

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

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

def ->[B](y: B): (OpenHashMap[Key, Value], B)

Неявный
Этот член добавлен благодаря неявной конверсии из OpenHashMap[Ключ, Значение] в ArrowAssoc[OpenHashMap[Ключ, Значение]] с помощью метода ArrowAssoc в scala.Predef. Эта конверсия произойдёт только если Значение является подклассом Option[Nothing] (Значение <: Option[Nothing]).
Классы-определения
ArrowAssoc
Аннотации
@inline()

final def ==(arg0: Any): Boolean

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

возвращает

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

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

def addAll(xs: IterableOnce[(Ключ, Значение)]): OpenHashMap.this.type

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

xs

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

возвращает

само изменяемое множество.

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

def addOne(kv: (Ключ, Значение)): OpenHashMap.this.type

Добавляет один элемент в эту открытую хеш-таблицу.

возвращает

сама открытая хеш-таблица

Классы-определения
OpenHashMap → Growable
Аннотации
@deprecatedOverriding("addOne не должен переопределяться для сохранения согласованности с put.", "2.11.0")

def addString(sb: StringBuilder, start: String, sep: String, end: String): StringBuilder

Добавляет все элементы этой карты в строку-строитель, используя начальную, конечную и разделительные строки. Текст начинается со строки start и заканчивается строкой end. Между ними, строковые представления (согласно методу toString) всех элементов этой карты разделены строкой sep.

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
start

начальная строка.

sep

разделительная строка.

end

конечная строка.

возвращает

строковый буфер b, в который были добавлены элементы.

Классы-определения
MapOps → IterableOnceOps

final def addString(b: StringBuilder): StringBuilder

Добавляет все элементы этого набора в строку-строитель. Записанный текст состоит из строковых представлений (согласно методу toString) всех элементов этого набора без разделительной строки.

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> val h = a.addString(b)
h: StringBuilder = 1234
b

строковый буфер, в который добавляются элементы.

возвращает

строковый буфер b, в который были добавлены элементы.

Классы-определения
IterableOnceOps
Аннотации
@inline()

final def addString(b: StringBuilder, sep: String): StringBuilder

Добавляет все элементы этого набора в строку-строитель с использованием разделительной строки. Записанный текст состоит из строковых представлений (согласно методу toString) всех элементов этого набора, разделенных строкой sep.

Пример:

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = new StringBuilder()
b: StringBuilder =

scala> a.addString(b, ", ")
res0: StringBuilder = 1, 2, 3, 4
b

строковый буфер, в который добавляются элементы.

sep

разделительная строка.

возвращает

строковый буфер b, в который были добавлены элементы.

Классы-определения
IterableOnceOps
Аннотации
@inline()

def andThen[C](k: PartialFunction[Значение, C]): PartialFunction[Ключ, C]

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

Обратите внимание, что вызов isDefinedAt на результирующей частичной функции может применить первую частичную функцию и выполнить ее побочное действие. Крайне рекомендуется вызывать applyOrElse вместо isDefinedAt / apply для повышения эффективности.

C

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

k

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

returns

частичная функция с областью определения этой частичной функции, суженной другой частичной функцией, которая отображает аргументы x в k(this(x)).

Definition Classes
PartialFunction

def andThen[C](k: (Value) => C): PartialFunction[Key, C]

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

Если тип функции во время выполнения является PartialFunction, то используется другой метод andThen (обратите внимание на его предостережения).

C

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

k

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

returns

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

Definition Classes
PartialFunction → Function1

def apply(key: Key): Value

Возвращает значение, связанное с заданным ключом. Этот метод вызывает метод default карты, если нет отображения от данного ключа к значению. Если не переопределено, метод default выбрасывает NoSuchElementException.

key

ключ

returns

значение, связанное с данным ключом, или результат метода default карты, если он не существует.

Definition Classes
MapOps → Function1
Annotations
@throws(scala.this.throws.<init>$default$1[NoSuchElementException])

def applyOrElse[K1 <: Key, V1 >: Value](x: K1, default: (K1) => V1): V1

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

Обратите внимание, что выражение pf.applyOrElse(x, default) эквивалентно

if(pf isDefinedAt x) pf(x) else default(x)

за исключением того, что метод applyOrElse может быть реализован более эффективно. Для всех частичных функций-литералов компилятор генерирует реализацию applyOrElse, которая избегает двойной оценки совпадений с шаблонами и условий. Это делает applyOrElse основой для эффективной реализации во многих операциях и сценариях, таких как:

    комбинирование частичных функций в цепочки orElse/andThen не приводит к чрезмерной оценке apply/isDefinedAt lift и unlift не оценивают исходные функции дважды при каждом вызове runWith позволяет эффективно комбинировать частичные функции в императивном стиле с условными действиями

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

x

аргумент функции

default

функция обратного вызова

returns

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

Definition Classes
MapOps → PartialFunction
Since

2.10

final def asInstanceOf[T0]: T0

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

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

returns

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

Definition Classes
Any
Exceptions thrown

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

def canEqual(that: Any): Boolean

Метод, который должен вызываться из каждой хорошо спроектированной функции equals, которая может быть переопределена в подклассе. Смотрите Programming in Scala, Chapter 28 для обсуждения и проектирования.

that

значение, проверяемое на возможность равенства

returns

true, если этот экземпляр может быть равен that, иначе false

Definition Classes
Map → Equals

def className: String

Определяет префикс представления этого объекта в формате toString.

Рекомендуется возвращать имя конкретного типа коллекции, но не подклассы реализации. Например, для ListMap этот метод должен возвращать "ListMap", а не "Map" (супертип) или "Node" (подкласс реализации).

По умолчанию реализация возвращает "Iterable". Она переопределена для основных типов коллекций "Seq", "IndexedSeq", "LinearSeq", "Buffer", "Set", "Map", "SortedSet", "SortedMap" и "View".

returns

строковое представление, которое начинается с результата применения toString к этой итерируемой коллекции. По умолчанию префикс строки — это простое имя класса коллекции — итерируемой коллекции.

Атрибуты
protected[this]
Определяющие классы
Iterable

def clear(): Unit

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

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

def clone(): OpenHashMap[Key, Value]

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

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

returns

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

Определяющие классы
OpenHashMap → MapOps → Cloneable → AnyRef
Примечание

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

final def coll: OpenHashMap.this.type

returns

Эту коллекцию как C.

Атрибуты
protected
Определяющие классы
Iterable → IterableOps

def collect[B](pf: PartialFunction[(Key, Value), B]): Iterable[B]

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

B

тип элементов возвращаемой итерируемой коллекции.

pf

частичная функция, которая фильтрует и отображает итерируемую коллекцию.

returns

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

Определяющие классы
StrictOptimizedIterableOps → IterableOps → IterableOnceOps
Примечание

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

def collect[K2, V2](pf: PartialFunction[(Key, Value), (K2, V2)]): OpenHashMap[K2, V2]

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

K2

тип ключа возвращаемой карты.

V2

тип значения возвращаемой карты.

pf

частичная функция, которая фильтрует и отображает карту.

returns

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

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

def collectFirst[B](pf: PartialFunction[(Key, Value), B]): Option[B]

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

Примечание: может не завершаться для коллекций бесконечного размера.

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

pf

частичная функция

returns

значение Option, содержащее результат применения pf к первому значению, для которого оно определено, или None если такого значения нет.

Определяющие классы
IterableOnceOps
Пример:

    Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)

def compose[R](k: PartialFunction[R, Key]): PartialFunction[R, Value]

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

Обратите внимание, что вызов isDefinedAt для результирующей частичной функции может применить первую частичную функцию и выполнить её побочное действие. Сильно рекомендуется вызывать applyOrElse вместо isDefinedAt / apply для повышения эффективности.

R

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

k

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

returns

частичная функция с областью определения другой частичной функции, суженной этой частичной функцией, которая отображает аргументы x в this(k(x)).

Definition Classes
PartialFunction

def compose[A](g: (A) => Key): (A) => Value

Соединяет две экземпляры Function1 в новую Function1, применяя эту функцию последней.

A

тип, к которому можно применить функцию g

g

функция A => T1

returns

новая функция f такая, что f(x) == apply(g(x))

Definition Classes
Function1
Annotations
@unspecialized()

def concat[V2 >: Value](suffix: IterableOnce[(Key, V2)]): OpenHashMap[Key, V2]

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

suffix

перечисляемый для добавления.

returns

новая карта, которая содержит все элементы этой карты, за которыми следуют все элементы suffix.

Definition Classes
MapOps

def concat[B >: (Key, Value)](suffix: IterableOnce[B]): Iterable[B]

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

B

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

suffix

перечисляемый для добавления.

returns

новая итерируемая коллекция, которая содержит все элементы этой итерируемой коллекции, за которыми следуют все элементы suffix.

Definition Classes
IterableOps

def contains(key: Key): Boolean

Проверяет, содержит ли эта карта привязку для ключа.

key

ключ

returns

true если для key есть привязка в этой карте, false в противном случае.

Definition Classes
MapOps

def copyToArray[B >: (Key, Value)](xs: Array[B], start: Int, len: Int): Int

Копирует элементы в массив, возвращая количество скопированных элементов.

Заполняет заданный массив xs начиная с индекса start не более чем len элементами этой коллекции.

Копирование прекращается, когда скопированы все элементы этой коллекции, достигнут конец массива или len элементов.

B

тип элементов массива.

xs

массив для заполнения.

start

начальный индекс xs.

len

максимальное количество копируемых элементов.

returns

количество элементов, записанных в массив

Definition Classes
IterableOnceOps
Note

Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует утилизировать. Использование итератора после вызова является неопределённым и может быть изменено. Примечание: не будет завершаться для коллекций бесконечного размера.

def copyToArray[B >: (Key, Value)](xs: Array[B], start: Int): Int

Копирование элементов в массив, возвращая количество скопированных элементов.

Заполняет предоставленный массив xs начиная с индекса start значениями из этого набора.

Копирование завершится, когда будут скопированы все элементы этого набора или будет достигнут конец массива.

B

тип элементов массива.

xs

массив для заполнения.

start

начальный индекс массива xs.

returns

количество элементов, записанных в массив. Примечание: для наборов бесконечного размера копирование не завершится.

Definition Classes
IterableOnceOps

def copyToArray[B >: (Key, Value)](xs: Array[B]): Int

Копирование элементов в массив, возвращая количество скопированных элементов.

Заполняет предоставленный массив xs начиная с индекса start значениями из этого набора.

Копирование завершится, когда будут скопированы все элементы этого набора или будет достигнут конец массива.

B

тип элементов массива.

xs

массив для заполнения.

returns

количество элементов, записанных в массив. Примечание: для наборов бесконечного размера копирование не завершится.

Definition Classes
IterableOnceOps

def corresponds[B](that: IterableOnce[B])(p: ((Key, Value), B) => Boolean): Boolean

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

B

тип элементов that

that

другой набор

p

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

returns

true, если оба набора имеют одинаковую длину, и p(x, y) является true для всех соответствующих элементов x этого итератора и y that, иначе false

Definition Classes
IterableOnceOps

def count(p: ((Key, Value)) => Boolean): Int

Подсчитывает количество элементов в наборе, удовлетворяющих предикату.

p

предикат для проверки элементов.

returns

количество элементов, удовлетворяющих предикату p.

Definition Classes
IterableOnceOps

def default(key: Key): Value

Определяет вычисление значения по умолчанию для карты, возвращаемое при отсутствии ключа. Реализованный здесь метод вызывает исключение, но может быть переопределён в подклассах.

key

указанное значение ключа, для которого отсутствует привязка.

Definition Classes
MapOps
Annotations
@throws(scala.this.throws.<init>$default$1[NoSuchElementException])
Exceptions thrown

def drop(n: Int): OpenHashMap[Key, Value]

Выбирает все элементы, кроме первых n.

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

n

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

returns

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

Definition Classes
IterableOps → IterableOnceOps
Note

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

def dropRight(n: Int): OpenHashMap[Key, Value]

Остальная часть набора без n последних элементов. Для линейных неизменяемых наборов это должно избегать копирования.

Примечание: Даже при применении к представлению или ленивому набору он всегда будет принуждать элементы.

n

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

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps

def dropWhile(p: ((Key, Value)) => Boolean): OpenHashMap[Key, Value]

Удаляет самый длинный префикс элементов, удовлетворяющих предикату.

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

p

Предикат, используемый для проверки элементов.

returns

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

Definition Classes
IterableOps → IterableOnceOps
Note

Переиспользование: После вызова этого метода необходимо отказаться от итератора, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.

def elementWise: ElementWiseExtractor[Key, Value]

Возвращает объект-экстрактор с методом unapplySeq, который извлекает каждый элемент данных последовательности.

Definition Classes
PartialFunction
Пример:
    val firstChar: String => Option[Char] = _.headOption
    
    Seq("foo", "bar", "baz") match {
      case firstChar.unlift.elementWise(c0, c1, c2) =>
        println(s"$c0, $c1, $c2") // Output: f, b, b
    }

def empty: OpenHashMap[Key, Value]

Пустая итерируемая коллекция того же типа, что и этот итерируемый набор.

returns

пустой итерируемый набор типа C.

Definition Classes
MapFactoryDefaults → IterableOps

def ensuring(cond: (OpenHashMap[Key, Value]) => Boolean, msg: => Any): OpenHashMap[Key, Value]

Неявный
Этот член добавлен с помощью неявного преобразования из OpenHashMap[Key, Value] в Ensuring[OpenHashMap[Key, Value]] с помощью метода Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: (OpenHashMap[Key, Value]) => Boolean): OpenHashMap[Key, Value]

Неявный
Этот член добавлен с помощью неявного преобразования из OpenHashMap[Key, Value] в Ensuring[OpenHashMap[Key, Value]] с помощью метода Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean, msg: => Any): OpenHashMap[Key, Value]

Неявный
Этот член добавлен с помощью неявного преобразования из OpenHashMap[Key, Value] в Ensuring[OpenHashMap[Key, Value]] с помощью метода Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: Boolean): OpenHashMap[Key, Value]

Неявный
Этот член добавлен неявным преобразованием из OpenHashMap[Ключ, Значение] вEnsuring[OpenHashMap[Ключ, Значение]] выполненным методом Ensuring в scala.Predef.
Определяющие классы
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(o: Any): Boolean

Универсальный метод равенства, определенный в AnyRef.

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

def exists(p: ((Ключ, Значение)) => Boolean): Boolean

Проверяет, выполняется ли предикат хотя бы для одного элемента этого набора.

Примечание: может не завершиться для наборов бесконечного размера.

p

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

возвращает

true если заданный предикат p выполняется хотя бы для одного элемента этого набора, в противном случае false

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

def filter(pred: ((Ключ, Значение)) => Boolean): OpenHashMap[Ключ, Значение]

Отбирает все элементы этого итерируемого набора, удовлетворяющие предикату.

возвращает

новый итератор, содержащий все элементы этого итерируемого набора, удовлетворяющие заданному предикату p. Порядок элементов сохраняется.

Определяющие классы
StrictOptimizedIterableOps → IterableOps → IterableOnceOps

def filterImpl(pred: ((Ключ, Значение)) => Boolean, isFlipped: Boolean): OpenHashMap[Ключ, Значение]

Атрибуты
protected[scala.collection]
Определяющие классы
StrictOptimizedIterableOps

def filterInPlace(f: (Ключ, Значение) => Boolean): OpenHashMap.this.type

Сохраняет только те отображения, для которых предикат p возвращает true.

Определяющие классы
OpenHashMap → MapOps

def filterNot(pred: ((Ключ, Значение)) => Boolean): OpenHashMap[Ключ, Значение]

Отбирает все элементы этого итерируемого набора, которые не удовлетворяют предикату.

pred

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

возвращает

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

Определяющие классы
StrictOptimizedIterableOps → IterableOps → IterableOnceOps

def finalize(): Unit

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

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

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

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

def find(p: ((Key, Value)) => Boolean): Option[(Key, Value)]

Находит первый элемент в коллекции, удовлетворяющий предикату, если таковой имеется.

Примечание: может не завершиться для коллекций бесконечного размера.

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

p

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

возвращает

значение типа Option, содержащее первый элемент в коллекции, удовлетворяющий p, или None , если такого элемента не существует.

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

def flatMap[B](f: ((Key, Value)) => IterableOnce[B]): Iterable[B]

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

Например:

def getWords(lines: Seq[String]): Seq[String] = lines flatMap (line => line split "\\W+")

Тип результирующей коллекции определяется статическим типом исходной коллекции. Иногда это может приводить к неожиданным результатам. Например:

// lettersOf will return a Seq[Char] of likely repeated letters, instead of a Set
def lettersOf(words: Seq[String]) = words flatMap (word => word.toSet)

// lettersOf will return a Set[Char], not a Seq
def lettersOf(words: Seq[String]) = words.toSet flatMap ((word: String) => word.toSeq)

// xs will be an Iterable[Int]
val xs = Map("a" -> List(11,111), "b" -> List(22,222)).flatMap(_._2)

// ys will be a Map[Int, Int]
val ys = Map("a" -> List(1 -> 11,1 -> 111), "b" -> List(2 -> 22,2 -> 222)).flatMap(_._2)
B

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

f

функция, применяемая к каждому элементу.

возвращает

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

Определяющие классы
StrictOptimizedIterableOps → IterableOps → IterableOnceOps
Примечание

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

def flatMap[K2, V2](f: ((Key, Value)) => IterableOnce[(K2, V2)]): OpenHashMap[K2, V2]

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

f

функция, применяемая к каждому элементу.

возвращает

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

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

def flatten[B](implicit toIterableOnce: ((Key, Value)) => IterableOnce[B]): Iterable[B]

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

Тип результирующей коллекции определяется типом исходной коллекции. Например:

val xs = List(
           Set(1, 2, 3),
           Set(1, 2, 3)
         ).flatten
// xs == List(1, 2, 3, 1, 2, 3)

val ys = Set(
           List(1, 2, 3),
           List(3, 2, 1)
         ).flatten
// ys == Set(1, 2, 3)
B

тип элементов каждой итерируемой коллекции.

возвращает

новую коллекцию, полученную путём конкатенации всех итерируемых коллекций элементов.

Определяющие классы
StrictOptimizedIterableOps → IterableOps → IterableOnceOps
Примечание

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

def fold[A1 >: (Key, Value)](z: A1)(op: (A1, A1) => A1): A1

Складывает элементы этой коллекции, используя указанный ассоциативный бинарный оператор. По умолчанию в IterableOnce реализация эквивалентна foldLeft, но может быть переопределена для более эффективных порядков обхода.

Порядок выполнения операций над элементами не определен и может быть не детерминированным.

Примечание: не будет завершаться для коллекций бесконечного размера.

A1

тип параметр для бинарного оператора, супертип A.

z

нейтральный элемент для операции сложения; может быть добавлен к результату произвольное число раз, и не должен изменять результат (например, Nil для конкатенации списков, 0 для сложения или 1 для умножения).

op

бинарный оператор, который должен быть ассоциативным.

returns

результат применения оператора сложения op между всеми элементами и z, или z если эта коллекция пуста.

Definition Classes
IterableOnceOps

def foldLeft[B](z: B)(op: (B, (Key, Value)) => B): B

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

Примечание: не будет завершаться для коллекций бесконечного размера.

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

B

тип результата бинарного оператора.

z

начальное значение.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этой коллекции, слева направо, с начальным значением z слева:

op(...op(z, x_1), x_2, ..., x_n)

где x1, ..., xn - элементы этой коллекции. Возвращает z если эта коллекция пуста.

Definition Classes
IterableOnceOps

def foldRight[B](z: B)(op: ((Key, Value), B) => B): B

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

Примечание: не будет завершаться для коллекций бесконечного размера.

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

B

тип результата бинарного оператора.

z

начальное значение.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этой коллекции, справа налево, с начальным значением z справа:

op(x_1, op(x_2, ... op(x_n, z)...))

где x1, ..., xn - элементы этой коллекции. Возвращает z если эта коллекция пуста.

Definition Classes
IterableOnceOps

def forall(p: ((Key, Value)) => Boolean): Boolean

Проверяет, выполняется ли предикат для всех элементов этой коллекции.

Примечание: может не завершиться для коллекций бесконечного размера.

p

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

returns

true если эта коллекция пуста или заданный предикат p выполняется для всех элементов этой коллекции, иначе false.

Definition Classes
IterableOnceOps

def foreach[U](f: ((Key, Value)) => U): Unit

Перебирает пары ключ-значение этой карты.

Поведение изменения карты во время итерации таково:

    Удаление сопоставления всегда разрешено.Изменение значения уже имеющегося сопоставления разрешено.В любом другом случае это не разрешено. Обычно, но не всегда, это вызывает исключение.
U

Тип возвращаемого значения указанной функции f, результат которой игнорируется.

f

Функция, применяемая к каждой паре ключ-значение.

Definition Classes
OpenHashMap → IterableOnceOps

def foreachEntry[U](f: (Key, Value) => U): Unit

Применить f к каждой паре ключ/значение для побочных эффектов. Примечание: параметр [U] необходим для помощи в выводе типов scalac.

Definition Classes
OpenHashMap → MapOps

def formatted(fmtstr: String): String

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

Неявный
Этот член добавлен неявным преобразованием из OpenHashMap[Ключ, Значение] в StringFormat[OpenHashMap[Ключ, Значение]], выполненное методом StringFormat в scala.Predef.
Определяющие классы
StringFormat
Аннотации
@inline()

def fromSpecific(coll: IterableOnce[(Ключ, Значение)]): OpenHashMap[Ключ, Значение]

Определяет, как преобразовать заданный Iterable[A] в коллекцию типа C.

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

Атрибуты
protected
Определяющие классы
MapFactoryDefaults → IterableOps
Примечание

При реализации пользовательского типа коллекции и уточнении C до нового типа, этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В общем случае, где C =:= CC[A], это можно сделать, смешав в себе IterableFactoryDefaults trait, который реализует метод с использованием iterableFactory.

,

Как свидетельствует аннотация @uncheckedVariance, использование этого метода может быть некорректным. Однако, до тех пор, пока он вызывается с Iterable[A], полученным от коллекции this (как это происходит в реализациях операций, где мы используем View[A] ), он безопасен.

def get(key: Ключ): Option[Значение]

Возвращает значение, связанное с ключом.

key

значение ключа

returns

объект Option, содержащий значение, связанное с key в этой карте, или None если такого значения не существует.

Определяющие классы
OpenHashMap → MapOps

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

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

returns

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

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

def getOrElse[V1 >: Значение](key: Ключ, default: => V1): V1

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

V1

тип результата вычисления значения по умолчанию.

key

ключ.

default

вычисление, возвращающее значение по умолчанию в случае, если для key нет привязки в карте.

returns

значение, связанное с key , если оно существует, в противном случае результат вычисления default.

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

def getOrElseUpdate(key: Ключ, op: => Значение): Значение

Если заданный ключ уже есть в этой карте, возвращает соответствующее значение.

В противном случае вычисляет значение из заданного выражения op, сохраняет его с ключом в карте и возвращает это значение.

Реализации конкурирующих карт могут оценивать выражение op несколько раз или оценивать op без вставки результата.

key

ключ для проверки

op

вычисление, возвращающее значение для сопоставления с key, если key ранее не был связан.

returns

значение, связанное с ключом (либо ранее, либо в результате выполнения метода).

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

def groupBy[K](f: ((Ключ, Значение)) => K): immutable.Map[K, OpenHashMap[Ключ, Значение]]

Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с некоторой функцией-дискриминатором.

Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно форсировать элементы.

K

тип ключей, возвращаемых функцией-дискриминатором.

f

функция-дискриминатор.

returns

Карта от ключей к итерируемым коллекциям, в которой выполняется следующее инвариантное условие:

(xs groupBy f)(k) = xs filter (x => f(x) == k)

То есть, каждый ключ k сопоставляется с итерируемой коллекцией тех элементов x , для которых f(x) равно k.

Definition Classes
IterableOps

def groupMap[K, B](key: ((Key, Value)) => K)(f: ((Key, Value)) => B): immutable.Map[K, Iterable[B]]

Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с функцией-дискриминатором key. Каждый элемент в группе преобразуется в значение типа B с помощью функции value.

Эквивалентно groupBy(key).mapValues(_.map(f)), но более эффективно.

case class User(name: String, age: Int)

def namesByAge(users: Seq[User]): Map[Int, Seq[String]] =
  users.groupMap(_.age)(_.name)

Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно форсировать элементы.

K

тип ключей, возвращаемых функцией-дискриминатором

B

тип значений, возвращаемых функцией преобразования

key

функция-дискриминатор

f

функция преобразования элементов

Definition Classes
IterableOps

def groupMapReduce[K, B](key: ((Key, Value)) => K)(f: ((Key, Value)) => B)(reduce: (B, B) => B): immutable.Map[K, B]

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

Эквивалентно groupBy(key).mapValues(_.map(f).reduce(reduce)), но более эффективно.

def occurrences[A](as: Seq[A]): Map[A, Int] =
  as.groupMapReduce(identity)(_ => 1)(_ + _)

Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно форсировать элементы.

Definition Classes
IterableOps

def grouped(size: Int): Iterator[OpenHashMap[Key, Value]]

Разделяет элементы на итерируемые коллекции фиксированного размера.

size

количество элементов в группе

returns

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

Definition Classes
IterableOps
See also

scala.collection.Iterator, метод grouped

def hashCode(): Int

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

returns

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

Definition Classes
Map → AnyRef → Any

def hashOf(key: Key): Int

Возвращает закодированный хэш-код предоставленного ключа.

Attributes
protected

def head: (Key, Value)

Выбирает первый элемент этой итерируемой коллекции.

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

returns

первый элемент этой итерируемой коллекции.

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

NoSuchElementException, если итерируемая коллекция пустая.

def headOption: Option[(Key, Value)]

Необязательно выбирает первый элемент.

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

returns

первый элемент этой итерируемой коллекции, если она непустая, None если она пустая.

Definition Classes
IterableOps

def init: OpenHashMap[Key, Value]

Начальная часть коллекции без её последнего элемента.

Примечание: Даже при применении к представлению или ленивой коллекции она всегда заставляет элементы.

Definition Classes
IterableOps

def inits: Iterator[OpenHashMap[Key, Value]]

Итерирует по начальным частям этой итерируемой коллекции. Первое значение будет этой итерируемой коллекцией, а последнее — пустой итерируемой коллекцией, а промежуточные значения — результатами последовательных применений init.

Примечание: Даже при применении к представлению или ленивой коллекции она всегда заставляет элементы.

returns

итератор по всем начальным частям этой итерируемой коллекции

Definition Classes
IterableOps
Пример:

    List(1,2,3).inits = Iterator(List(1,2,3), List(1,2), List(1), Nil)

def isDefinedAt(key: Key): Boolean

Проверяет, содержит ли эта карта привязку для ключа. Этот метод, который реализует абстрактный метод трейта PartialFunction, эквивалентен contains.

key

ключ

returns

true если для key есть привязка в этой карте, false в противном случае.

Definition Classes
MapOps → PartialFunction

def isEmpty: Boolean

Проверяет, пуста ли открытая хеш-таблица.

Примечание: Реализации в подклассах, которые не являются многократно проходными, должны позаботиться о том, чтобы не потреблять элементы, когда isEmpty вызывается.

returns

true если открытая хеш-таблица не содержит элементов, false в противном случае.

Definition Classes
OpenHashMap → IterableOnceOps

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 isTraversableAgain: Boolean

Проверяет, можно ли многократно пройти по этой итерируемой коллекции. Всегда истинно для Iterables и ложно для Iterators, если не переопределено.

returns

true если это многократно проходная, false в противном случае.

Definition Classes
IterableOps → IterableOnceOps

def iterableFactory: IterableFactory[Iterable]

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

Definition Classes
Iterable → Iterable → IterableOps
Note

При реализации пользовательского типа коллекции и уточнении CC до нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (в противном случае компилятор выдаст ошибку).

def iterator: Iterator[(Key, Value)]

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

returns

итератор

Definition Classes
OpenHashMap → IterableOnce

def keySet: collection.Set[Key]

Собирает все ключи этой карты в множество.

returns

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

Definition Classes
MapOps

def keyStepper[S <: Stepper[_]](implicit shape: StepperShape[Key, S]): S

Возвращает Stepper для ключей этой карты. См. метод stepper.

Definition Classes
MapOps

def keys: collection.Iterable[Key]

Собирает все ключи этой карты в итерируемой коллекции.

returns

ключи этой карты в виде итерируемого объекта.

Definition Classes
MapOps

def keysIterator: Iterator[Key]

Создаёт итератор для всех ключей.

returns

итератор по всем ключам.

Definition Classes
OpenHashMap → MapOps

def knownSize: Int

returns

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

Definition Classes
OpenHashMap → MapOps → Growable → IterableOnce

def last: (Key, Value)

Выбирает последний элемент.

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

returns

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

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

NoSuchElementException Если итерируемая коллекция пуста.

def lastOption: Option[(Key, Value)]

Возвращает опциональный последний элемент.

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

returns

последний элемент этой итерируемой коллекции, если она непустая; None в противном случае.

Definition Classes
IterableOps

def lazyZip[B](that: collection.Iterable[B]): LazyZip2[(Key, Value), B, OpenHashMap.this.type]

Аналогично zip, но элементы в каждой коллекции не потребляются до тех пор, пока не будет выполнено строгое действие над возвращённым LazyZip2 декоратором.

Вызовы lazyZip могут быть объединены для поддержки более высокого арности (до 4) без расходов на создание и деструкцию промежуточных кортежей.

val xs = List(1, 2, 3)
val res = (xs lazyZip xs lazyZip xs lazyZip xs).map((a, b, c, d) => a + b + c + d)
// res == List(4, 8, 12)
B

тип второго элемента в каждой паре

that

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

returns

декоратор LazyZip2, позволяющий выполнять строгие операции над лениво вычисляемыми парами или объединять вызовы lazyZip. Также поддерживается неявное преобразование в Iterable[(A, B)].

Definition Classes
Iterable

def lift: (Key) => Option[Value]

Преобразует эту частичную функцию в обычную функцию, возвращающую Option результат.

returns

функцию, которая принимает аргумент x и возвращает Some(this(x)), если this определена для x, и None в противном случае.

Definition Classes
PartialFunction
См. также

Function.unlift

def map[B](f: ((Key, Value)) => B): Iterable[B]

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

B

тип элементов возвращаемой итерируемой коллекции.

f

функция, применяемая к каждому элементу.

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps → IterableOnceOps
Примечание

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

def map[K2, V2](f: ((Key, Value)) => (K2, V2)): OpenHashMap[K2, V2]

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

f

функция, применяемая к каждому элементу.

returns

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

Definition Classes
MapOps

def mapFactory: MapFactory[OpenHashMap]

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

Определяющие классы
OpenHashMap → Map → Map → MapOps
Примечание

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

final def mapFromIterable[K2, V2](it: collection.Iterable[(K2, V2)]): OpenHashMap[K2, V2]

Аналогично fromIterable, но возвращает тип коллекции Map. Обратите внимание, что тип возвращаемого значения теперь CC[K2, V2].

Атрибуты
protected
Определяющие классы
MapOps
Аннотации
@inline()

def mapResult[NewTo](f: (OpenHashMap[Key, Value]) => NewTo): Builder[(Key, Value), NewTo]

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

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

def mapValuesInPlace(f: (Key, Value) => Value): OpenHashMap.this.type

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

f

преобразование для применения

возвращает

само отображение.

Определяющие классы
OpenHashMap → MapOps

def max[B >: (Key, Value)](implicit ord: math.Ordering[B]): (Key, Value)

Находит наибольший элемент.

B

Тип, для которого определен порядок.

ord

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

возвращает

наибольший элемент этой коллекции относительно порядка ord.

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

UnsupportedOperationException если эта коллекция пуста.

def maxBy[B](f: ((Key, Value)) => B)(implicit cmp: math.Ordering[B]): (Key, Value)

Находит первый элемент, который дает наибольшее значение, измеренное функцией f.

B

Тип результата функции f.

f

Измерительная функция.

cmp

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

возвращает

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

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

UnsupportedOperationException если эта коллекция пуста.

def maxByOption[B](f: ((Key, Value)) => B)(implicit cmp: math.Ordering[B]): Option[(Key, Value)]

Находит первый элемент, который дает наибольшее значение, измеренное функцией f.

B

Тип результата функции f.

f

Измерительная функция.

cmp

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

возвращает

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

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

def maxOption[B >: (Key, Value)](implicit ord: math.Ordering[B]): Option[(Key, Value)]

Находит наибольший элемент.

B

Тип, для которого определен порядок.

ord

Порядок, используемый для сравнения элементов.

returns

необязательное значение, содержащее наибольший элемент этой коллекции относительно порядка ord.

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

def min[B >: (Key, Value)](implicit ord: math.Ordering[B]): (Key, Value)

Находит наименьший элемент.

B

Тип, для которого определен порядок.

ord

Порядок, используемый для сравнения элементов.

returns

наименьший элемент этой коллекции относительно порядка ord.

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

UnsupportedOperationException если эта коллекция пуста.

def minBy[B](f: ((Key, Value)) => B)(implicit cmp: math.Ordering[B]): (Key, Value)

Находит первый элемент, который дает наименьшее значение, измеренное функцией f.

B

Тип результата функции f.

f

Функция измерения.

cmp

Порядок, используемый для сравнения элементов.

returns

первый элемент этой коллекции с наименьшим значением, измеренным функцией f относительно порядка cmp.

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

UnsupportedOperationException если эта коллекция пуста.

def minByOption[B](f: ((Key, Value)) => B)(implicit cmp: math.Ordering[B]): Option[(Key, Value)]

Находит первый элемент, который дает наименьшее значение, измеренное функцией f.

B

Тип результата функции f.

f

Функция измерения.

cmp

Порядок, используемый для сравнения элементов.

returns

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

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

def minOption[B >: (Key, Value)](implicit ord: math.Ordering[B]): Option[(Key, Value)]

Находит наименьший элемент.

B

Тип, для которого определен порядок.

ord

Порядок, используемый для сравнения элементов.

returns

необязательное значение, содержащее наименьший элемент этой коллекции относительно порядка ord.

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

final def mkString: String

Отображает все элементы этой коллекции в строке.

Делегирует addString, который может быть переопределен.

returns

строковое представление этой коллекции. В результирующей строке строковые представления (относительно метода toString) всех элементов этой коллекции следуют друг за другом без разделительной строки.

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

final def mkString(sep: String): String

Отображает все элементы этого набора в строке с использованием разделителя.

Делегирует вызов addString, который можно переопределить.

sep

строка-разделитель.

возвращает

строковое представление этого набора. В результирующей строке строковые представления (в соответствии с методом toString) всех элементов этого набора разделены строкой sep.

Классы-определения
IterableOnceOps
Аннотации
@inline()
Пример:

    List(1, 2, 3).mkString("|") = "1|2|3"

final def mkString(start: String, sep: String, end: String): String

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

Делегирует вызов addString, который можно переопределить.

start

начальная строка.

sep

строка-разделитель.

end

конечная строка.

возвращает

строковое представление этого набора. Результирующая строка начинается со строки start и заканчивается строкой end. Внутри строковые представления (в соответствии с методом toString) всех элементов этого набора разделены строкой sep.

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

    List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"

final def ne(arg0: AnyRef): Boolean

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

возвращает

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

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

def newSpecificBuilder: Builder[(Key, Value), OpenHashMap[Key, Value]]

возвращает

строгий билдер для того же типа коллекции. Обратите внимание, что в случае ленивых коллекций (например, View или immutable.LazyList), реализовать этот метод возможно, но полученный Builder нарушит ленивость. Следовательно, операции предпочтительно реализовывать с помощью fromSpecific, а не с помощью этого метода.

Атрибуты
protected
Классы-определения
MapFactoryDefaults → IterableOps
Примечание

При реализации пользовательского типа коллекции и уточнении C до нового типа, этот метод необходимо переопределить (иначе компилятор выдаст ошибку). В общем случае, когда C =:= CC[A], это можно сделать, добавив трейт IterableFactoryDefaults, который реализует метод с использованием iterableFactory.

,

Как показывает аннотация @uncheckedVariance, использование этого метода может быть небезопасно. Однако, пока возвращаемый билдер получает только значения A из экземпляра this, это безопасно.

def nonEmpty: Boolean

Проверяет, не пуста ли коллекция.

возвращает

true если коллекция содержит хотя бы один элемент, false в противном случае.

Классы-определения
IterableOnceOps
Аннотации
@deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")

final def notify(): Unit

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

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

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

final def notifyAll(): Unit

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

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

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

def orElse[A1 <: Key, B1 >: Value](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]

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

A1

тип аргумента резервной функции

B1

тип результата резервной функции

that

резервная функция

возвращает

частичная функция, область определения которой является объединением областей определения этой частичной функции и that. Результирующая частичная функция принимает x к this(x), где this определена, и к that(x) где она не определена.

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

def partition(p: ((Key, Value)) => Boolean): (OpenHashMap[Key, Value], OpenHashMap[Key, Value])

Пара, содержащая, во-первых, все элементы, удовлетворяющие предикату p и, во-вторых, все элементы, которые не удовлетворяют ему. Интересно тем, что разделяет коллекцию на две части.

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

Определяющие классы
StrictOptimizedIterableOps → IterableOps

def partitionMap[A1, A2](f: ((Key, Value)) => Either[A1, A2]): (Iterable[A1], Iterable[A2])

Применяет функцию f к каждому элементу итерируемой коллекции и возвращает пару итерируемых коллекций: первая состоит из значений, возвращенных f, которые были обернуты в scala.util.Left, а вторая — из тех, которые были обернуты в scala.util.Right.

Пример:

val xs = Iterable(1, "one", 2, "two", 3, "three") partitionMap {
 case i: Int => Left(i)
 case s: String => Right(s)
}
// xs == (Iterable(1, 2, 3),
//        Iterable(one, two, three))
A1

тип элементов первой результирующей коллекции

A2

тип элементов второй результирующей коллекции

f

'Функция разделения', отображающая элементы этой итерируемой коллекции в scala.util.Either

возвращает

пару итерируемых коллекций: первая состоит из значений, возвращенных f, которые были обернуты в scala.util.Left, а вторая — из тех, которые были обернуты в scala.util.Right.

Определяющие классы
StrictOptimizedIterableOps → IterableOps

def product[B >: (Key, Value)](implicit num: math.Numeric[B]): B

Перемножает элементы этой коллекции.

B

результирующий тип оператора *.

num

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

возвращает

произведение всех элементов этой коллекции относительно оператора * в num.

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

def put(key: Key, value: Value): Option[Value]

Добавляет новую пару ключ/значение в эту карту и по желанию возвращает ранее связанное значение. Если карта уже содержит сопоставление для ключа, оно будет переопределено новым значением.

key

ключ для обновления

value

новое значение

возвращает

необязательное значение, содержащее значение, связанное с ключом до выполнения операции put, или None, если key не был определен в карте ранее.

Определяющие классы
OpenHashMap → MapOps

def reduce[B >: (Key, Value)](op: (B, B) => B): B

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

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

B

Параметр типа для бинарного оператора, супертип A.

op

Бинарный оператор, который должен быть ассоциативным.

возвращает

Результат применения оператора сводки op ко всем элементам, если коллекция не пуста.

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

UnsupportedOperationException если эта коллекция пуста.

def reduceLeft[B >: (Key, Value)](op: (B, (Key, Value)) => B): B

Применяет бинарный оператор ко всем элементам этой коллекции, слева направо.

Примечание: не будет завершаться для коллекций бесконечного размера.

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

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этой коллекции, слева направо:

op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)

где x1, ..., xn - элементы этой коллекции.

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

UnsupportedOperationException если эта коллекция пуста.

def reduceLeftOption[B >: (Key, Value)](op: (B, (Key, Value)) => B): Option[B]

Необязательно применяет бинарный оператор ко всем элементам этой коллекции, слева направо.

Примечание: не будет завершаться для коллекций бесконечного размера.

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

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

необязательное значение, содержащее результат reduceLeft(op), если эта коллекция не пуста, None в противном случае.

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

def reduceOption[B >: (Key, Value)](op: (B, B) => B): Option[B]

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

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

B

Параметр типа для бинарного оператора, супертип A.

op

Бинарный оператор, который должен быть ассоциативным.

returns

Необязательное значение, содержащее результат применения оператора сводки op между всеми элементами, если коллекция не пуста, и None в противном случае.

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

def reduceRight[B >: (Key, Value)](op: ((Key, Value), B) => B): B

Применяет бинарный оператор ко всем элементам этой коллекции, справа налево.

Примечание: не будет завершаться для коллекций бесконечного размера.

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

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

результат вставки op между последовательными элементами этой коллекции, справа налево:

op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))

где x1, ..., xn - элементы этой коллекции.

Определяющие классы
IterableOnceOps
Выбрасываемые исключения

UnsupportedOperationException если эта коллекция пуста.

def reduceRightOption[B >: (Key, Value)](op: ((Key, Value), B) => B): Option[B]

Необязательно применяет бинарный оператор ко всем элементам этой коллекции, справа налево.

Примечание: не будет завершаться для коллекций бесконечного размера.

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

B

тип результата бинарного оператора.

op

бинарный оператор.

returns

необязательное значение, содержащее результат reduceRight(op), если эта коллекция не пуста, None в противном случае.

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

def remove(key: Key): Option[Value]

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

key

ключ, который нужно удалить

returns

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

Определяющие классы
OpenHashMap → MapOps

def result(): OpenHashMap[Key, Value]

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

Definition Classes
MapOps → Builder

def reversed: collection.Iterable[(Key, Value)]

Attributes
protected
Definition Classes
IterableOnceOps

def runWith[U](action: (Value) => U): (Key) => Boolean

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

Обратите внимание, что выражение pf.runWith(action)(x) эквивалентно

if(pf isDefinedAt x) { action(pf(x)); true } else false

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

action

функция действия

returns

функция, которая отображает аргументы x на isDefinedAt(x). Результирующая функция выполняет action(this(x)), где this определено.

Definition Classes
PartialFunction
Since

2.10

See also

applyOrElse.

def scan[B >: (Key, Value)](z: B)(op: (B, B) => B): Iterable[B]

Вычисляет префиксное сканирование элементов коллекции.

Примечание: нейтральный элемент z может применяться более одного раза.

B

тип элементов результирующей коллекции

z

нейтральный элемент для оператора op

op

ассоциативный оператор для сканирования

returns

новая итерируемая коллекция, содержащая префиксное сканирование элементов в этой итерируемой коллекции

Definition Classes
IterableOps

def scanLeft[B](z: B)(op: (B, (Key, Value)) => B): Iterable[B]

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

Примечание: не будет завершаться для коллекций бесконечного размера.

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

B

тип элементов в результирующей коллекции

z

начальное значение

op

бинарный оператор, применяемый к промежуточному результату и элементу

returns

коллекция с промежуточными результатами

Definition Classes
StrictOptimizedIterableOps → IterableOps → IterableOnceOps
Note

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

def scanRight[B](z: B)(op: ((Key, Value), B) => B): Iterable[B]

Создает коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Голова коллекции - последний кумулятивный результат.

Примечание: не будет завершаться для коллекций бесконечного размера.

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

Примечание: даже при применении к представлению или ленивой коллекции он всегда будет принудительно получать элементы.

Пример:

List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)
B

тип элементов в результирующей коллекции

z

начальное значение

op

бинарный оператор, применяемый к промежуточному результату и элементу

returns

коллекция с промежуточными результатами

Definition Classes
IterableOps

def size: Int

Размер этой открытой хеш-таблицы.

returns

количество элементов в этой открытой хеш-таблице.

Definition Classes
OpenHashMap → IterableOnceOps

def sizeCompare(that: collection.Iterable[_]): Int

Сравнивает размер этого итерируемого набора с размером другого Iterable.

that

the Iterable размер которого сравнивается с размером этого итерируемого набора.

returns

Значение x где

x <  0       if this.size <  that.size
x == 0       if this.size == that.size
x >  0       if this.size >  that.size

Реализация метода здесь не вызывает size напрямую; его время выполнения составляет O(this.size min that.size) вместо O(this.size + that.size). Метод следует переопределить, если вычисление size является быстрым, и knownSize возвращает -1.

Definition Classes
IterableOps

def sizeCompare(otherSize: Int): Int

Сравнивает размер этого итерируемого набора со значением теста.

otherSize

тестовое значение, которое сравнивается с размером.

returns

Значение x где

x <  0       if this.size <  otherSize
x == 0       if this.size == otherSize
x >  0       if this.size >  otherSize

Реализация метода здесь не вызывает size напрямую; его время выполнения составляет O(size min otherSize) вместо O(size). Метод следует переопределить, если вычисление size является быстрым, и knownSize возвращает -1.

Definition Classes
IterableOps
See also

sizeIs

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

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

coll

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

delta

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

Definition Classes
Builder

def sizeHint(size: Int): Unit

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

size

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

Definition Classes
Builder

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

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

size

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

boundingColl

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

Definition Classes
Builder

final def sizeIs: SizeCompareOps

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

Эти операции реализованы с помощью sizeCompare(Int) и позволяют использовать следующие более удобочитаемые варианты использования:

this.sizeIs < size     // this.sizeCompare(size) < 0
this.sizeIs <= size    // this.sizeCompare(size) <= 0
this.sizeIs == size    // this.sizeCompare(size) == 0
this.sizeIs != size    // this.sizeCompare(size) != 0
this.sizeIs >= size    // this.sizeCompare(size) >= 0
this.sizeIs > size     // this.sizeCompare(size) > 0
Definition Classes
IterableOps
Annotations
@inline()

def slice(from: Int, until: Int): OpenHashMap[Key, Value]

Выбирает интервал элементов. Возвращаемый итерируемый набор состоит из всех элементов x , которые удовлетворяют инварианту:

from <= indexOf(x) < until

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

from

наименьший индекс для включения из этого итерируемого набора.

until

наименьший индекс для исключения из этого итерируемого набора.

returns

итерируемый набор, содержащий элементы, большие или равные индексу from и продолжающиеся до (но не включая) индекс until этого итерируемого набора.

Definition Classes
IterableOps → IterableOnceOps
Note

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

def sliding(size: Int, step: Int): Iterator[OpenHashMap[Key, Value]]

Группирует элементы в блоки фиксированного размера, передавая «скользящее окно» по ним (в отличие от их разбиения, как это делается в grouped).

size

количество элементов в группе

step

расстояние между первыми элементами последовательных групп

returns

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

Definition Classes
IterableOps
See also

scala.collection.Iterator, метод sliding

def sliding(size: Int): Iterator[OpenHashMap[Key, Value]]

Группирует элементы в блоки фиксированного размера, передавая «скользящее окно» по ним (в отличие от разбиения, как это делается в grouped). Шаг «скользящего окна» задан равным единице.

size

количество элементов в группе

returns

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

Definition Classes
IterableOps
See also

scala.collection.Iterator, метод sliding

def span(p: ((Key, Value)) => Boolean): (OpenHashMap[Key, Value], OpenHashMap[Key, Value])

Разделяет эту итерируемую коллекцию на пару префикс/суффикс в соответствии с предикатом.

Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.

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

p

предикат проверки

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps → IterableOnceOps
Note

Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах также.

def splitAt(n: Int): (OpenHashMap[Key, Value], OpenHashMap[Key, Value])

Разделяет эту итерируемую коллекцию на пару префикс/суффикс в заданной позиции.

Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).

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

n

позиция разделения.

returns

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

Definition Classes
IterableOps → IterableOnceOps
Note

Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах также.

def stepper[S <: Stepper[_]](implicit shape: StepperShape[(Key, Value), S]): S

Возвращает Stepper для элементов этой коллекции.

Stepper позволяет создавать Java поток для работы с коллекцией, см. scala.jdk.StreamConverters. Для коллекций, содержащих примитивные значения, Stepper может использоваться как итератор, который не упаковывает элементы.

Неявный параметр StepperShape определяет тип возвращаемого Stepper в соответствии с типом элемента этой коллекции.

    Для коллекций целых чисел, чисел с плавающей запятой, длинных целых чисел или строк возвращается IntStepper Для коллекций чисел с плавающей запятой или длинных целых чисел возвращается DoubleStepper Для коллекций длинных целых чисел возвращается LongStepper Для всех других типов элементов возвращается AnyStepper

Обратите внимание, что этот метод переопределяется в подклассах, и возвращаемый тип уточняется до S with EfficientSplit, например IndexedSeqOps.stepper. Для Steppers, помеченных как scala.collection.Stepper.EfficientSplit, конвертеры в scala.jdk.StreamConverters позволяют создавать параллельные потоки, тогда как обычные Steppers могут быть преобразованы только в последовательные потоки.

Definition Classes
IterableOnce

final def strictOptimizedCollect[B, C2](b: Builder[B, C2], pf: PartialFunction[(Key, Value), B]): C2

B

Тип элементов результирующего набора (например, String)

C2

Тип результирующего набора (например, List[String])

b

Используемый билдер для построения результирующего набора

pf

Частичная функция преобразования элементов

returns

Результирующий набор

Attributes
protected[this]
Definition Classes
StrictOptimizedIterableOps
Annotations
@inline()

final def strictOptimizedConcat[B >: (Key, Value), C2](that: IterableOnce[B], b: Builder[B, C2]): C2

B

Тип элементов результирующих наборов (например, Int)

C2

Тип результирующего набора (например, List[Int])

that

Элементы для конкатенации с этим набором

b

Используемый билдер для построения результирующего набора

returns

Результирующий набор

Attributes
protected[this]
Definition Classes
StrictOptimizedIterableOps
Annotations
@inline()

final def strictOptimizedFlatMap[B, C2](b: Builder[B, C2], f: ((Key, Value)) => IterableOnce[B]): C2

B

Тип элементов результирующего набора (например, String)

C2

Тип результирующего набора (например, List[String])

b

Используемый билдер для построения результирующего набора

f

Функция преобразования элементов

returns

Результирующий набор

Attributes
protected[this]
Definition Classes
StrictOptimizedIterableOps
Annotations
@inline()

final def strictOptimizedFlatten[B, C2](b: Builder[B, C2])(implicit toIterableOnce: ((Key, Value)) => IterableOnce[B]): C2

B

Тип элементов результирующего набора (например, Int)

C2

Тип результирующего набора (например, List[Int])

b

Используемый билдер для построения результирующего набора

toIterableOnce

Доказательство, что A может быть воспринят как IterableOnce[B]

returns

Результирующий набор

Attributes
protected[this]
Definition Classes
StrictOptimizedIterableOps
Annotations
@inline()

final def strictOptimizedMap[B, C2](b: Builder[B, C2], f: ((Key, Value)) => B): C2

B

Тип элементов результирующего набора (например, String)

C2

Тип результирующего набора (например, List[String])

b

Используемый билдер для построения результирующего набора

f

Функция преобразования элементов

returns

Результирующий набор

Attributes
protected[this]
Definition Classes
StrictOptimizedIterableOps
Annotations
@inline()

final def strictOptimizedZip[B, C2](that: IterableOnce[B], b: Builder[((Key, Value), B), C2]): C2

B

Тип элементов второго набора (например, String)

C2

Тип результирующего набора (например, List[(Int, String)])

that

Набор для объединения с этим набором

b

Строитель для построения результирующего набора

returns

Результирующий набор

Attributes
protected[this]
Definition Classes
StrictOptimizedIterableOps
Annotations
@inline()

def stringPrefix: String

Attributes
protected[this]
Definition Classes
OpenHashMap → Map → Iterable

def subtractAll(xs: IterableOnce[Key]): OpenHashMap.this.type

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

xs

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

returns

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

Definition Classes
Shrinkable

def subtractOne(key: Key): OpenHashMap.this.type

Удаляет один элемент из этой открытой хеш-таблицы.

returns

сама открытая хеш-таблица

Definition Classes
OpenHashMap → Shrinkable
Annotations
@deprecatedOverriding("subtractOne should not be overridden in order to maintain consistency with remove.", "2.11.0")

def sum[B >: (Key, Value)](implicit num: math.Numeric[B]): B

Суммирует элементы этого набора.

B

тип результата оператора +.

num

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

returns

сумма всех элементов этого набора относительно оператора + в num.

Definition Classes
IterableOnceOps

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

Definition Classes
AnyRef

def tail: OpenHashMap[Key, Value]

Остальная часть набора без первого элемента.

Definition Classes
IterableOps

def tails: Iterator[OpenHashMap[Key, Value]]

Итерация по хвостам этого набора. Первое значение будет этим набором, а последнее — пустым набором, а промежуточные значения — результатом последовательного применения tail.

returns

итератор по всем хвостам этого набора

Definition Classes
IterableOps
Пример:

    List(1,2,3).tails = Iterator(List(1,2,3), List(2,3), List(3), Nil)

def take(n: Int): OpenHashMap[Key, Value]

Выбирает первые n элементов.

Примечание: могут возвращаться разные результаты при разных запусках, если тип базового набора не упорядочен.

n

количество элементов, которые нужно взять из этого итерируемого набора.

returns

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

Definition Classes
IterableOps → IterableOnceOps
Note

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

def takeRight(n: Int): OpenHashMap[Key, Value]

Коллекция, содержащая последние n элементы этой коллекции.

Примечание: даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.

n

количество элементов, которые нужно взять из этого итерируемого набора.

returns

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

Definition Classes
StrictOptimizedIterableOps → IterableOps

def takeWhile(p: ((Key, Value)) => Boolean): OpenHashMap[Key, Value]

Берет наибольший префикс элементов, удовлетворяющих предикату.

Примечание: могут возвращаться разные результаты при разных запусках, если тип базового набора не упорядочен.

p

Предикат, используемый для проверки элементов.

returns

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

Definition Classes
IterableOps → IterableOnceOps

def tapEach[U](f: ((Key, Value)) => U): OpenHashMap[Key, Value]

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

U

тип возвращаемого значения f

f

функция, которая должна быть применена к каждому элементу в этом итерируемом наборе

returns

Такая же логическая коллекция, как и эта

Definition Classes
StrictOptimizedIterableOps → IterableOps → IterableOnceOps

def to[C1](factory: Factory[(Key, Value), C1]): C1

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

xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]

Definition Classes
IterableOnceOps

def toArray[B >: (Key, Value)](implicit arg0: ClassTag[B]): Array[B]

Преобразовать коллекцию в массив.

Definition Classes
IterableOnceOps

final def toBuffer[B >: (Key, Value)]: Buffer[B]

Definition Classes
IterableOnceOps
Annotations
@inline()

def toIndexedSeq: immutable.IndexedSeq[(Key, Value)]

Definition Classes
IterableOnceOps

final def toIterable: OpenHashMap.this.type

возвращает

Это коллекция в виде Iterable[A]. Новая коллекция не будет создана, если this уже является Iterable[A].

Классы определения
Iterable → IterableOps

def toList: immutable.List[(Key, Value)]

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

def toMap[K, V](implicit ev: <:<[(Key, Value), (K, V)]): immutable.Map[K, V]

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

def toSeq: immutable.Seq[(Key, Value)]

возвращает

Это коллекция в виде Seq[A]. Это эквивалентно to(Seq), но может быть быстрее.

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

def toSet[B >: (Key, Value)]: immutable.Set[B]

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

def toString(): String

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

возвращает

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

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

def toVector: immutable.Vector[(Key, Value)]

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

def transpose[B](implicit asIterable: ((Key, Value)) => collection.Iterable[B]): Iterable[Iterable[B]]

Транспонирует эту итерируемую коллекцию итерируемых коллекций в итерируемую коллекцию итерируемых коллекций.

Тип результирующей коллекции будет определяться статическим типом итерируемой коллекции. Например:

val xs = List(
           Set(1, 2, 3),
           Set(4, 5, 6)).transpose
// xs == List(
//         List(1, 4),
//         List(2, 5),
//         List(3, 6))

val ys = Vector(
           List(1, 2, 3),
           List(4, 5, 6)).transpose
// ys == Vector(
//         Vector(1, 4),
//         Vector(2, 5),
//         Vector(3, 6))

Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычислены.

B

тип элементов каждой итерируемой коллекции.

asIterable

явное преобразование, которое утверждает, что тип элемента этой итерируемой коллекции является Iterable.

возвращает

двумерная итерируемая коллекция итерируемых коллекций, в которой n-я строка соответствует n-му столбцу этой итерируемой коллекции.

Классы определения
IterableOps
Исключения

IllegalArgumentException, если все коллекции в этой итерируемой коллекции не имеют одинаковый размер.

def unapply(a: Key): Option[Value]

Попытка извлечения B из A в выражении сопоставления с образцом.

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

def unlift: PartialFunction[Key, B]

Преобразует необязательную функцию в частичную функцию.

Неявный
Этот член добавлен неявно путем преобразования из OpenHashMap[Ключ, Значение] вUnliftOps[Ключ, B] выполненное методом UnliftOps в scala.Function1.Это преобразование будет выполнено только в том случае, если Value является подклассом Option[B] (Value <: Option[B]).
Классы определений
UnliftOps
Пример:

    В отличие от Function.unlift, этот метод UnliftOps.unlift может использоваться в экстракторах.

    val of: Int => Option[String] = { i =>
      if (i == 2) {
        Some("matched by an optional function")
      } else {
        None
      }
    }
    
    util.Random.nextInt(4) match {
      case of.unlift(m) => // Convert an optional function to a pattern
        println(m)
      case _ =>
        println("Not matched")
    }

def unzip[A1, A2](implicit asPair: ((Ключ, Значение)) => (A1, A2)): (Iterable[A1], Iterable[A2])

Преобразует эту итерируемую коллекцию пар в две коллекции первой и второй половины каждой пары.

val xs = Iterable(
           (1, "one"),
           (2, "two"),
           (3, "three")).unzip
// xs == (Iterable(1, 2, 3),
//        Iterable(one, two, three))
A1

тип первой половины пар элементов

A2

тип второй половины пар элементов

asPair

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

returns

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

Классы определений
StrictOptimizedIterableOps → IterableOps

def unzip3[A1, A2, A3](implicit asTriple: ((Ключ, Значение)) => (A1, A2, A3)): (Iterable[A1], Iterable[A2], Iterable[A3])

Преобразует эту итерируемую коллекцию троек в три коллекции первого, второго и третьего элемента каждой тройки.

val xs = Iterable(
           (1, "one", '1'),
           (2, "two", '2'),
           (3, "three", '3')).unzip3
// xs == (Iterable(1, 2, 3),
//        Iterable(one, two, three),
//        Iterable(1, 2, 3))
A1

тип первого члена троек элементов

A2

тип второго члена троек элементов

A3

тип третьего члена троек элементов

asTriple

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

returns

тройка итерируемых коллекций, содержащих первый, второй, соответственно третий член каждой тройки элементов этой итерируемой коллекции.

Классы определений
StrictOptimizedIterableOps → IterableOps

def update(key: Ключ, value: Значение): Unit

Добавляет новую пару ключ/значение в этот массив. Если в массиве уже есть отображение для ключа, оно будет перезаписано новым значением.

key

Ключ для обновления

value

Новое значение

Классы определений
OpenHashMap → MapOps

def updateWith(key: Ключ)(remappingFunction: (Option[Значение]) => Option[Значение]): Option[Значение]

Обновляет отображение для указанного ключа и его текущего, необязательно сопоставленного значения (Some если есть текущее сопоставление, None если нет).

Если функция переназначения возвращает Some(v), отображение обновляется с новым значением v. Если функция переназначения возвращает None, отображение удаляется (или остается отсутствующим, если оно изначально отсутствовало). Если сама функция вызывает исключение, исключение перебрасывается, а текущее отображение остается неизменным.

key

значение ключа

remappingFunction

частичная функция, которая получает текущее необязательно сопоставленное значение и возвращает новое отображение

returns

новое значение, связанное с указанным ключом

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

2.13.0

def valueStepper[S <: Stepper[_]](implicit shape: StepperShape[Значение, S]): S

Возвращает Stepper для значений этого массива. См. метод stepper.

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

def values: collection.Iterable[Value]

Собирает все значения этой карты в итерабельную коллекцию.

returns

значения этой карты как итерабельный объект.

Definition Classes
MapOps

def valuesIterator: Iterator[Value]

Создаёт итератор для всех значений в этой карте.

returns

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

Definition Classes
OpenHashMap → MapOps

def view: MapView[Key, Value]

Представление элементов этой коллекции.

Definition Classes
MapOps → IterableOps

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()

def withDefault(d: (Key) => Value): Map[Key, Value]

Та же карта с заданной функцией по умолчанию. Примечание: значение по умолчанию используется только для apply. Другие методы, такие как get, contains, iterator, keys, и т. д., не затрагиваются withDefaultValue. Вызов методов трансформации (например, map) не сохранит значение по умолчанию.

d

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

returns

обёртка карты со значением по умолчанию

Definition Classes
Map

def withDefaultValue(d: Value): Map[Key, Value]

Та же карта с заданным значением по умолчанию. Примечание: значение по умолчанию используется только для apply. Другие методы, такие как get, contains, iterator, keys, и т. д., не затрагиваются withDefaultValue. Вызов методов трансформации (например, map) не сохранит значение по умолчанию.

d

значение по умолчанию, используемое для отсутствующих ключей

returns

обёртка карты со значением по умолчанию

Definition Classes
Map

def withFilter(p: ((Key, Value)) => Boolean): MapOps.WithFilter[Key, Value, [x]Iterable[x], [x, y]OpenHashMap[x, y]]

Создаёт нестрогое фильтрующее представление этой карты.

Примечание: разница между c filter p и c withFilter p заключается в том, что первый создаёт новую коллекцию, а второй только ограничивает область действия последующих map, flatMap, foreach, и withFilter операций. Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.

p

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

returns

объект класса WithFilter, который поддерживает map, flatMap, foreach, и withFilter операции. Все эти операции применяются к тем элементам этой карты, которые удовлетворяют предикату p.

Definition Classes
MapFactoryDefaults → IterableOps

def writeReplace(): AnyRef

Attributes
protected[this]
Definition Classes
DefaultSerializable

def zip[B](that: IterableOnce[B]): Iterable[((Key, Value), B)]

Возвращает итерируемую коллекцию, образованную из этой итерируемой коллекции и другой итерируемой коллекции, объединив соответствующие элементы парами. Если одна из двух коллекций длиннее другой, оставшиеся элементы игнорируются.

B

тип второй половины возвращаемых пар

that

Итерируемая коллекция, предоставляющая вторую половину каждой пары результата

returns

новая итерируемая коллекция, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции и that. Длина возвращаемой коллекции равна минимуму длин этой итерируемой коллекции и that.

Definition Classes
StrictOptimizedIterableOps → IterableOps

def zipAll[A1 >: (Key, Value), B](that: collection.Iterable[B], thisElem: A1, thatElem: B): Iterable[(A1, B)]

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

that

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

thisElem

элемент, используемый для заполнения результата, если эта итерируемая коллекция короче, чем that.

thatElem

элемент, используемый для заполнения результата, если that короче, чем эта итерируемая коллекция.

returns

новая коллекция типа That, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции и that. Длина возвращаемой коллекции равна максимуму из длин этой итерируемой коллекции и that. Если эта итерируемая коллекция короче, чем that, значения thisElem используются для заполнения результата. Если that короче, чем эта итерируемая коллекция, значения thatElem используются для заполнения результата.

Definition Classes
IterableOps

def zipWithIndex: Iterable[((Key, Value), Int)]

Сцепляет эту итерируемую коллекцию со своими индексами.

returns

Новая итерируемая коллекция, содержащая пары, состоящие из всех элементов этой итерируемой коллекции, соединённых с их индексом. Индексы начинаются с 0.

Definition Classes
StrictOptimizedIterableOps → IterableOps → IterableOnceOps
Пример:

    List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))

Note

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

Shadowed Implicit Value Members

def +(other: String): String

Implicit
Этот член добавлен неявным преобразованием из OpenHashMap[Key, Value] вany2stringadd[OpenHashMap[Key, Value]] выполняемое методом any2stringadd в scala.Predef.
Shadowing
Этот неявный наследуемый член скрыт одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(openHashMap: any2stringadd[OpenHashMap[Key, Value]]).+(other)
Definition Classes
any2stringadd

© 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/OpenHashMap.html

Spec-Zone.ru

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