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

class AnyRefMap[K <: AnyRef, V] extends AbstractMap[K, V] with MapOps[K, V, Map, AnyRefMap[K, V]] with StrictOptimizedIterableOps[(K, V), Iterable, AnyRefMap[K, V]] with Serializable

Этот класс реализует изменяемые отображения с AnyRef ключами, основанные на хэш-таблице с открытым аддрированием.

Основные операции сопоставления на отдельных записях, включая contains и get, обычно значительно быстрее с AnyRefMap чем HashMap. Обратите внимание, что числа и символы не обрабатываются специально в AnyRefMap; только обычные equals и hashCode используются в сравнениях.

Методы, которые обходятся по отображению или пересоздают его, включая foreach и map, как правило, не быстрее, чем с HashMap. Однако методы foreachKey, foreachValue, mapValuesNow, и transformValues быстрее, чем альтернативные способы достижения той же функциональности.

Отображения с открытым аддрированием могут стать менее эффективными при поиске после многократного добавления/удаления элементов. Хотя AnyRefMap предпринимает разумные попытки оставаться эффективными независимо от этого, вызов repack для отображения, из которого больше не будут удаляться элементы, но который будет активно использоваться, может сэкономить как время, так и объем памяти.

Это отображение не предназначено для хранения более чем 229 записей (примерно 500 миллионов). Максимальная емкость составляет 230, но производительность резко ухудшится при приближении к 230.

Конструкторы

Исходный код

def this()

Исходный код

def this(defaultEntry: K => V)

Создаёт новое AnyRefMap, которое возвращает значения по умолчанию в соответствии с предоставленной сопоставлением ключ-значение.

Исходный код

def this(initialBufferSize: Int)

Создаёт новое AnyRefMap с начальным буфером заданного размера.

AnyRefMap может обычно содержать вдвое меньше элементов, чем размер буфера, прежде чем потребуется изменение размера.

Исходный код

def this(defaultEntry: K => V, initialBufferSize: Int)

Создаёт новое AnyRefMap с заданными значениями по умолчанию и начальным размером буфера.

Конкретные методы

Исходный код

override def ++[V2 >: V](xs: IterableOnce[(K, V2)]): AnyRefMap[K, V2]

Исходный код@inline

final def addOne(key: K, value: V): AnyRefMap[K, V]

Добавляет новую пару ключ/значение в это отображение и возвращает отображение.

Исходный код@inline

final override def addOne(kv: (K, V)): AnyRefMap[K, V]

Исходный код

override def apply(key: K): V

Возвращает значение, связанное с ключом. Если ключ не существует в отображении, вместо него возвращается defaultEntry для этого ключа; исключение будет выброшено, если не было указано defaultEntry.

Исходный код

override def clear(): Unit

Исходный код

override def clone(): AnyRefMap[K, V]

Исходный код

def collect[K2 <: AnyRef, V2](pf: PartialFunction[(K, V), (K2, V2)])(implicit dummy: DummyImplicit): AnyRefMap[K2, V2]

Исходный код

override def concat[V2 >: V](xs: IterableOnce[(K, V2)]): AnyRefMap[K, V2]

Исходный код

override def contains(key: K): Boolean

Исходный код

override def default(key: K): V

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

Исходный код

override def empty: AnyRefMap[K, V]

Source

def flatMap[K2 <: AnyRef, V2](f: (K, V) => IterableOnce[(K2, V2)])(implicit dummy: DummyImplicit): AnyRefMap[K2, V2]

Source

override def foreach[U](f: (K, V) => U): Unit

Source

override def foreachEntry[U](f: (K, V) => U): Unit

Source

def foreachKey[A](f: K => A): Unit

Применяет функцию ко всем ключам этой карты.

Source

def foreachValue[A](f: V => A): Unit

Применяет функцию ко всем значениям этой карты.

Source

override def get(key: K): Option[V]

Source

override def getOrElse[V1 >: V](key: K, default: => V1): V1

Source

override def getOrElseUpdate(key: K, defaultValue: => V): V

Source

def getOrNull(key: K): V

Возвращает значение, связанное с ключом, или значение по умолчанию для этого типа, если оно не существует (null для AnyRef, 0 для чисел с плавающей точкой и целых чисел).

Примечание: это самый быстрый способ извлечения значения, которое может или не может существовать, если допустимо значение по умолчанию null/ноль. Для пар ключ/значение, которые существуют, apply (т.е. map(key)) так же быстро.

Source

override def isEmpty: Boolean

Source

def iterator: Iterator[(K, V)]

Source

override def keysIterator: Iterator[K]

Source

override def knownSize: Int

Source

def map[K2 <: AnyRef, V2](f: (K, V) => (K2, V2))(implicit dummy: DummyImplicit): AnyRefMap[K2, V2]

Source

def mapValuesNow[V1](f: V => V1): AnyRefMap[K, V1]

Создает новую AnyRefMap с другими значениями. В отличие от mapValues, этот метод сразу генерирует новую коллекцию.

Source

override def put(key: K, value: V): Option[V]

Source

def repack(): Unit

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

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

Source

override def size: Int

Source

def subtractOne(key: K): AnyRefMap[K, V]

Source

def transformValuesInPlace(f: V => V): AnyRefMap[K, V]

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

Source

override def update(key: K, value: V): Unit

Обновляет карту, чтобы включить новую пару ключ-значение.

Это самый быстрый способ добавить запись в AnyRefMap.

Source

override def valuesIterator: Iterator[V]

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

Source@inline

final def ++[B >: (K, V)](suffix: IterableOnce[B]): Iterable[B]

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

Source@inline

final def ++=(xs: IterableOnce[(K, V)]): AnyRefMap[K, V]

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

Source@inline

final def +=(elem: (K, V)): AnyRefMap[K, V]

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

Source@inline

final def --=(xs: IterableOnce[K]): AnyRefMap[K, V]

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

Source@inline

final def -=(elem: K): AnyRefMap[K, V]

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

Source

def addAll(xs: IterableOnce[(K, V)]): AnyRefMap[K, V]

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

Source@inline

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

Source@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

Source

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

Source

def andThen[C](k: PartialFunction[V, C]): PartialFunction[K, C]

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

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

Source

override def andThen[C](k: V => C): PartialFunction[K, C]

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

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

Source

override def applyOrElse[K1 <: K, V1 >: V](x: K1, default: K1 => V1): V1

Source

def canEqual(that: Any): Boolean

Source

override def collect[B](pf: PartialFunction[(K, V), B]): Iterable[B]

Source

def collect[K2, V2](pf: PartialFunction[(K, V), (K2, V2)]): Map[K2, V2]

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

Source

def collectFirst[B](pf: PartialFunction[(K, V), B]): Option[B]

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

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

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

Исходный код

def compose[R](k: PartialFunction[R, K]): PartialFunction[R, V]

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

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

Исходный код@unspecialized

def compose[A](g: A => K): A => V

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

Исходный код

def concat[B >: (K, V)](suffix: IterableOnce[B]): Iterable[B]

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

Исходный код

def copyToArray[B >: (K, V)](xs: Array[B], start: Int, len: Int): Int

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

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

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

Исходный код@deprecatedOverriding("This should always forward to the 3-arg version of this method", since = "2.13.4")

def copyToArray[B >: (K, V)](xs: Array[B], start: Int): Int

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

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

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

Источник@deprecatedOverriding("Это всегда должно пересылать 3-аргументную версию этого метода", since = "2.13.4")

def copyToArray[B >: (K, V)](xs: Array[B]): Int

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

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

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

Источник

def corresponds[B](that: IterableOnce[B])(p: ((K, V), B) => Boolean): Boolean

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

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

Источник

def count(p: (K, V) => Boolean): Int

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

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

Источник

def drop(n: Int): AnyRefMap[K, V]

Source

override def dropRight(n: Int): AnyRefMap[K, V]

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

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

Source

def dropWhile(p: (K, V) => Boolean): AnyRefMap[K, V]

Source

def elementWise: ElementWiseExtractor[K, V]

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

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
}

Source

override def equals(o: Any): Boolean

Равенство карт реализуется с использованием метода поиска get. Этот метод возвращает true если

• аргумент o является Map,

• две карты имеют одинаковый размер, и

• для каждой (key, value) пары в этой карте other.get(key) == Some(value).

Реализация equals проверяет метод canEqual, поэтому подклассы Map могут сузить равенство до конкретных типов карт. Реализации Map в стандартной библиотеке могут быть сравнимы, их методы canEqual возвращают true.

Примечание: Метод equals соблюдает законы равенства (симметрия, транзитивность) только в том случае, если две карты используют одну и ту же функцию эквивалентности ключей в своей операции поиска. Например, операция эквивалентности ключей в scala.collection.immutable.TreeMap определяется её упорядочением. Сравнение TreeMap с HashMap приводит к неожиданным результатам, если ordering.equiv(k1, k2) (используемая для поиска в TreeMap ) отличается от k1 == k2 (используемой для поиска в HashMap).

scala> import scala.collection.immutable._
scala> val ord: Ordering[String] = _ compareToIgnoreCase _

scala> TreeMap("A" -> 1)(ord) == HashMap("a" -> 1)
val res0: Boolean = false

scala> HashMap("a" -> 1) == TreeMap("A" -> 1)(ord)
val res1: Boolean = true

Source

def exists(p: (K, V) => Boolean): Boolean

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

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

Source

override def filter(pred: (K, V) => Boolean): AnyRefMap[K, V]

Source

def filterInPlace(p: (K, V) => Boolean): AnyRefMap[K, V]

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

Source

override def filterNot(pred: (K, V) => Boolean): AnyRefMap[K, V]

Source

def find(p: (K, V) => Boolean): Option[(K, V)]

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

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

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

Source

override def flatMap[B](f: (K, V) => IterableOnce[B]): Iterable[B]

Source

def flatMap[K2, V2](f: (K, V) => IterableOnce[(K2, V2)]): Map[K2, V2]

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

Source

override def flatten[B](implicit toIterableOnce: (K, V) => IterableOnce[B]): Iterable[B]

Source

def fold[A1 >: (K, V)](z: A1)(op: (A1, A1) => A1): A1

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

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

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

Исходный код

def foldLeft[B](z: B)(op: (B, (K, V)) => B): B

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

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

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

Исходный код

def foldRight[B](z: B)(op: ((K, V), B) => B): B

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

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

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

Исходный код

def forall(p: (K, V) => Boolean): Boolean

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

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

Исходный код

def groupBy[K](f: (K, V) => K): Map[K, AnyRefMap[K, V]]

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

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

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

Исходный код

def groupMap[K, B](key: (K, V) => K)(f: (K, V) => B): 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)

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

Исходный код

def groupMapReduce[K, B](key: (K, V) => K)(f: (K, V) => B)(reduce: (B, B) => B): Map[K, B]

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

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

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

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

Исходный код

def grouped(size: Int): Iterator[AnyRefMap[K, V]]

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

Исходный код

override def hashCode(): Int

Исходный код

def head: (K, V)

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

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

Исходный код

def headOption: Option[(K, V)]

Возвращает первый элемент, если он существует.

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

Источник

def init: AnyRefMap[K, V]

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

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

Источник

def inits: Iterator[AnyRefMap[K, V]]

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

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

Источник

def isDefinedAt(key: K): Boolean

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

Источник

override def isTraversableAgain: Boolean

Источник

override def iterableFactory: IterableFactory[Iterable]

Источник

def keySet: Set[K]

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

Источник

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

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

Источник

def keys: Iterable[K]

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

Источник

def last: (K, V)

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

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

Источник

def lastOption: Option[(K, V)]

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

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

Источник

def lazyZip[B](that: Iterable[B]): LazyZip2[(K, V), B, AnyRefMap[K, V]]

Аналогично 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)

Источник

def lift: K => Option[V]

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

Источник

override def map[B](f: (K, V) => B): Iterable[B]

Источник

def map[K2, V2](f: (K, V) => (K2, V2)): Map[K2, V2]

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

Источник

override def mapFactory: MapFactory[Map]

Источник

def mapResult[NewTo](f: AnyRefMap[K, V] => NewTo): Builder[(K, V), NewTo]

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

Source

def mapValuesInPlace(f: (K, V) => V): AnyRefMap[K, V]

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

Source

def max[B >: (K, V)](implicit ord: Ordering[B]): (K, V)

Находит максимальный элемент.

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

Source

def maxBy[B](f: (K, V) => B)(implicit cmp: Ordering[B]): (K, V)

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

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

Source

def maxByOption[B](f: (K, V) => B)(implicit cmp: Ordering[B]): Option[(K, V)]

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

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

Source

def maxOption[B >: (K, V)](implicit ord: Ordering[B]): Option[(K, V)]

Находит максимальный элемент.

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

Source

def min[B >: (K, V)](implicit ord: Ordering[B]): (K, V)

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

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

Источник

def minBy[B](f: (K, V) => B)(implicit cmp: Ordering[B]): (K, V)

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

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

Источник

def minByOption[B](f: (K, V) => B)(implicit cmp: Ordering[B]): Option[(K, V)]

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

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

Источник

def minOption[B >: (K, V)](implicit ord: Ordering[B]): Option[(K, V)]

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

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

Источник@inline

final def mkString: String

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

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

Источник@inline

final def mkString(sep: String): String

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

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

Исходный код

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

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

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

Исходный код@deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")

def nonEmpty: Boolean

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

Исходный код

def orElse[A1 <: K, B1 >: V](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]

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

Исходный код

override def partition(p: (K, V) => Boolean): (AnyRefMap[K, V], AnyRefMap[K, V])

Исходный код

override def partitionMap[A1, A2](f: (K, V) => Either[A1, A2]): (Iterable[A1], Iterable[A2])

Исходный код

def product[B >: (K, V)](implicit num: Numeric[B]): B

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

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

Исходный код

def reduce[B >: (K, V)](op: (B, B) => B): B

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

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

Исходный код

def reduceLeft[B >: (K, V)](op: (B, (K, V)) => B): B

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

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

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

Исходный код

def reduceLeftOption[B >: (K, V)](op: (B, (K, V)) => B): Option[B]

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

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

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

Исходный код

def reduceOption[B >: (K, V)](op: (B, B) => B): Option[B]

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

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

Источник

def reduceRight[B >: (K, V)](op: ((K, V), B) => B): B

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

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

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

Источник

def reduceRightOption[B >: (K, V)](op: ((K, V), B) => B): Option[B]

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

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

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

Источник

def remove(key: K): Option[V]

Удаляет ключ из этого отображения, возвращая связанное с ним значение в виде значения Option.

Источник

def result(): AnyRefMap[K, V]

Источник

protected def reversed: Iterable[(K, V)]

Источник

def runWith[U](action: V => U): K => Boolean

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

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

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

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

Источник

def scan[B >: (K, V)](z: B)(op: (B, B) => B): Iterable[B]

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

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

Источник

override def scanLeft[B](z: B)(op: (B, (K, V)) => B): Iterable[B]

Источник

def scanRight[B](z: B)(op: ((K, V), B) => B): Iterable[B]

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

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

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

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

Пример:

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

Источник

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

Сравнивает размер этой коллекции типа Iterable с размером другой Iterable.

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

Источник

def sizeCompare(otherSize: Int): Int

Сравнивает размер этой коллекции типа Iterable со значением теста.

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

Источник

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

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

Источник

def sizeHint(size: Int): Unit

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

Источник

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

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

Источник @inline

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

Источник

def slice(from: Int, until: Int): AnyRefMap[K, V]

Источник

def sliding(size: Int, step: Int): Iterator[AnyRefMap[K, V]]

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

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

Источник

def sliding(size: Int): Iterator[AnyRefMap[K, V]]

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

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

Источник

override def span(p: (K, V) => Boolean): (AnyRefMap[K, V], AnyRefMap[K, V])

Источник

override def splitAt(n: Int): (AnyRefMap[K, V], AnyRefMap[K, V])

Источник

def stepper[S <: Stepper[_]](implicit shape: StepperShape[(K, V), S]): S

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

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

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

• Для коллекций Int, Short, Byte или Char, возвращается scala.collection.IntStepper

• Для коллекций Double или Float, возвращается scala.collection.DoubleStepper

• Для коллекций Long, возвращается scala.collection.LongStepper

• Для любого другого типа элементов, возвращается scala.collection.AnyStepper

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

Источник

def subtractAll(xs: IterableOnce[K]): AnyRefMap[K, V]

Удаляет все элементы, сгенерированные итератором, из этого сжимаемого набора.

Источник

def sum[B >: (K, V)](implicit num: Numeric[B]): B

Суммирует элементы этого набора.

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

Источник

def tail: AnyRefMap[K, V]

Остальная часть набора без его первого элемента.

Источник

def tails: Iterator[AnyRefMap[K, V]]

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

Источник

def take(n: Int): AnyRefMap[K, V]

Источник

override def takeRight(n: Int): AnyRefMap[K, V]

Набор, содержащий последние n элементы этого набора.

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

Источник

def takeWhile(p: (K, V) => Boolean): AnyRefMap[K, V]

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

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

Источник

override def tapEach[U](f: (K, V) => U): AnyRefMap[K, V]

Источник

def to[C1](factory: Factory[(K, V), C1]): C1

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

xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]

Источник

def toArray[B >: (K, V) : ClassTag]: Array[B]

Преобразует набор в массив.

Примечание реализации: НЕ вызывайте Array.from из этого метода.

Источник@inline

final def toBuffer[B >: (K, V)]: Buffer[B]

Источник

def toIndexedSeq: IndexedSeq[(K, V)]

Источник

def toList: List[(K, V)]

Источник

def toMap[K, V](implicit ev: (K, V) <:< (K, V)): Map[K, V]

Источник

def toSeq: Seq[(K, V)]

Источник

def toSet[B >: (K, V)]: Set[B]

Источник

override def toString(): String

Source

def toVector: Vector[(K, V)]

Source

def transpose[B](implicit asIterable: (K, V) => 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))

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

Source

def unapply(a: K): Option[V]

Попытка извлечь B из A в выражении сопоставления с образцом.

Source

override def unzip[A1, A2](implicit asPair: (K, V) => (A1, A2)): (Iterable[A1], Iterable[A2])

Source

override def unzip3[A1, A2, A3](implicit asTriple: (K, V) => (A1, A2, A3)): (Iterable[A1], Iterable[A2], Iterable[A3])

Source

def updateWith(key: K)(remappingFunction: Option[V] => Option[V]): Option[V]

Обновляет отображение для указанного ключа и его текущего значения, которое может быть опциональным (Some если есть текущее отображение, None если нет).

Если функция переопределения возвращает Some(v), отображение обновляется с новым значением v. Если функция переопределения возвращает None, отображение удаляется (или остается отсутствующим, если изначально отсутствовало). Если сама функция вызывает исключение, исключение повторно выводится, а текущее отображение остается без изменений.

Source

def valueStepper[S <: Stepper[_]](implicit shape: StepperShape[V, S]): S

Возвращает Stepper для значений этого отображения. См. метод stepper.

Source

def values: Iterable[V]

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

Source

override def view: MapView[K, V]

Source

def withDefault(d: K => V): Map[K, V]

То же отображение с заданной функцией по умолчанию. Примечание: значение по умолчанию используется только для apply. Другие методы, такие как get, contains, iterator, keys, и т. д., не затрагиваются withDefaultValue.

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

Source

def withDefaultValue(d: V): Map[K, V]

То же отображение со значением по умолчанию. Примечание: значение по умолчанию используется только для apply. Другие методы, такие как get, contains, iterator, keys, и т. д., не затрагиваются withDefaultValue.

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

Source

override def withFilter(p: (K, V) => Boolean): WithFilter[K, V, Iterable, Map]

Source

override def zip[B](that: IterableOnce[B]): Iterable[((K, V), B)]

Source

def zipAll[A1 >: (K, V), B](that: Iterable[B], thisElem: A1, thatElem: B): Iterable[(A1, B)]

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

Исходный код

override def zipWithIndex: Iterable[((K, V), Int)]