Тракт scala.collection.immutable.MapLike

trait MapLike[K, +V, +This <: MapLike[K, V, This] with Map[K, V]] extends collection.MapLike[K, V, This] with Parallelizable[(K, V), ParMap[K, V]]

Обобщённый шаблон для неизменяемых карт от ключей типа K до значений типа V. Чтобы реализовать конкретную карту, необходимо предоставить реализации следующих методов (где This — тип фактической реализации карты):

def get(key: K): Option[V]
def iterator: Iterator[(K, V)]
def + [V1 >: V](kv: (K, V)): Map[K, V1]
def - (key: K): This

Если вы хотите, чтобы методы преобразования, такие как take, drop, filter возвращали тот же тип карты, вы также должны переопределить:

def empty: This

Также рекомендуется переопределить методы foreach и size для повышения эффективности.

K: тип ключей, содержащихся в этой коллекции.
V: тип значений, связанных с ключами.
This: Тип фактической реализации карты.

Self Type: MapLike[K, V, This]
Source: MapLike.scala
Since: 2.8

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

Известные подклассы

Члены типа

класс DefaultKeySet extends AbstractSet[K] with Set[K] with Serializable

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

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

класс DefaultValuesIterable extends AbstractIterable[V] with Iterable[V] with Serializable

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

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

класс FilteredKeys extends AbstractMap[K, V] with DefaultMap[K, V]

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

класс MappedValues[W] extends AbstractMap[K, W] with DefaultMap[K, W]

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

класс WithFilter extends FilterMonadic[A, Repr]

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

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

класс ImmutableDefaultKeySet extends DefaultKeySet with Set[K]

Атрибуты: protected

тип Self = This

Тип, реализующий этот итерируемый объект

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

Абстрактные члены значения

абстрактный def +[V1 >: V](kv: (K, V1)): Map[K, V1]

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

V1: тип значения в паре ключ/значение.
kv: пара ключ/значение.
возвращает: Новая карта с новым связыванием, добавленным в эту карту.

Определяющие классы: MapLike → MapLike → GenMapLike

абстрактный def empty: This

Пустая карта того же типа, что и эта карта

возвращает: пустая карта типа This.

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

абстрактный def get(key: K): Option[V]

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

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

Определяющие классы: MapLike → GenMapLike

абстрактный def iterator: Iterator[(K, V)]

Создает новый итератор по всем парам ключ/значение этой карты

возвращает: новый итератор

Определяющие классы: MapLike → IterableLike → GenIterableLike

абстрактный def seq: collection.Map[K, V]

Определяющие классы: GenMapLike → Parallelizable → GenTraversableOnce

Члены-значения в конкретном виде

final def !=(arg0: Any): Boolean

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

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

Definition Classes: AnyRef → Any

final def ##(): Int

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

returns: значение хэша, соответствующее ==

Definition Classes: AnyRef → Any

def +[V1 >: V](elem1: (K, V1), elem2: (K, V1), elems: (K, V1)*): Map[K, V1]

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

V1: тип добавляемых значений
elem1: первый добавляемый элемент.
elem2: второй добавляемый элемент.
elems: остальные добавляемые элементы.
returns: Новое множество с добавленными связями к этому множеству.

Definition Classes: MapLike → MapLike

def ++[V1 >: V](xs: GenTraversableOnce[(K, V1)]): Map[K, V1]

Добавляет множество элементов, предоставленных объектом прохода, и возвращает новое множество с добавленными элементами.

V1: тип добавляемых значений
xs: объект прохода, состоящий из пар ключ-значение.
returns: новое неизменяемое множество со связями этого множества и теми, которые из xs.

Definition Classes: MapLike → MapLike

def ++[B >: (K, V), That](that: GenTraversableOnce[B])(implicit bf: CanBuildFrom[This, B, That]): That

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

B: тип элемента возвращаемого множества.
That: класс возвращаемого множества. В возможном случае, тот же класс, что и текущий класс коллекции, но это зависит от того, является ли тип элемента допустимым для этого класса, что означает, что найден неявный экземпляр типа CanBuildFrom.
that: множество для добавления.
bf: неявное значение класса CanBuildFrom, которое определяет класс результата по текущему типу представления и новому типу элемента.
returns: новое множество типа That, которое содержит все элементы этого множества, после всех элементов that.

Definition Classes: TraversableLike → GenTraversableLike

def ++:[B >: (K, V), That](that: collection.Traversable[B])(implicit bf: CanBuildFrom[This, B, That]): That

Как и ++, возвращает новую коллекцию, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда.

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

Пример:

scala> val x = List(1)
x: List[Int] = List(1)

scala> val y = LinkedList(2)
y: scala.collection.mutable.LinkedList[Int] = LinkedList(2)

scala> val z = x ++: y
z: scala.collection.mutable.LinkedList[Int] = LinkedList(1, 2)

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

Поскольку у TraversableOnce нет метода ++, нам нужно реализовать его напрямую, но Traversable и ниже могут использовать перегрузку.

B: тип элементов возвращаемой коллекции.
That: класс возвращаемой коллекции. По возможности, That — это тот же класс, что и текущий класс коллекции Repr, но это зависит от того, является ли тип элемента B допустимым для этого класса, что означает, что найдено неявное экземпляр типа CanBuildFrom[Repr, B, That].
that: объект для добавления.
bf: неявное значение класса CanBuildFrom, которое определяет класс результата That из текущего типа представления Repr и нового типа элемента B.
возвращает: новую коллекцию типа That, содержащую все элементы этой коллекции, за которыми следуют все элементы that.

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

def ++:[B](that: TraversableOnce[B]): Map[B]

[пример использования]

Пример:

scala> val x = List(1)
x: List[Int] = List(1)

scala> val y = LinkedList(2)
y: scala.collection.mutable.LinkedList[Int] = LinkedList(2)

scala> val z = x ++: y
z: scala.collection.mutable.LinkedList[Int] = LinkedList(1, 2)

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

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

def -(elem1: K, elem2: K, elems: K*): This

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

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

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

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

abstract def -(key: K): collection.Map[K, V]

[пример использования]

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

key: ключ для удаления
возвращает: новую карту без связывания для key

Классы определений: MapLike → Subtractable → GenMapLike

def --(xs: GenTraversableOnce[K]): This

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

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

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

def ->[B](y: B): (MapLike[K, V, This], B)

Неявный: Этот член добавлен неявным преобразованием из MapLike[K, V, This] в ArrowAssoc[MapLike[K, V, This]] с помощью метода ArrowAssoc в scala.Predef.
Классы определений: ArrowAssoc
Аннотации: @inline()

def /:[B](z: B)(op: (B, (K, V)) ⇒ B): B

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

Примечание: /: — это альтернативная запись для foldLeft; z /: xs — то же самое, что и xs foldLeft z.

Примеры:

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

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

scala> val b = (5 /: a)(_+_)
b: Int = 15

scala> val c = (5 /: a)((x,y) => x + y)
c: Int = 15

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

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

B

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

z

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

op

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

возвращает

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

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

где x₁, ..., x_n — это элементы этого итерируемого объекта или итератора.

Определяющие классы: TraversableOnce → GenTraversableOnce

def :\[B](z: B)(op: ((K, V), B) ⇒ B): B

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

Примечание: :\ — это альтернативная запись для foldRight; xs :\ z — то же самое, что и xs foldRight z.

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

Примеры:

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

scala> val b = (a :\ 5)(_+_)
b: Int = 15

scala> val c = (a :\ 5)((x,y) => x + y)
c: Int = 15

B

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

z

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

op

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

возвращает

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

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

где x₁, ..., x_n — это элементы этого итерируемого объекта или итератора.

Определяющие классы: TraversableOnce → GenTraversableOnce

final def ==(arg0: Any): Boolean

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

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

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

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

Добавляет все пары (ключ-значение) этой карты в строковый буфер, используя начальную, конечную и разделительные строки. Запись текста начинается со строки start и заканчивается строкой end. Между значениями пар (ключ-значение) этой карты, представленными в виде key -> value, вставляется строка sep.

b: буфер, в который добавляются строки.
start: начальная строка.
sep: разделительная строка.
end: конечная строка.
возвращает: строковый буфер b, в который были добавлены элементы.

Определяющие классы: MapLike → TraversableOnce

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, в который были добавлены элементы.

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

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, в который были добавлены элементы.

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

def aggregate[B](z: ⇒ B)(seqop: (B, (K, V)) ⇒ B, combop: (B, B) ⇒ B): B

Агрегирует результаты применения оператора к последующим элементам.

Это более общий вид fold и reduce. Он похож на foldLeft, так как не требует, чтобы результат был супертипом типа элемента. Кроме того, он позволяет обрабатывать параллельные коллекции частями, а затем объединять промежуточные результаты.

aggregate разбивает проходимый объект или итератор на разделы и обрабатывает каждый раздел, последовательно применяя seqop, начиная с z (как foldLeft). Эти промежуточные результаты затем объединяются с помощью combop (как fold). Реализация этой операции может работать с произвольным количеством разделов коллекции (даже с 1), поэтому combop может вызываться произвольное количество раз (даже 0).

Например, рассмотрим суммирование целочисленных значений списка символов. Начальное значение для суммы равно 0. Сначала seqop преобразует каждый входной символ в Int и добавляет его к сумме (раздела). Затем combop просто суммирует промежуточные результаты разделов:

List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })

B: тип аккумулируемых результатов
z: начальное значение для аккумулированного результата раздела — это обычно нейтральный элемент для оператора seqop (например, Nil для конкатенации списков или 0 для суммирования) и может быть вычислен более одного раза
seqop: оператор, используемый для накопления результатов в пределах раздела
combop: ассоциативный оператор, используемый для объединения результатов из разных разделов

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

Definition Classes: PartialFunction → Function1

def apply(key: K): V

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

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

Definition Classes: MapLike → GenMapLike → Function1

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

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

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

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

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

orElse

andThen

apply

isDefinedAt

lift

unlift

runWith

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

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

Definition Classes: MapLike → PartialFunction
Since: 2.10

final def asInstanceOf[T0]: T0

Преобразует объект-приемник к типу T0.

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

returns: объект-приемник.

Definition Classes: Any
Exceptions thrown: ClassCastException, если объект-приемник не является экземпляром стирания типа T0.

def canEqual(that: Any): Boolean

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

that: объект, с которым эта итерируемая коллекция должна быть сравнена
returns: true, если эта итерируемая коллекция может быть равна that, false в противном случае. Тест учитывает только типы времени выполнения объектов, но игнорирует их элементы.

Definition Classes: IterableLike → Equals

def clone(): AnyRef

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

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

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

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

def collect[B](pf: PartialFunction[A, B]): Map[B]

[случай использования]

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

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

Определяющие классы: TraversableLike → GenTraversableLike

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

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

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

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

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

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

def compose[A](g: (A) ⇒ K): (A) ⇒ V

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

A: тип, к которому можно применить функцию g
g: функция A => T1
returns: новая функция f такая, что f(x) == apply(g(x))

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

def contains(key: K): Boolean

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

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

Определяющие классы: MapLike → GenMapLike

def copyToArray(xs: Array[A], start: Int, len: Int): Unit

[случай использования]

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

xs: массив для заполнения.
start: начальный индекс.
len: максимальное количество копируемых элементов.

Определяющие классы: IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

def copyToArray(xs: Array[A]): Unit

[случай использования]

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

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

Определяющие классы: TraversableOnce → GenTraversableOnce

def copyToArray(xs: Array[A], start: Int): Unit

[случай использования]

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

xs: массив для заполнения.
start: начальный индекс.

Определяющие классы: TraversableOnce → GenTraversableOnce

def copyToBuffer[B >: (K, V)](dest: Buffer[B]): Unit

Копирует все элементы этого итерируемого объекта или итератора в буфер.

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

dest: Буфер, в который копируются элементы.

Definition Classes: TraversableOnce

def count(p: ((K, V)) ⇒ Boolean): Int

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def default(key: K): V

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

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

Definition Classes: MapLike → GenMapLike
Exceptions thrown

def drop(n: Int): This

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

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

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

Definition Classes: IterableLike → TraversableLike → GenTraversableLike

def dropRight(n: Int): This

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

n: Количество элементов для взятия
returns: итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, кроме последних n элементов, или же пустая итерируемая коллекция, если в этой итерируемой коллекции меньше чем n элементов.

Definition Classes: IterableLike

def dropWhile(p: ((K, V)) ⇒ Boolean): This

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

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

Definition Classes: TraversableLike → GenTraversableLike

def ensuring(cond: (MapLike[K, V, This]) ⇒ Boolean, msg: ⇒ Any): MapLike[K, V, This]

Implicit: Этот член добавлен неявным преобразованием из MapLike[K, V, This] в Ensuring[MapLike[K, V, This]] с помощью метода Ensuring в scala.Predef.
Definition Classes: Ensuring

def ensuring(cond: (MapLike[K, V, This]) ⇒ Boolean): MapLike[K, V, This]

Implicit: Этот член добавлен неявным преобразованием из MapLike[K, V, This] в Ensuring[MapLike[K, V, This]] с помощью метода Ensuring в scala.Predef.
Definition Classes: Ensuring

def ensuring(cond: Boolean, msg: ⇒ Any): MapLike[K, V, This]

Неявный: Этот член добавлен неявным преобразованием из MapLike[K, V, This] в Ensuring[MapLike[K, V, This]] с помощью метода Ensuring в scala.Predef.
Определяющие классы: Ensuring

def ensuring(cond: Boolean): MapLike[K, V, This]

Неявный: Этот член добавлен неявным преобразованием из MapLike[K, V, This] в Ensuring[MapLike[K, V, This]] с помощью метода Ensuring в scala.Predef.
Определяющие классы: Ensuring

final def eq(arg0: AnyRef): Boolean

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

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

Он согласован: для любых непустых экземпляров и типа , многократные вызовы последовательно возвращают или последовательно возвращают.Для любого непустого экземпляра типа , вызовы и возвращают . Возвращает true.

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

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

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

def equals(that: Any): Boolean

Структурно сравнивает два отображения; т.е., проверяет, содержатся ли все отображения в этом отображении также в другом отображении, и наоборот.

that: другое отображение
возвращает: true, если оба отображения содержат точно такие же отображения, false в противном случае.

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

def exists(p: ((K, V)) ⇒ Boolean): Boolean

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

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

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

Определяющие классы: IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

def filter(p: ((K, V)) ⇒ Boolean): This

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

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

Определяющие классы: TraversableLike → GenTraversableLike

def filterKeys(p: (K) ⇒ Boolean): Map[K, V]

Фильтрует это отображение, оставляя только ключи, удовлетворяющие предикату.

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

Определяющие классы: MapLike → MapLike → GenMapLike

def filterNot(p: ((K, V)) ⇒ Boolean): This

Возвращает новую карту, полученную путём удаления всех пар ключ/значение, для которых предикат p возвращает true.

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

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

Definition Classes: MapLike → TraversableLike → GenTraversableLike

def finalize(): Unit

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

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

Attributes: protected[lang]
Definition Classes: AnyRef
Annotations: @throws( classOf[java.lang.Throwable] )
Note: не указан в SLS как член AnyRef

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

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

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

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

Definition Classes: IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

def flatMap[B](f: (A) ⇒ GenTraversableOnce[B]): Map[B]

[use case]

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

Например:

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

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

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

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

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

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

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

Definition Classes: TraversableLike → GenTraversableLike → FilterMonadic

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

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

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

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

B

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

z

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

op

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

returns

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

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

где x₁, ..., x_n являются элементами этой коллекции или итератора. Возвращает z если эта коллекция или итератор пустые.

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

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

B

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

z

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

op

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

returns

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

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

где x₁, ..., x_n — элементы этого итерируемого набора. Возвращает z , если этот итерируемый набор пустой.

Definition Classes: IterableLike → TraversableOnce → GenTraversableOnce

def forall(p: ((K, V)) ⇒ Boolean): Boolean

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

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

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

Definition Classes: IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

def foreach(f: ((K, V)) ⇒ Unit): Unit

[use case]

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

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

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

Definition Classes: IterableLike → TraversableLike → GenTraversableLike → TraversableOnce → GenTraversableOnce → FilterMonadic

def formatted(fmtstr: String): String

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

Неявный: Этот член добавлен с помощью неявного преобразования от MapLike[K, V, This] к StringFormat[MapLike[K, V, This]] с помощью метода StringFormat в scala.Predef.
Definition Classes: StringFormat
Annotations: @inline()

final def getClass(): Class[_]

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

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

Definition Classes: AnyRef → Any
Annotations: @native()

def getOrElse(key: K, default: ⇒ V): V

[use case]

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

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

Definition Classes: MapLike → GenMapLike

def groupBy[K](f: ((K, V)) ⇒ K): Map[K, This]

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

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

K

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

f

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

возвращает

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

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

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

Классы-определения: TraversableLike → GenTraversableLike

def grouped(size: Int): Iterator[This]

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

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

Классы-определения: IterableLike
См. также: scala.collection.Iterator, метод grouped

def hasDefiniteSize: Boolean

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

Примечание: многие методы коллекций не работают с коллекциями бесконечного размера. Типичная ошибка - бесконечный цикл. Эти методы всегда пытаются произвести обход, не проверяя сначала, что hasDefiniteSize возвращает true. Однако, проверка hasDefiniteSize может гарантировать, что размер определён и проблемы с не завершением отсутствуют.

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

Классы-определения: TraversableLike → TraversableOnce → GenTraversableOnce

def hashCode(): Int

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

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

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

def head: (K, V)

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

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

Классы-определения: IterableLike → TraversableLike → GenTraversableLike
Исключения: NoSuchElementException если итерабельная коллекция пуста.

def headOption: Option[(K, V)]

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

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

Классы-определения: TraversableLike → GenTraversableLike

def init: This

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

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

Классы-определения: TraversableLike → GenTraversableLike
Исключения: UnsupportedOperationException если коллекция обхода пуста.

def inits: Iterator[This]

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

возвращает: итератор по всем начальным элементам этой коллекции обхода

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

def isDefinedAt(key: K): Boolean

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

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

Классы-определения: MapLike → GenMapLike → PartialFunction

def isEmpty: Boolean

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

возвращает: true если карта не содержит связываний ключ/значение, false в противном случае.

Определяющие классы: MapLike → IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

final def isInstanceOf[T0]: Boolean

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

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

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

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

final def isTraversableAgain: Boolean

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

возвращает: true

Определяющие классы: TraversableLike → GenTraversableLike → GenTraversableOnce

def keySet: Set[K]

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

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

Определяющие классы: MapLike → MapLike → GenMapLike

def keys: collection.Iterable[K]

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

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

Определяющие классы: MapLike → GenMapLike
Аннотации: @migration
Миграция: (Изменено в версии 2.8.0) keys возвращает Iterable[K] вместо Iterator[K].

def keysIterator: Iterator[K]

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

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

Определяющие классы: MapLike → GenMapLike

def last: (K, V)

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

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

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

Определяющие классы: TraversableLike → GenTraversableLike
Исключения: NoSuchElementException Если итерируемый набор пустой.

def lastOption: Option[(K, V)]

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

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

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

Определяющие классы: TraversableLike → GenTraversableLike

def lift: (K) ⇒ Option[V]

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

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

Определяющие классы: PartialFunction
См. также: Function.unlift

def map[B](f: (A) ⇒ B): Map[B]

[use case]

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

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

Определяющие классы: TraversableLike → GenTraversableLike → FilterMonadic

def mapValues[W](f: (V) ⇒ W): Map[K, W]

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

f: функция, используемая для преобразования значений этого массива.
returns: представление массива, которое сопоставляет каждый ключ этого массива с f(this(key)). Результирующий массив оборачивает исходный массив без копирования элементов.

Definition Classes: MapLike → MapLike → GenMapLike

def max: A

[use case]

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

returns: наибольший элемент этого неизменяемого массива.

Definition Classes: TraversableOnce → GenTraversableOnce
Exceptions thrown: UnsupportedOperationException, если этот неизменяемый массив пуст.

def maxBy[B](f: (A) ⇒ B): A

[use case]

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

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

Definition Classes: TraversableOnce → GenTraversableOnce
Exceptions thrown: UnsupportedOperationException если этот неизменяемый массив пуст.

def min: A

[use case]

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

returns: наименьший элемент этого неизменяемого массива.

Definition Classes: TraversableOnce → GenTraversableOnce
Exceptions thrown: UnsupportedOperationException если этот неизменяемый массив пуст.

def minBy[B](f: (A) ⇒ B): A

[use case]

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

B: Тип результата функции f.
f: Функция измерения.
returns: первый элемент этого неизменяемого массива с наименьшим значением, измеренным функцией f.

Definition Classes: TraversableOnce → GenTraversableOnce
Exceptions thrown: UnsupportedOperationException если этот неизменяемый массив пуст.

def mkString: String

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

def mkString(sep: String): String

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

Definition Classes: TraversableOnce → GenTraversableOnce

final def ne(arg0: AnyRef): Boolean

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

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

Definition Classes: AnyRef

def newBuilder: Builder[(K, V), This]

Общее реализация newBuilder для всех карт в терминах empty. Переопределено для изменяемых карт в mutable.MapLike.

Атрибуты: protected[this]
Классы определения: MapLike → TraversableLike → HasNewBuilder

def nonEmpty: Boolean

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

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

Классы определения: TraversableOnce → GenTraversableOnce

final def notify(): Unit

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

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

final def notifyAll(): Unit

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

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

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

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

A1: тип аргумента резервной функции
B1: тип результата резервной функции
that: резервная функция
возвращает: частичная функция, имеющая в качестве области объединение областей данной частичной функции и `that`. Полученная частичная функция принимает `a` к `this.apply(a)`, где `this` определена, и к `that(a)`, где она не определена.

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

def par: ParMap[K, V]

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

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

Специфические наборы (например, ParArray или mutable.ParHashMap) переопределяют это поведение по умолчанию, создавая параллельный набор, который разделяет тот же базовый набор данных. Для этих наборов это занимает постоянное или сублинейное время.

Все параллельные наборы возвращают ссылку на себя.

возвращает: параллельная реализация этого набора

Классы определения: Parallelizable

def parCombiner: Combiner[(K, V), ParMap[K, V]]

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

возвращает: комбинирующий элемент для параллельного набора типа ParRepr

Атрибуты: protected[this]
Классы определения: MapLike → MapLike → TraversableLike → Parallelizable

def partition(p: ((K, V)) ⇒ Boolean): (This, This)

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

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

Классы определения: TraversableLike → GenTraversableLike

def product: A

[use case]

Умножает элементы этого набора.

возвращает: произведение всех элементов в этой неизменяемой карте чисел типа Int. Вместо Int, любой другой тип T с неявным Numeric[T] реализацией может использоваться как тип элемента неизменяемой карты и как тип результата product. Примеры таких типов: Long, Float, Double, BigInt.

Классы определения: TraversableOnce → GenTraversableOnce

def reduce[A1 >: (K, V)](op: (A1, A1) ⇒ A1): A1

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

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

A1: Параметр типа для бинарного оператора, сверхтип A.
op: Бинарный оператор, который должен быть ассоциативным.
returns: Результат применения оператора reduce op между всеми элементами, если обходчик или итератор не пуст.

Definition Classes: TraversableOnce → GenTraversableOnce
Exceptions thrown: UnsupportedOperationException, если этот обходчик или итератор пуст.

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

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

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

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

B

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

op

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

returns

результат вставки op между последовательными элементами этого обходчика или итератора слева направо:

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

где x₁, ..., x_n - это элементы этого обходчика или итератора.

Definition Classes: TraversableOnce
Exceptions thrown: UnsupportedOperationException если этот обходчик или итератор пуст.

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

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

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

B: тип результата бинарного оператора.
op: бинарный оператор.
returns: вариант значения, содержащий результат reduceLeft(op), если этот обходчик или итератор не пустой, None в противном случае.

Definition Classes: TraversableOnce → GenTraversableOnce

def reduceOption[A1 >: (K, V)](op: (A1, A1) ⇒ A1): Option[A1]

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

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

A1: Параметр типа для бинарного оператора, сверхтип A.
op: Бинарный оператор, который должен быть ассоциативным.
returns: Вариант значения, содержащий результат применения оператора reduce op между всеми элементами, если коллекция не пуста, и None в противном случае.

Definition Classes: TraversableOnce → GenTraversableOnce

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

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

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

B

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

op

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

returns

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

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

где x₁, ..., x_n - это элементы этой итерируемой коллекции.

Definition Classes: IterableLike → TraversableOnce → GenTraversableOnce
Exceptions thrown: UnsupportedOperationException если эта итерируемая коллекция пуста.

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

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

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

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

B: тип результата бинарного оператора.
op: бинарный оператор.
returns: значение Option, содержащее результат reduceRight(op) , если этот перебираемый объект или итератор не пустой, None в противном случае.

Definition Classes: TraversableOnce → GenTraversableOnce

def repr: This

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

Definition Classes: TraversableLike → GenTraversableLike

def reversed: scala.List[(K, V)]

Attributes: protected[this]
Definition Classes: TraversableOnce

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 позволяет избежать двойной оценки совпадений шаблонов и условий для частичных функций-литералов.

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

Definition Classes: PartialFunction
Since: 2.10
See also: applyOrElse.

def sameElements(that: GenIterable[A]): Boolean

[use case]

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

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

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

Definition Classes: IterableLike → GenIterableLike

def scan[B >: (K, V), That](z: B)(op: (B, B) ⇒ B)(implicit cbf: CanBuildFrom[This, B, That]): That

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

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

B: тип элементов результирующей коллекции
That: тип результирующей коллекции
z: нейтральный элемент для оператора op
op: ассоциативный оператор для сканирования
cbf: фабрика комбинирования, которая предоставляет комбинирование
returns: новая перебираемая коллекция, содержащая префиксное сканирование элементов в этой перебираемой коллекции

Definition Classes: TraversableLike → GenTraversableLike

def scanLeft[B, That](z: B)(op: (B, (K, V)) ⇒ B)(implicit bf: CanBuildFrom[This, B, That]): That

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

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

B: тип элементов в результирующей коллекции
That: фактический тип результирующей коллекции
z: начальное значение
op: бинарный оператор, применяемый к промежуточному результату и элементу
bf: неявное значение класса CanBuildFrom, которое определяет класс результата That из текущего типа представления Repr и нового типа элемента B.
returns: коллекция с промежуточными результатами

Definition Classes: TraversableLike → GenTraversableLike

def scanRight[B, That](z: B)(op: ((K, V), B) ⇒ B)(implicit bf: CanBuildFrom[This, B, That]): That

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

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

Пример:

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

B: тип элементов в результирующей коллекции
That: фактический тип результирующей коллекции
z: начальное значение
op: бинарный оператор, применяемый к промежуточному результату и элементу
bf: неявное значение класса CanBuildFrom, определяющее класс результата That из текущего типа представления Repr и нового типа элементов B.
returns: коллекция с промежуточными результатами

Definition Classes: TraversableLike → GenTraversableLike
Annotations: @migration
Migration: (Изменено в версии 2.9.0) Поведение scanRight изменилось. Предыдущее поведение можно воспроизвести с помощью scanRight.reverse.

def size: Int

Размер этого итератора.

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

returns: количество элементов в этом итераторе.

Definition Classes: TraversableOnce → GenTraversableOnce

def sizeHintIfCheap: Int

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

returns: количество элементов в этой коллекции или итераторе, или -1, если размер не может быть определён дёшево.

Attributes: protected[collection]
Definition Classes: GenTraversableOnce

def slice(from: Int, until: Int): This

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

from <= indexOf(x) < until

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

Definition Classes: IterableLike → TraversableLike → GenTraversableLike

def sliding(size: Int, step: Int): Iterator[This]

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

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

Definition Classes: IterableLike
See also: scala.collection.Iterator, метод sliding

def sliding(size: Int): Iterator[This]

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

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

Definition Classes: IterableLike
See also: scala.collection.Iterator, метод sliding

def span(p: ((K, V)) ⇒ Boolean): (This, This)

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

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

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

Definition Classes: TraversableLike → GenTraversableLike

def splitAt(n: Int): (This, This)

Разделяет эту коллекцию обхода на две части в заданной позиции. Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).

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

Definition Classes: TraversableLike → GenTraversableLike

def stringPrefix: String

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

returns: строковое представление, которое начинается с результата toString, применённого к этому отображению. Если не переопределено в подклассах, строковый префикс каждого отображения — "Map".

Definition Classes: MapLike → TraversableLike → GenTraversableLike

def sum: A

[use case]

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

returns: сумма всех элементов в этом неизменяемом отображении чисел типа Int. Вместо Int, можно использовать любой другой тип T с неявной реализацией Numeric[T] в качестве типа элемента неизменяемого отображения и типа результата sum. Примеры таких типов: Long, Float, Double, BigInt.

Definition Classes: TraversableOnce → GenTraversableOnce

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

Definition Classes: AnyRef

def tail: This

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

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

Definition Classes: TraversableLike → GenTraversableLike
Исключения: java.lang.UnsupportedOperationException, если коллекция обхода пустая.

def tails: Iterator[This]

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

returns: итератор по всем хвостам этой коллекции обхода

Definition Classes: TraversableLike

def take(n: Int): This

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

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

Definition Classes: IterableLike → TraversableLike → GenTraversableLike

def takeRight(n: Int): This

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

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

Definition Classes: IterableLike

def takeWhile(p: ((K, V)) ⇒ Boolean): This

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

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

Definition Classes: IterableLike → TraversableLike → GenTraversableLike

def thisCollection: collection.Iterable[(K, V)]

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

Атрибуты: protected[this]
Definition Classes: IterableLike → TraversableLike

def to[Col[_]]: Col[A]

[случай использования]

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

Col: Тип коллекции для построения.
возвращает: новая коллекция, содержащая все элементы этой неизменяемой карты.

Определяющие классы: TraversableLike → TraversableOnce → GenTraversableOnce

def toArray: Array[A]

[случай использования]

Преобразует эту неизменяемую карту в массив.

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

Определяющие классы: TraversableOnce → GenTraversableOnce

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

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

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

Определяющие классы: MapLike → TraversableOnce → GenTraversableOnce

def toCollection(repr: This): collection.Iterable[(K, V)]

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

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

def toIndexedSeq: IndexedSeq[(K, V)]

Преобразует эту коллекцию с итерацией или итератор в индексированную последовательность.

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

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

Определяющие классы: TraversableOnce → GenTraversableOnce

def toIterable: collection.Iterable[(K, V)]

Возвращает эту итерируемую коллекцию как итерируемую коллекцию.

Новая коллекция не будет построена; ленивые коллекции останутся ленивыми.

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

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

Определяющие классы: IterableLike → TraversableOnce → GenTraversableOnce

def toIterator: Iterator[(K, V)]

Возвращает итератор по элементам в этой итерируемой коллекции. Производит тот же результат, что и iterator.

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

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

Определяющие классы: IterableLike → TraversableLike → GenTraversableOnce
Аннотации: @deprecatedOverriding( message = ... , since = "2.11.0" )

def toList: scala.List[(K, V)]

Преобразует эту коллекцию с итерацией или итератор в список.

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

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

Определяющие классы: TraversableOnce → GenTraversableOnce

def toMap[T, U]: collection.Map[T, U]

[случай использования]

Преобразует эту неизменяемую карту в карту. Этот метод недоступен, если элементы не являются членами Tuple2, каждый ((T, U)) становится парой ключ-значение в карте. Повторяющиеся ключи будут перезаписаны последующими ключами: если это неупорядоченная коллекция, какой ключ находится в результирующей карте, не определено.

возвращает: карта типа immutable.Map[T, U], содержащая все пары ключ/значение типа (T, U) этой неизменяемой карты.

Определяющие классы: TraversableOnce → GenTraversableOnce

def toParArray: ParArray[T]

Неявный: Этот член добавлен неявным преобразованием из MapLike[K, V, This] в CollectionsHaveToParArray[MapLike[K, V, This], T] при помощи метода CollectionsHaveToParArray в scala.collection.parallel. Это преобразование произойдёт только если в области видимости есть неявное значение типа (MapLike[K, V, This]) ⇒ GenTraversableOnce[T].
Определяющие классы: CollectionsHaveToParArray

def toSeq: collection.Seq[(K, V)]

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

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

Определяющие классы: MapLike → TraversableOnce → GenTraversableOnce

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

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

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

возвращает: множество, содержащее все элементы этого итерируемого или итератора.

Определяющие классы: TraversableOnce → GenTraversableOnce

def toStream: Stream[(K, V)]

Преобразует это итерируемое множество в поток.

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

Определяющие классы: IterableLike → TraversableLike → GenTraversableOnce

def toString(): String

Преобразует это отображение в строку.

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

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

def toTraversable: collection.Traversable[(K, V)]

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

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

возвращает: Traversable, содержащий все элементы этой итерируемой коллекции.

Определяющие классы: TraversableLike → TraversableOnce → GenTraversableOnce
Аннотации: @deprecatedOverriding( message = ... , since = "2.11.0" )

def toVector: scala.Vector[(K, V)]

Преобразует это итерируемое или итератор в вектор.

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

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

Определяющие классы: TraversableOnce → GenTraversableOnce

def transform[W, That](f: (K, V) ⇒ W)(implicit bf: CanBuildFrom[This, (K, W), That]): That

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

f: Функция над ключами и значениями
возвращает: обновлённое отображение

def updated[V1 >: V](key: K, value: V1): Map[K, V1]

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

V1: тип добавленного значения
ключ: ключ
значение: значение
возвращает: Новая карта с новым сопоставлением ключ/значение

Классы определений: MapLike → MapLike

def значения: collection.Iterable[V]

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

возвращает: значения этой карты как итерируемый набор.

Классы определений: MapLike → GenMapLike
Аннотации: @migration
Миграция: (Изменено в версии 2.8.0) values возвращает Iterable[V] вместо Iterator[V].

def итераторЗначений: Iterator[V]

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

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

Классы определений: MapLike → GenMapLike

def вид(от: Int, до: Int): IterableView[(K, V), This]

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

Примечание: разница между view и slice заключается в том, что view создает вид текущей итерируемой коллекции, а slice создает новую итерируемую коллекцию.

Примечание: view(from, to) эквивалентно view.slice(from, to).

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

Классы определений: IterableLike → TraversableLike

def вид: IterableView[(K, V), This]

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

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

Классы определений: IterableLike → TraversableLike

final def ждать(): Unit

Классы определений: AnyRef
Аннотации: @throws( ... )

final def ждать(аргумент0: Long, аргумент1: Int): Unit

Классы определений: AnyRef
Аннотации: @throws( ... )

final def ждать(аргумент0: Long): Unit

Классы определений: AnyRef
Аннотации: @throws( ... ) @native()

def сФильтр(p: ((K, V)) ⇒ Boolean): FilterMonadic[(K, V), This]

Создает нестрогий фильтр этой коллекции обхода.

Примечание: разница между c filter p и c withFilter p заключается в том, что первый создает новую коллекцию, а второй только ограничивает область последующих map, flatMap, foreach, и withFilter операций.

p: предикат, используемый для проверки элементов.
возвращает: объект класса WithFilter, который поддерживает map, flatMap, foreach, и withFilter операции. Все эти операции применяются к тем элементам этой коллекции обхода, которые удовлетворяют предикату p.

Классы определений: TraversableLike → FilterMonadic

def zip[B](that: GenIterable[B]): Map[(A, B)]

[use case]

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

B: тип второй половины возвращаемых пар
that: Итерируемый объект, предоставляющий вторую половину каждой пары результатов
returns: новая неизменяемая карта, содержащая пары, состоящие из соответствующих элементов этой неизменяемой карты и that. Длина возвращаемой коллекции является минимальной из длин этой неизменяемой карты и that.

Definition Classes: IterableLike → GenIterableLike

def zipAll[B](that: collection.Iterable[B], thisElem: A, thatElem: B): Map[(A, B)]

[use case]

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

B: тип второй половины возвращаемых пар
that: Итерируемый объект, предоставляющий вторую половину каждой пары результатов
thisElem: элемент, который будет использоваться для заполнения результата, если эта неизменяемая карта короче that.
thatElem: элемент, который будет использоваться для заполнения результата, если that короче этой неизменяемой карты.
returns: новая неизменяемая карта, содержащая пары, состоящие из соответствующих элементов этой неизменяемой карты и that. Длина возвращаемой коллекции является максимальной из длин этой неизменяемой карты и that. Если эта неизменяемая карта короче that, используются значения thisElem, чтобы заполнить результат. Если that короче этой неизменяемой карты, используются значения thatElem, чтобы заполнить результат.

Definition Classes: IterableLike → GenIterableLike

def zipWithIndex: Map[(A, Int)]

[use case]

Объединяет эту неизменяемую карту с ее индексами.

returns: новая неизменяемая карта, содержащая пары, состоящие из всех элементов этой неизменяемой карты, соединенных с их индексом. Индексы начинаются с 0.

Definition Classes: IterableLike → GenIterableLike

def →[B](y: B): (MapLike[K, V, This], B)

Неявный: Этот член добавлен неявным преобразованием из MapLike[K, V, This] в ArrowAssoc[MapLike[K, V, This]] выполняемое методом ArrowAssoc в scala.Predef.
Definition Classes: ArrowAssoc

Затенённые неявные члены значения

def +(other: String): String

Неявный

Этот член добавлен неявным преобразованием из MapLike[K, V, This] в any2stringadd[MapLike[K, V, This]] с помощью метода any2stringadd в scala.Predef.

Затенение

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

(mapLike: any2stringadd[MapLike[K, V, This]]).+(other)

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

any2stringadd

def filter(p: ((K, V)) ⇒ Boolean): TraversableOnce[(K, V)]

Неявный

Этот член добавлен неявным преобразованием из MapLike[K, V, This] в MonadOps[(K, V)] с помощью метода MonadOps в scala.collection.TraversableOnce.

Затенение

(mapLike: MonadOps[(K, V)]).filter(p)

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

MonadOps

def flatMap[B](f: ((K, V)) ⇒ GenTraversableOnce[B]): TraversableOnce[B]

Неявный

Затенение

(mapLike: MonadOps[(K, V)]).flatMap(f)

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

MonadOps

def map[B](f: ((K, V)) ⇒ B): TraversableOnce[B]

Неявный

Затенение

(mapLike: MonadOps[(K, V)]).map(f)

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

MonadOps

def withFilter(p: ((K, V)) ⇒ Boolean): Iterator[(K, V)]

Неявный

Затенение

(mapLike: MonadOps[(K, V)]).withFilter(p)

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

MonadOps

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