Spec-Zone.ru › Scala 3.1

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

Объект-компаньон • Исходный код

final class LongMap[V] extends AbstractMap[Long, V] with MapOps[Long, V, Map, LongMap[V]] with StrictOptimizedIterableOps[(Long, V), Iterable, LongMap[V]] with Serializable

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

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

Карты с открытым адресованием могут стать менее эффективными при поиске после многократного добавления/удаления элементов. Хотя LongMap делает хорошую попытку оставаться эффективными независимо, вызов repack для карты, которая больше не будет использоваться для удаления элементов, но будет интенсивно использоваться, может сэкономить и время, и место в памяти.

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

Типы-супертипы
28 типов
Интерфейс Serializable
Тракт StrictOptimizedIterableOps[(Long, V), Iterable, LongMap[V]]
Класс AbstractMap[Long, V]
Тракт Map[Long, V]
Тракт MapOps[Long, V, Map, LongMap[V]]
Тракт Shrinkable[Long]
Тракт Builder[(Long, V), LongMap[V]]
Тракт Growable[(Long, V)]
Тракт Clearable
Тракт Cloneable[LongMap[V]]
Тракт Cloneable
Тракт Iterable[(Long, V)]
Класс AbstractMap[Long, V]
Тракт Map[Long, V]
Тракт Equals
Тракт MapFactoryDefaults[Long, V, Map, Iterable]
Тракт MapOps[Long, V, Map, LongMap[V]]
Тракт PartialFunction[Long, V]
Тракт Long => V
Класс AbstractIterable[(Long, V)]
Тракт Iterable[(Long, V)]
Тракт IterableFactoryDefaults[(Long, V), Iterable]
Тракт IterableOps[(Long, V), Iterable, LongMap[V]]
Тракт IterableOnceOps[(Long, V), Iterable, LongMap[V]]
Тракт IterableOnce[(Long, V)]
Класс Object
Тракт Matchable
Класс Any

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

Исходный код
def this()

Исходный код
def this(defaultEntry: Long => V)

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

Исходный код
def this(initialBufferSize: Int)

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

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

Исходный код
def this(defaultEntry: Long => V, initialBufferSize: Int)

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

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

Исходный код
override def ++[V1 >: V](xs: IterableOnce[(Long, V1)]): LongMap[V1]

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

Исходный код@inline
final def addOne(key: Long, value: V): LongMap[V]

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

Исходный код@inline
final override def addOne(kv: (Long, V)): LongMap[V]

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

Исходный код
override def apply(key: Long): V

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

Классы-определения MapOps -> Function1

Исходный код
override def clone(): LongMap[V]

Классы-определения MapOps -> Cloneable -> Object

Исходный код
def collect[V2](pf: PartialFunction[(Long, V), (Long, V2)]): LongMap[V2]

Исходный код
override def concat[V1 >: V](xs: IterableOnce[(Long, V1)]): LongMap[V1]

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

Исходный код
override def contains(key: Long): Boolean

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

Исходный код
override def default(key: Long): V

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

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

Исходный код
override def empty: LongMap[V]

Definition Classes MapFactoryDefaults -> IterableFactoryDefaults -> IterableOps

Источник
def flatMap[V2](f: (Long, V) => IterableOnce[(Long, V2)]): LongMap[V2]

Источник
override def foreach[U](f: (Long, V) => U): Unit

Definition Classes IterableOnceOps

Источник
override def foreachEntry[U](f: (Long, V) => U): Unit

Definition Classes MapOps

Источник
def foreachKey[A](f: Long => A): Unit

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

Источник
def foreachValue[A](f: V => A): Unit

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

Источник
override def get(key: Long): Option[V]

Definition Classes MapOps

Источник
override def getOrElse[V1 >: V](key: Long, default: => V1): V1

Definition Classes MapOps

Источник
override def getOrElseUpdate(key: Long, defaultValue: => V): V

Definition Classes MapOps

Источник
def getOrNull(key: Long): V

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

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

Источник
override def isEmpty: Boolean

Definition Classes IterableOnceOps

Источник
def iterator: Iterator[(Long, V)]

Источник
override def keysIterator: Iterator[Long]

Definition Classes MapOps

Источник
override def knownSize: Int

Definition Classes MapOps -> Growable -> IterableOnce

Источник
def map[V2](f: (Long, V) => (Long, V2)): LongMap[V2]

Источник
def mapValuesNow[V1](f: V => V1): LongMap[V1]

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

Источник
override def put(key: Long, value: V): Option[V]

Definition Classes MapOps

Источник
def repack(): Unit

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

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

Источник
override def size: Int

Definition Classes IterableOnceOps

Источник
def subtractOne(key: Long): LongMap[V]

Источник
def transformValuesInPlace(f: V => V): LongMap[V]

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

Источник
override def update(key: Long, value: V): Unit

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

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

Definition Classes MapOps

Источник
override def valuesIterator: Iterator[V]

Definition Classes MapOps

Inherited methods

Источник@inline
final def ++[B >: (Long, V)](suffix: IterableOnce[B]): Iterable[B]

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

Inherited from IterableOps

Источник@inline
final def ++=(xs: IterableOnce[(Long, V)]): LongMap[V]

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

Inherited from Growable

Источник@inline
final def +=(elem: (Long, V)): LongMap[V]

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

Inherited from Growable
END_OF_DOCUMENT_MARKER

Источник@inline
final def --=(xs: IterableOnce[Long]): LongMap[V]

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

Унаследовано от Shrinkable

Источник@inline
final def -=(elem: Long): LongMap[V]

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

Унаследовано от Shrinkable

Источник
def addAll(xs: IterableOnce[(Long, V)]): LongMap[V]

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

Параметры
xs

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

Возвращает

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

Унаследовано от Growable

Источник@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
Параметры
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

Источник
override def addString(sb: StringBuilder, start: String, sep: String, end: String): StringBuilder

Классы-предки MapOps -> IterableOnceOps
Унаследовано от MapOps

Источник
def andThen[C](k: PartialFunction[V, C]): PartialFunction[Long, C]

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

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

Параметры типов
C

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

Параметры
k

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

Возвращает

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

Унаследовано от PartialFunction

Источник
override def andThen[C](k: V => C): PartialFunction[Long, C]

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

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

Параметры типов
C

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

Параметры
k

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

Возвращает

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

Классы-предки PartialFunction -> Function1
Унаследовано от PartialFunction

Источник
override def applyOrElse[K1 <: Long, V1 >: V](x: K1, default: K1 => V1): V1

Классы-предки MapOps -> PartialFunction
Унаследовано от MapOps

Источник
def canEqual(that: Any): Boolean

Унаследовано от Map

Источник
def clear(): Unit

Унаследовано от MapOps

Источник
override def collect[B](pf: PartialFunction[(Long, V), B]): Iterable[B]

Классы-предки StrictOptimizedIterableOps -> IterableOps -> IterableOnceOps
Унаследовано от StrictOptimizedIterableOps

Источник
def collect[K2, V2](pf: PartialFunction[(Long, V), (K2, V2)]): Map[K2, V2]

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

Параметры типов
K2

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

V2

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

Параметры
pf

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

Возвращает

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

Унаследовано от MapOps
END_OF_DOCUMENT_MARKER

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

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

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

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

Параметры значения
pf

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

Возвращает

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

Пример

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

Унаследовано от IterableOnceOps

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

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

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

Параметры типа
R

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

Параметры значения
k

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

Возвращает

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

Унаследовано от PartialFunction

Source@unspecialized
def compose[A](g: A => Long): A => V

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

Параметры типа
A

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

Параметры значения
g

функция A => T1

Возвращает

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

Унаследовано от Function1

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

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

Параметры типа
B

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

Параметры значения
suffix

сцепляемая коллекция.

Возвращает

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

Унаследовано от IterableOps

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

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

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

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

Параметры типа
B

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

Параметры значения
len

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

start

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

xs

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

Возвращает

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

Примечание

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

Унаследовано от IterableOnceOps

Источник@deprecatedOverriding("Это должно всегда перенаправлять на 3-аргументную версию этого метода", since = "2.13.4")
def copyToArray[B >: (Long, V)](xs: Array[B], start: Int): Int

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

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

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

Параметры типа
B

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

Параметры значения
start

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

xs

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

Возвращает

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

Примечание

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

Унаследовано от IterableOnceOps

Источник@deprecatedOverriding("Это должно всегда перенаправлять на 3-аргументную версию этого метода", since = "2.13.4")
def copyToArray[B >: (Long, V)](xs: Array[B]): Int

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

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

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

Параметры типа
B

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

Параметры значения
xs

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

Возвращает

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

Примечание

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

Унаследовано от IterableOnceOps

Источник
def corresponds[B](that: IterableOnce[B])(p: ((Long, V), B) => Boolean): Boolean

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

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

Параметры типа
B

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

Параметры значения
p

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

that

другой набор

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def count(p: (Long, V) => Boolean): Int

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

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

Параметры значения
p

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def drop(n: Int): LongMap[V]

Унаследовано от IterableOps

Источник
override def dropRight(n: Int): LongMap[V]

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

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

Классы определения StrictOptimizedIterableOps -> IterableOps
Унаследовано от StrictOptimizedIterableOps

Источник
def dropWhile(p: (Long, V) => Boolean): LongMap[V]

Унаследовано от IterableOps

Источник
def elementWise: ElementWiseExtractor[Long, 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
}
Унаследовано от PartialFunction

Источник
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
Параметры значения
o

Карта, с которой сравнивается эта карта

Возвращает

true если две карты равны в соответствии с описанием

Классы определения Map -> Equals -> Any
Унаследовано от Map

Источник
def exists(p: (Long, V) => Boolean): Boolean

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

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

Параметры значения
p

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник
override def filter(pred: (Long, V) => Boolean): LongMap[V]

Классы определения StrictOptimizedIterableOps -> IterableOps -> IterableOnceOps
Унаследовано от StrictOptimizedIterableOps

Источник
def filterInPlace(p: (Long, V) => Boolean): LongMap[V]

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

Параметры значения
p

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

Унаследовано от MapOps

Источник
override def filterNot(pred: (Long, V) => Boolean): LongMap[V]

Классы определения StrictOptimizedIterableOps -> IterableOps -> IterableOnceOps
Унаследовано от StrictOptimizedIterableOps

Источник
def find(p: (Long, V) => Boolean): Option[(Long, V)]

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

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

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

Параметры значения
p

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник
override def flatMap[B](f: (Long, V) => IterableOnce[B]): Iterable[B]

Классы определения StrictOptimizedIterableOps -> IterableOps -> IterableOnceOps
Унаследовано от StrictOptimizedIterableOps

Источник
def flatMap[K2, V2](f: (Long, V) => IterableOnce[(K2, V2)]): Map[K2, V2]

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

Параметры значения
f

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

Возвращает

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

Унаследовано от MapOps

Источник
override def flatten[B](implicit toIterableOnce: (Long, V) => IterableOnce[B]): Iterable[B]

Definition Classes StrictOptimizedIterableOps -> IterableOps -> IterableOnceOps
Inherited from StrictOptimizedIterableOps

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

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

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

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

Type parameters
A1

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

Value parameters
op

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

z

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

Returns

результат применения оператора fold op между всеми элементами и z, или z, если этот набор данных пуст.

Inherited from IterableOnceOps

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

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

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

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

Type parameters
B

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

Value parameters
op

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

z

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

Returns

результат вставки op между последовательными элементами этого набора данных слева направо с начальным значением z слева: op(...op(z, x1), x2, ..., xn), где x1, ..., xn — элементы этого набора данных. Возвращает z, если этот набор данных пуст.

Inherited from IterableOnceOps

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

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

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

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

Type parameters
B

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

Value parameters
op

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

z

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

Returns

результат вставки op между последовательными элементами этого набора данных справа налево с начальным значением z справа: op(x1, op(x2, ... op(xn, z)...)), где x1, ..., xn — элементы этого набора данных. Возвращает z, если этот набор данных пуст.

Inherited from IterableOnceOps

Source
def forall(p: (Long, V) => Boolean): Boolean

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

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

Value parameters
p

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

Returns

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

Inherited from IterableOnceOps

Source
def groupBy[K](f: (Long, V) => K): Map[K, LongMap[V]]

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

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

Параметры типа
K

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

Параметры значения
f

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

Возвращает

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

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

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

Унаследовано от IterableOps

Источник
def groupMap[K, B](key: (Long, V) => K)(f: (Long, 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)

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

Параметры типа
B

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

K

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

Параметры значения
f

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

key

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

Унаследовано от IterableOps

Источник
def groupMapReduce[K, B](key: (Long, V) => K)(f: (Long, 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)(_ + _)

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

Унаследовано от IterableOps

Источник
def grouped(size: Int): Iterator[LongMap[V]]

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

Параметры значения
size

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

Возвращает

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

См. также

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

Унаследовано от IterableOps

Источник
override def hashCode(): Int

Классы-предки Map -> Any
Унаследовано от Map

Источник
def head: (Long, V)

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

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

Возвращает

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

Исключение
NoSuchElementException

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

Унаследовано от IterableOps

Источник
def headOption: Option[(Long, V)]

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

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

Возвращает

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

Унаследовано от IterableOps

Источник
def init: LongMap[V]

Часть набора без последнего элемента.

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

Унаследовано от IterableOps

Источник
def inits: Iterator[LongMap[V]]

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

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

Возвращает

итератор по всем начальным частям этого итерируемого набора

Пример

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

Унаследовано от IterableOps

Источник
def isDefinedAt(key: Long): Boolean

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

Параметры
key

ключ

Возвращает

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

Унаследовано от MapOps

Источник
override def isTraversableAgain: Boolean

Классы-определения IterableOps -> IterableOnceOps
Унаследовано от IterableOps

Источник
override def iterableFactory: IterableFactory[Iterable]

Классы-определения Iterable -> Iterable -> IterableOps
Унаследовано от Iterable

Источник
def keySet: Set[Long]

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

Возвращает

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

Унаследовано от MapOps

Источник
def keyStepper[S <: Stepper[_]](implicit shape: StepperShape[Long, S]): S

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

Унаследовано от MapOps

Источник
def keys: Iterable[Long]

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

Возвращает

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

Унаследовано от MapOps

Источник
def last: (Long, V)

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

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

Возвращает

Последний элемент этого итерируемого набора.

Исключение
NoSuchElementException

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

Унаследовано от IterableOps

Источник
def lastOption: Option[(Long, V)]

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

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

Возвращает

последний элемент этого итерируемого набора, если он не пустой, None если он пустой.

Унаследовано от IterableOps

Источник
def lazyZip[B](that: Iterable[B]): LazyZip2[(Long, V), B, LongMap[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)
Параметры типа
B

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

Параметры
that

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

Возвращает

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

Унаследовано от Iterable

Источник
def lift: Long => Option[V]

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

Возвращает

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

См. также

Function.unlift

Унаследовано от PartialFunction

Источник
override def map[B](f: (Long, V) => B): Iterable[B]

Классы-определения StrictOptimizedIterableOps -> IterableOps -> IterableOnceOps
Унаследовано от StrictOptimizedIterableOps

Источник
def map[K2, V2](f: (Long, V) => (K2, V2)): Map[K2, V2]

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

Параметры значения
f

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

Возвращает

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

Унаследовано от MapOps

Источник
override def mapFactory: MapFactory[Map]

Классы-предки Map -> Map -> MapOps
Унаследовано от Map

Источник
def mapResult[NewTo](f: LongMap[V] => NewTo): Builder[(Long, V), NewTo]

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

Унаследовано от Builder

Источник
def mapValuesInPlace(f: (Long, V) => V): LongMap[V]

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

Параметры значения
f

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

Возвращает

сама карта.

Унаследовано от MapOps

Источник
def max[B >: (Long, V)](implicit ord: Ordering[B]): (Long, V)

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

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

Параметры типа
B

Тип, над которым определено упорядочение.

Параметры значения
ord

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

Возвращает

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

Исключения
UnsupportedOperationException

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

Унаследовано от IterableOnceOps

Источник
def maxBy[B](f: (Long, V) => B)(implicit cmp: Ordering[B]): (Long, V)

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

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

Параметры типа
B

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

Параметры значения
cmp

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

f

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

Возвращает

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

Исключения
UnsupportedOperationException

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

Унаследовано от IterableOnceOps

Источник
def maxByOption[B](f: (Long, V) => B)(implicit cmp: Ordering[B]): Option[(Long, V)]

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

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

Параметры типа
B

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

Параметры значения
cmp

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

f

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def maxOption[B >: (Long, V)](implicit ord: Ordering[B]): Option[(Long, V)]

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

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

Параметры типа
B

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

Параметры значения
ord

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def min[B >: (Long, V)](implicit ord: Ordering[B]): (Long, V)

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

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

Параметры типа
B

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

Параметры значения
ord

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

Возвращает

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

Исключения
UnsupportedOperationException

если этот набор пуст.

Унаследовано от IterableOnceOps

Источник
def minBy[B](f: (Long, V) => B)(implicit cmp: Ordering[B]): (Long, V)

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

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

Параметры типа
B

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

Параметры значения
cmp

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

f

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

Возвращает

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

Исключения
UnsupportedOperationException

если этот набор пуст.

Унаследовано от IterableOnceOps

Источник
def minByOption[B](f: (Long, V) => B)(implicit cmp: Ordering[B]): Option[(Long, V)]

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

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

Параметры типа
B

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

Параметры значения
cmp

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

f

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def minOption[B >: (Long, V)](implicit ord: Ordering[B]): Option[(Long, V)]

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

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

Параметры типа
B

Тип, над которым определяется порядок.

Параметры значения
ord

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник@inline
final def mkString: String

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

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник@inline
final def mkString(sep: String): String

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

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

Параметры значения
sep

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

Возвращает

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

Пример

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

Унаследовано от IterableOnceOps

Источник
final def mkString(start: String, sep: String, end: String): String

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

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

Параметры значения
end

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

sep

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

start

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

Возвращает

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

Пример

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

Унаследовано от IterableOnceOps

Источник@deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")
def nonEmpty: Boolean

Проверяет, не является ли набор пустым.

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def orElse[A1 <: Long, B1 >: V](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]

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

Параметры типа
A1

тип аргумента функции-заместителя

B1

тип результата функции-заместителя

Параметры значения
that

функция-заместитель

Возвращает

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

Унаследовано от PartialFunction

Источник
override def partition(p: (Long, V) => Boolean): (LongMap[V], LongMap[V])

Классы-предки StrictOptimizedIterableOps -> IterableOps
Унаследовано от StrictOptimizedIterableOps

Источник
override def partitionMap[A1, A2](f: (Long, V) => Either[A1, A2]): (Iterable[A1], Iterable[A2])

Классы-предки StrictOptimizedIterableOps -> IterableOps
Унаследовано от StrictOptimizedIterableOps

Источник
def product[B >: (Long, V)](implicit num: Numeric[B]): B

Произведение элементов этого набора.

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

Параметры типа
B

тип результата операции *.

Параметры значения
num

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def reduce[B >: (Long, V)](op: (B, B) => B): B

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

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

Параметры типа
B

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

Параметры значения
op

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

Возвращает

Результат применения оператора reduce op между всеми элементами, если набор не пустой.

Исключения
UnsupportedOperationException

если этот набор пустой.

Унаследовано от IterableOnceOps

Источник
def reduceLeft[B >: (Long, V)](op: (B, (Long, V)) => B): B

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

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

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

Параметры типа
B

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

Параметры значения
op

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

Возвращает

результат вставки op между последовательными элементами этого набора, слева направо: op( op( ... op(x1, x2) ..., xn-1), xn), где x1, ..., xn — элементы этого набора.

Исключения
UnsupportedOperationException

если этот набор пустой.

Унаследовано от IterableOnceOps

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

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

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

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

Параметры типа
B

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

Параметры значения
op

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

Возвращаемое значение

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

Унаследовано от IterableOnceOps

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

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

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

Параметры типа
B

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

Параметры значения
op

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

Возвращаемое значение

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

Унаследовано от IterableOnceOps

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

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

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

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

Параметры типа
B

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

Параметры значения
op

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

Возвращаемое значение

результат вставки op между последовательными элементами этой коллекции, двигаясь справа налево: op(x1, op(x2, ..., op(xn-1, xn)...)) где x1, ..., xn являются элементами этой коллекции.

Исключения
UnsupportedOperationException

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

Унаследовано от IterableOnceOps

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

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

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

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

Параметры типа
B

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

Параметры значения
op

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

Возвращаемое значение

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

Унаследовано от IterableOnceOps

Source
def remove(key: Long): Option[V]

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

Параметры значения
key

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

Возвращаемое значение

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

Унаследовано от MapOps

Source
def result(): LongMap[V]

Inherited from MapOps

Source
protected def reversed: Iterable[(Long, V)]

Inherited from IterableOnceOps

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

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

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

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

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

Параметры значения
action

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

Возвращает

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

См. также

applyOrElse.

Inherited from PartialFunction

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

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

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

Параметры типа
B

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

Параметры значения
op

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

z

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

Возвращает

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

Inherited from IterableOps

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

Классы определения StrictOptimizedIterableOps -> IterableOps -> IterableOnceOps
Inherited from StrictOptimizedIterableOps

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

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

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

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

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

Пример:

List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)
Параметры типа
B

тип элементов в результирующем наборе

Параметры значения
op

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

z

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

Возвращает

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

Унаследовано от IterableOps

Источник
def sizeCompare(that: Iterable[_]): Int

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

Параметры значения
that

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

Возвращает

Значение 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.

Унаследовано от IterableOps

Источник
def sizeCompare(otherSize: Int): Int

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

Параметры значения
otherSize

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

Возвращает

Значение 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.

См. также

sizeIs

Унаследовано от IterableOps

Источник
final def sizeHint(coll: IterableOnce[_], delta: Int): Unit

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

Параметры значения
coll

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

delta

поправка для добавления к размеру подсказки.

Унаследовано от Builder

Источник
def sizeHint(size: Int): Unit

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

Параметры значения
size

подсказка о количестве добавляемых элементов.

Унаследовано от Builder

Источник
final def sizeHintBounded(size: Int, boundingColl: Iterable[_]): Unit

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

Параметры значения
boundingColl

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

size

подсказка о количестве добавляемых элементов.

Унаследовано от Builder

Источник@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
Унаследовано от IterableOps

Источник
def slice(from: Int, until: Int): LongMap[V]

Унаследовано от IterableOps

Источник
def sliding(size: Int, step: Int): Iterator[LongMap[V]]

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

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

Параметры значения
size

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

step

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

Возвращает

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

См. также

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

Пример

List(1, 2, 3, 4, 5).sliding(2, 2) = Iterator(List(1, 2), List(3, 4), List(5))

List(1, 2, 3, 4, 5, 6).sliding(2, 3) = Iterator(List(1, 2), List(4, 5))

Унаследовано от IterableOps

Источник
def sliding(size: Int): Iterator[LongMap[V]]

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

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

Параметры значения
size

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

Возвращает

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

См. также

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

Пример

List().sliding(2) = empty iterator

List(1).sliding(2) = Iterator(List(1))

List(1, 2).sliding(2) = Iterator(List(1, 2))

List(1, 2, 3).sliding(2) = Iterator(List(1, 2), List(2, 3))

Унаследовано от IterableOps

Источник
override def span(p: (Long, V) => Boolean): (LongMap[V], LongMap[V])

Классы определений StrictOptimizedIterableOps -> IterableOps -> IterableOnceOps
Унаследовано от StrictOptimizedIterableOps
END_OF_DOCUMENT_MARKER

Источник
override def splitAt(n: Int): (LongMap[V], LongMap[V])

Классы-определения IterableOps -> IterableOnceOps
Унаследовано от IterableOps

Источник
def stepper[S <: Stepper[_]](implicit shape: StepperShape[(Long, 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 можно преобразовывать только в последовательные потоки.

Унаследовано от IterableOnce

Источник
def subtractAll(xs: IterableOnce[Long]): LongMap[V]

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

Параметры значения
xs

итератор, генерирующий элементы для удаления.

Возвращает

сам уменьшаемый набор

Унаследовано от Shrinkable

Источник
def sum[B >: (Long, V)](implicit num: Numeric[B]): B

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

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

Параметры типа
B

тип результата оператора +.

Параметры значения
num

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

Возвращает

сумма всех элементов этого набора по отношению к оператору + в num.

Унаследовано от IterableOnceOps

Источник
def tail: LongMap[V]

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

Унаследовано от IterableOps

Источник
def tails: Iterator[LongMap[V]]

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

Возвращает

итератор по всем хвостам этого итерируемого набора

Пример

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

Унаследовано от IterableOps

Источник
def take(n: Int): LongMap[V]

Унаследовано от IterableOps

Источник
override def takeRight(n: Int): LongMap[V]

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

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

Классы-определения StrictOptimizedIterableOps -> IterableOps
Унаследовано от StrictOptimizedIterableOps

Источник
def takeWhile(p: (Long, V) => Boolean): LongMap[V]

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

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

Параметры значения
p

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

Возвращает

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

Унаследовано от IterableOps

Источник
override def tapEach[U](f: (Long, V) => U): LongMap[V]

Классы-определения StrictOptimizedIterableOps -> IterableOps -> IterableOnceOps
Унаследовано от StrictOptimizedIterableOps

Источник
def to[C1](factory: Factory[(Long, V), C1]): C1

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

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

Унаследовано от IterableOnceOps

Источник
def toArray[B >: (Long, V) : ClassTag]: Array[B]

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

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

Унаследовано от IterableOnceOps

Источник@inline
final def toBuffer[B >: (Long, V)]: Buffer[B]

Унаследовано от IterableOnceOps

Источник
def toIndexedSeq: IndexedSeq[(Long, V)]

Унаследовано от IterableOnceOps

Источник
def toList: List[(Long, V)]

Наследуется от IterableOnceOps

Источник
def toMap[K, V](implicit ev: (Long, V) <:< (K, V)): Map[K, V]

Наследуется от IterableOnceOps

Источник
def toSeq: Seq[(Long, V)]

Возвращает

Это коллекция в виде Seq[A]. Это эквивалентно to(Seq), но может быть быстрее.

Наследуется от IterableOnceOps

Источник
def toSet[B >: (Long, V)]: Set[B]

Наследуется от IterableOnceOps

Источник
override def toString(): String

Определяющие классы Map -> Function1 -> Iterable -> Any
Наследуется от Map

Источник
def toVector: Vector[(Long, V)]

Наследуется от IterableOnceOps

Источник
def transpose[B](implicit asIterable: (Long, 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))

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

Параметры типа
B

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

Параметры значения
asIterable

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

Возвращает

двумерная итерируемая коллекция итерируемых коллекций, у которой n-я строка является n-м столбцом этой итерируемой коллекции.

Исключения
IllegalArgumentException

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

Наследуется от IterableOps

Источник
def unapply(a: Long): Option[V]

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

Наследуется от PartialFunction

Источник
override def unzip[A1, A2](implicit asPair: (Long, V) => (A1, A2)): (Iterable[A1], Iterable[A2])

Определяющие классы StrictOptimizedIterableOps -> IterableOps
Наследуется от StrictOptimizedIterableOps

Источник
override def unzip3[A1, A2, A3](implicit asTriple: (Long, V) => (A1, A2, A3)): (Iterable[A1], Iterable[A2], Iterable[A3])

Определяющие классы StrictOptimizedIterableOps -> IterableOps
Наследуется от StrictOptimizedIterableOps

Источник
def updateWith(key: Long)(remappingFunction: Option[V] => Option[V]): Option[V]

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

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

Параметры значения
key

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

remappingFunction

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

Возвращает

новое значение, связанное с указанным ключом

Наследуется от MapOps

Источник
def valueStepper[S <: Stepper[_]](implicit shape: StepperShape[V, S]): S

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

Наследуется от MapOps

Источник
def values: Iterable[V]

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

Возвращает

значения этого отображения в виде итерируемой коллекции.

Наследуется от MapOps

Источник
override def view: MapView[Long, V]

Определяющие классы MapOps -> IterableOps
Наследуется от MapOps

Источник
def withDefault(d: Long => V): Map[Long, V]

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

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

Параметры значения
d

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

Возвращает

обёртка отображения со значением по умолчанию

Наследуется от Map

Источник
def withDefaultValue(d: V): Map[Long, V]

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

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

Параметры значения
d

значение по умолчанию, используемое для отсутствующих ключей

Возвращает

обёртка отображения со значением по умолчанию

Наследуется от Map
END_OF_DOCUMENT_MARKER

Источник
override def withFilter(p: (Long, V) => Boolean): WithFilter[Long, V, Iterable, Map]

Классы-определения MapFactoryDefaults -> IterableOps
Унаследовано от MapFactoryDefaults

Источник
override def zip[B](that: IterableOnce[B]): Iterable[((Long, V), B)]

Классы-определения StrictOptimizedIterableOps -> IterableOps
Унаследовано от StrictOptimizedIterableOps

Источник
def zipAll[A1 >: (Long, V), B](that: Iterable[B], thisElem: A1, thatElem: B): Iterable[(A1, B)]

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

Параметры-значения
that

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

thatElem

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

thisElem

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

Возвращает

новую коллекцию типа That, содержащую пары, состоящие из соответствующих элементов этой итерабельной коллекции и that. Длина возвращаемой коллекции — максимальная из длин этой итерабельной коллекции и that. Если эта итерабельная коллекция короче that, используются значения thisElem для заполнения результата. Если that короче этой итерабельной коллекции, используются значения thatElem для заполнения результата.

Унаследовано от IterableOps

Источник
override def zipWithIndex: Iterable[((Long, V), Int)]

Классы-определения StrictOptimizedIterableOps -> IterableOps -> IterableOnceOps
Унаследовано от StrictOptimizedIterableOps

© 2002-2022 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://scala-lang.org/api/3.1.1/scala/collection/mutable/LongMap.html

Spec-Zone.ru

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