Spec-Zone.ru › Scala 2.12 Library

Класс scala.collection.MapLike.MappedValues

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

Атрибуты
protected
Источник
MapLike.scala
Линейные супертипы
Известные подклассы

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

новый MappedValues(f: (V) ⇒ W)

Типовые члены

класс 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

тип Self = Map[K, W]

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

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

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

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

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

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

final def !=(arg0: Any): Boolean

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

returns

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

Definition Classes
AnyRef → Any

final def ##(): Int

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

returns

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

Definition Classes
AnyRef → Any

def +[B1 >: W](kv: (K, B1)): Map[K, B1]

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

kv

пара ключ/значение

returns

новая карта с новой связью, добавленной к этой карте

Definition Classes
DefaultMap → MapLike → GenMapLike

def +(kvs: (K, W)*): Map[K, W]

[use case]

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

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

kvs

пары ключ/значение

returns

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

Definition Classes
MapLike
Полная сигнатура

def ++(xs: Traversable[(K, W)]): Map[K, W]

[use case]

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

xs

коллекция, содержащая добавляемые пары ключ/значение

returns

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

Definition Classes
MapLike
Полная сигнатура

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

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

B

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

That

класс возвращаемой коллекции. В возможных случаях That — это тот же класс, что и текущий класс коллекции Repr, но это зависит от того, является ли тип элемента B допустимым для этого класса, что означает, что найден неявный экземпляр типа CanBuildFrom[Repr, B, That].

that

traversable для добавления.

bf

неявное значение класса CanBuildFrom, которое определяет класс результата That из текущего типа представления Repr и нового типа элемента B.

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def ++:[B >: (K, W), That](that: Traversable[B])(implicit bf: CanBuildFrom[Map[K, W], 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]

[use case]

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

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

Пример:

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 -(key: K): Map[K, W]

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

key

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

возвращает

новый словарь без привязки к key

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

def -(elem1: K, elem2: K, elems: K*): Map[K, W]

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

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

elem1

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

elem2

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

elems

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

возвращает

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

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

def --(xs: GenTraversableOnce[K]): Map[K, W]

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

xs

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

возвращает

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

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

def ->[B](y: B): (MappedValues[W], B)

Неявное
Этот член добавлен неявным преобразованием из MappedValues[W] в ArrowAssoc[MappedValues[W]], выполненным методом ArrowAssoc в scala.Predef.
Классы-определения
ArrowAssoc
Аннотации
@inline()

def /:[B](z: B)(op: (B, (K, W)) ⇒ 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

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

returns

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

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

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

Примечание: :\ — это альтернативная синтаксическая конструкция для foldRight; xs :\ z эквивалентно xs foldRight z.

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

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

Примеры:

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

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

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

returns

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

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

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

Definition Classes
TraversableOnce → GenTraversableOnce

final def ==(arg0: Any): Boolean

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

returns

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

Definition Classes
AnyRef → Any

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

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

b

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

start

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

sep

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

end

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

returns

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

Definition Classes
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

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

returns

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

Definition Classes
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

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

returns

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

Definition Classes
TraversableOnce

def aggregate[B](z: ⇒ B)(seqop: (B, (K, W)) ⇒ 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: (W) ⇒ C): PartialFunction[K, C]

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

C

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

k

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

returns

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

Definition Classes
PartialFunction → Function1

def apply(key: K): W

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

key

ключ

returns

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

Definition Classes
MapLike → GenMapLike → Function1

def applyOrElse[K1 <: K, V1 >: W](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

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

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

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

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

[use case]

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

B

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

pf

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike
Полная подпись

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

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

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

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

pf

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

returns

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

Definition Classes
TraversableOnce
Пример:

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

def companion: GenericCompanion[Iterable]

Объект-компаньон-фабрика, который создает экземпляры класса Iterable. (или его Iterable суперкласса, где класс Iterable не является Seq.)

Definition Classes
Iterable → GenIterable → Traversable → GenTraversable → GenericTraversableTemplate

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

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

A

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

g

функция A => T1

returns

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

Definition Classes
Function1
Annotations
@unspecialized()

def contains(key: K): Boolean

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

key

ключ

returns

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

Definition Classes
MappedValues → MapLike → GenMapLike

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

[use case]

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

xs

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

start

индекс начала.

len

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

Definition Classes
IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce
Полная подпись

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

[use case]

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

xs

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная подпись

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

[use case]

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

xs

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

start

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

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

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

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

dest

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

Definition Classes
TraversableOnce

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

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

p

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def default(key: K): W

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

key

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

Definition Classes
MapLike → GenMapLike
Исключения

def drop(n: Int): Map[K, W]

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

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

n

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

returns

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

Definition Classes
IterableLike → TraversableLike → GenTraversableLike

def dropRight(n: Int): Map[K, W]

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

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

n

Количество элементов, которые нужно взять

returns

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

Definition Classes
IterableLike

def dropWhile(p: ((K, W)) ⇒ Boolean): Map[K, W]

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

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def empty: Map[K, W]

Пустой словарь того же типа, что и этот словарь

returns

пустой словарь типа This.

Definition Classes
Map → MapLike

def ensuring(cond: (MappedValues[W]) ⇒ Boolean, msg: ⇒ Any): MappedValues[W]

Неявный
Этот член добавлен неявным преобразованием из MappedValues[W] в Ensuring[MappedValues[W]] выполняется методом Ensuring в scala.Predef.
Definition Classes
Ensuring

def ensuring(cond: (MappedValues[W]) ⇒ Boolean): MappedValues[W]

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

def ensuring(cond: Boolean, msg: ⇒ Any): MappedValues[W]

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

def ensuring(cond: Boolean): MappedValues[W]

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

final def eq(arg0: AnyRef): Boolean

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

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

    Он согласован: для любых непустых экземпляров x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false.Для любого непустого экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращают false. null.eq(null) возвращает true.

При переопределении методов equals или hashCode важно обеспечить согласованность их поведения с равенством ссылок. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и должны хэшироваться к одному значению (o1.hashCode == o2.hashCode).

возвращает

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

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

def equals(that: Any): Boolean

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

that

другое отображение

возвращает

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

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

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

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

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

p

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

возвращает

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

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

def filter(p: ((K, W)) ⇒ Boolean): Map[K, W]

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

p

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

возвращает

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

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

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

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

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

p

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

возвращает

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

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

def filterNot(p: ((K, W)) ⇒ Boolean): Map[K, W]

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

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

p

Предикат над парами ключ-значение

возвращает

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

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

def finalize(): Unit

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

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

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

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

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

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

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

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

p

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

возвращает

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

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

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

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

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

Например:

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

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

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

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

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

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

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

f

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

возвращает

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

Классы-определения
TraversableLike → GenTraversableLike → FilterMonadic
Полная сигнатура

def flatten[B]: Map[B]

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

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

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

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

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

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

возвращает

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

Классы-определения
GenericTraversableTemplate
Полная сигнатура

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

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

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

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

A1

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

z

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

op

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

возвращает

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

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

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

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

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

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

B

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

z

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

op

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

returns

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

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

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

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

B

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

z

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

op

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

returns

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

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

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

Definition Classes
IterableLike → TraversableOnce → GenTraversableOnce

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

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

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

p

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

returns

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

Definition Classes
IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

def foreach(f: (A) ⇒ Unit): Unit

[use case]

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

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

f

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

Definition Classes
MappedValues → IterableLike → GenericTraversableTemplate → TraversableLike → GenTraversableLike → TraversableOnce → GenTraversableOnce → FilterMonadic
Полная сигнатура

def formatted(fmtstr: String): String

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

Неявный
Этот член добавляется неявным преобразованием из MappedValues[W] в StringFormat[MappedValues[W]] с помощью метода StringFormat в scala.Predef.
Definition Classes
StringFormat
Annotations
@inline()

def genericBuilder[B]: Builder[B, Iterable[B]]

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

Definition Classes
GenericTraversableTemplate

def get(key: K): Option[W]

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

ключ

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

возвращает

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

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

final def getClass(): Class[_]

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

возвращает

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

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

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

[use case]

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

ключ

ключ.

default

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

возвращает

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

Классы-определения
MapLike → GenMapLike
Полная сигнатура

def groupBy[K](f: ((K, W)) ⇒ K): immutable.Map[K, Map[K, W]]

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

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

K

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

f

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

возвращает

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

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

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

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

def grouped(size: Int): Iterator[Map[K, W]]

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

размер

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

возвращает

Итератор, создающий итерабельные коллекции размером 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, W)

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

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

возвращает

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

Классы-определения
IterableLike → TraversableLike → GenTraversableLike
Исключения

NoSuchElementException если итерабельная коллекция пуста.

def headOption: Option[(K, W)]

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

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

возвращает

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

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

def init: Map[K, W]

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

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike
Exceptions thrown

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

def inits: Iterator[Map[K, W]]

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

returns

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

Definition Classes
TraversableLike
Пример:

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

def isDefinedAt(key: K): Boolean

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

key

ключ

returns

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

Definition Classes
MapLike → GenMapLike → PartialFunction

def isEmpty: Boolean

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

returns

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

Definition Classes
MapLike → IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

final def isInstanceOf[T0]: Boolean

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

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

returns

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

Definition Classes
Any

final def isTraversableAgain: Boolean

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

returns

true

Definition Classes
TraversableLike → GenTraversableLike → GenTraversableOnce

def iterator: Iterator[(K, W)]

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

returns

новый итератор

Definition Classes
MappedValues → MapLike → IterableLike → GenIterableLike

def keySet: Set[K]

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

returns

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

Definition Classes
MapLike → GenMapLike

def keys: Iterable[K]

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

returns

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

Definition Classes
MapLike → GenMapLike
Annotations
@migration
Migration

(Изменено в версии 2.8.0) keys возвращает Iterable[K] вместо Iterator[K].

def keysIterator: Iterator[K]

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

returns

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

Definition Classes
MapLike → GenMapLike

def last: (K, W)

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

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

возвращает

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

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

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

def lastOption: Option[(K, W)]

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

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

возвращает

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

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

def lift: (K) ⇒ Option[W]

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

возвращает

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

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

Function.unlift

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

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

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

B

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

f

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

возвращает

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

Определяющие классы
TraversableLike → GenTraversableLike → FilterMonadic
Полная сигнатура

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

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

f

Функция для преобразования значений этой карты.

возвращает

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

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

def max: A

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

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

возвращает

наибольший элемент этой карты.

Определяющие классы
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

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

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

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

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

B

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

f

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

возвращает

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

Определяющие классы
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

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

def min: A

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

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

возвращает

наименьший элемент этой карты

Определяющие классы
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

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

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

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

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

B

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

f

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

возвращает

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

Определяющие классы
TraversableOnce → GenTraversableOnce
Полная сигнатура
Исключения

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

def mkString: String

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def mkString(sep: String): String

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

sep

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Пример:

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

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

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

start

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

sep

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

end

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Пример:

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

final def ne(arg0: AnyRef): Boolean

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

returns

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

Definition Classes
AnyRef

def newBuilder: Builder[(K, W), Map[K, W]]

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

Attributes
protected[this]
Definition Classes
MapLike → TraversableLike → HasNewBuilder

def nonEmpty: Boolean

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

final def notify(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

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

final def notifyAll(): Unit

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

Definition Classes
AnyRef
Annotations
@native()
Note

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

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

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

A1

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

B1

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

that

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

returns

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

Definition Classes
PartialFunction

def par: ParMap[K, W]

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

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

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

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

returns

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

Definition Classes
Parallelizable

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

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

returns

комбинирователь для параллельного набора типа ParRepr

Attributes
protected[this]
Definition Classes
MapLike → TraversableLike → Parallelizable

def partition(p: ((K, W)) ⇒ Boolean): (Map[K, W], Map[K, W])

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

p

предикат, по которому происходит разделение.

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def product: A

[use case]

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Full Signature

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

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

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

A1

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Exceptions thrown

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

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

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

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

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

B

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

op

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

returns

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

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

где x1, ..., xn являются элементами этого набора.

Definition Classes
TraversableOnce
Exceptions thrown

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

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

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

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

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

B

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

A1

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

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

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

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

B

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

op

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

returns

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

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

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

Definition Classes
IterableLike → TraversableOnce → GenTraversableOnce
Exceptions thrown

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

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

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

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

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

B

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def repr: Map[K, W]

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

Definition Classes
TraversableLike → GenTraversableLike

def reversed: List[(K, W)]

Attributes
protected[this]
Definition Classes
TraversableOnce

def runWith[U](action: (W) ⇒ 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

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

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

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

that

коллекция для сравнения.

возвращает

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

Определения классов
IterableLike → GenIterableLike
Полная подпись

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

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

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

B

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

That

тип результирующей коллекции

z

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

op

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

cbf

фабрика-комбинатор, которая предоставляет комбинатор

возвращает

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

Определения классов
TraversableLike → GenTraversableLike

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

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

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

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

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

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

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

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

Пример:

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

def seq: Map[K, W]

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

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

возвращает

последовательный вид коллекции.

Определения классов
Map → GenMap → GenMapLike → Iterable → GenIterable → Traversable → GenTraversable → Parallelizable → TraversableOnce → GenTraversableOnce

def size: Int

Размер этой карты.

returns

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

Definition Classes
MappedValues → GenTraversableLike → TraversableOnce → GenTraversableOnce

def sizeHintIfCheap: Int

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

returns

количество элементов в этом наборе или итераторе, или -1, если размер нельзя определить дешево

Attributes
protected[collection]
Definition Classes
GenTraversableOnce

def slice(from: Int, until: Int): Map[K, W]

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

from <= indexOf(x) < until

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

returns

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

Definition Classes
IterableLike → TraversableLike → GenTraversableLike

def sliding(size: Int, step: Int): Iterator[Map[K, W]]

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

size

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

step

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

returns

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

Definition Classes
IterableLike
See also

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

def sliding(size: Int): Iterator[Map[K, W]]

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

size

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

returns

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

Definition Classes
IterableLike
See also

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

def span(p: ((K, W)) ⇒ Boolean): (Map[K, W], Map[K, W])

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

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

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def splitAt(n: Int): (Map[K, W], Map[K, W])

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

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

n

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def stringPrefix: String

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

returns

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

Definition Classes
MapLike → TraversableLike → GenTraversableLike

def sum: A

[use case]

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

возвращает

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

Определяющие классы
TraversableOnce → GenTraversableOnce
Полная сигнатура

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

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

def tail: Map[K, W]

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

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

возвращает

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

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

java.lang.UnsupportedOperationException, если набор пуст.

def tails: Iterator[Map[K, W]]

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

возвращает

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

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

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

def take(n: Int): Map[K, W]

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

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

n

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

возвращает

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

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

def takeRight(n: Int): Map[K, W]

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

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

n

количество элементов для взятия

возвращает

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

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

def takeWhile(p: ((K, W)) ⇒ Boolean): Map[K, W]

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

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

возвращает

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

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

def thisCollection: Iterable[(K, W)]

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

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

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

[use case]

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

Col

Тип набора для создания.

возвращает

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

Определяющие классы
TraversableLike → TraversableOnce → GenTraversableOnce
Полная сигнатура

def toArray: Array[A]

[use case]

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

возвращает

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

Определяющие классы
TraversableOnce → GenTraversableOnce
Полная сигнатура

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

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

returns

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

Definition Classes
MapLike → TraversableOnce → GenTraversableOnce

def toCollection(repr: Map[K, W]): Iterable[(K, W)]

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

Attributes
protected[this]
Definition Classes
IterableLike → TraversableLike

def toIndexedSeq: immutable.IndexedSeq[(K, W)]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def toIterable: Iterable[(K, W)]

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

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

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

returns

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

Definition Classes
IterableLike → TraversableOnce → GenTraversableOnce

def toIterator: Iterator[(K, W)]

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

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

returns

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

Definition Classes
IterableLike → TraversableLike → GenTraversableOnce
Annotations
@deprecatedOverriding( message = ... , since = "2.11.0" )

def toList: List[(K, W)]

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

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

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

[use case]

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Полная сигнатура

def toParArray: ParArray[T]

Неявный
Этот член добавляется неявным преобразованием из MappedValues[W] в CollectionsHaveToParArray[MappedValues[W], T] выполненным методом CollectionsHaveToParArray в scala.collection.parallel. Это преобразование произойдет только если неявное значение типа (MappedValues[W]) ⇒ GenTraversableOnce[T] находится в области видимости.
Definition Classes
CollectionsHaveToParArray

def toSeq: Seq[(K, W)]

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

возвращает

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

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

def toSet[B >: (K, W)]: immutable.Set[B]

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

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

возвращает

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

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

def toStream: immutable.Stream[(K, W)]

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

возвращает

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

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

def toString(): String

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

возвращает

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

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

def toTraversable: Traversable[(K, W)]

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

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

возвращает

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

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

def toVector: Vector[(K, W)]

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

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

возвращает

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

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

def transpose[B](implicit asTraversable: ((K, W)) ⇒ GenTraversableOnce[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

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

asTraversable

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

возвращает

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

Определяющие классы
GenericTraversableTemplate
Аннотации
@migration
Миграция

(Изменено в версии 2.9.0) transpose вызывает IllegalArgumentException если коллекции не имеют одинакового размера.

Исключения

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

def unzip[A1, A2](implicit asPair: ((K, W)) ⇒ (A1, A2)): (Iterable[A1], Iterable[A2])

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

val xs = Traversable(
           (1, "one"),
           (2, "two"),
           (3, "three")).unzip
// xs == (Traversable(1, 2, 3),
//        Traversable(one, two, three))
A1

тип первой половины пар элементов

A2

тип второй половины пар элементов

asPair

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

возвращает

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

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

def unzip3[A1, A2, A3](implicit asTriple: ((K, W)) ⇒ (A1, A2, A3)): (Iterable[A1], Iterable[A2], Iterable[A3])

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

val xs = Traversable(
           (1, "one", '1'),
           (2, "two", '2'),
           (3, "three", '3')).unzip3
// xs == (Traversable(1, 2, 3),
//        Traversable(one, two, three),
//        Traversable(1, 2, 3))
A1

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

A2

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

A3

тип третьего члена тройки элементов

asTriple

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

returns

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

Definition Classes
GenericTraversableTemplate

def updated(key: K, value: W): Map[K, W]

[use case]

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

key

ключ

value

значение

returns

Новый словарь с добавленной новой связью ключ/значение в этот словарь.

Definition Classes
MapLike
Полная подпись

def values: Iterable[W]

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

returns

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

Definition Classes
MapLike → GenMapLike
Аннотации
@migration
Миграция

(Изменено в версии 2.8.0) values возвращает Iterable[V] вместо Iterator[V].

def valuesIterator: Iterator[W]

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

returns

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

Definition Classes
MapLike → GenMapLike

def view(from: Int, until: Int): IterableView[(K, W), Map[K, W]]

Создаёт нестрогую версию фрагмента этого итерируемого набора данных.

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

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

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

from

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

until

индекс элемента, следующий за представлением

returns

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

Definition Classes
IterableLike → TraversableLike

def view: IterableView[(K, W), Map[K, W]]

Создаёт нестрогую версию этого итерируемого набора данных.

returns

нестрогая версия этого итерируемого набора данных.

Definition Classes
IterableLike → TraversableLike

final def wait(): Unit

Definition Classes
AnyRef
Аннотации
@throws( ... )

final def wait(arg0: Long, arg1: Int): Unit

Definition Classes
AnyRef
Аннотации
@throws( ... )

final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Аннотации
@throws( ... ) @native()

def withFilter(p: ((K, W)) ⇒ Boolean): FilterMonadic[(K, W), Map[K, W]]

Создаёт нестрогую фильтрацию данного коллектора.

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

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

p

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

returns

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

Definition Classes
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: 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
Полная сигнатура
Пример:

    List("a", "b", "c").zipWithIndex = List(("a", 0), ("b", 1), ("c", 2))

def →[B](y: B): (MappedValues[W], B)

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

Члены-значения с затемнённым неявным значением

def +(other: String): String

Неявный
Этот член добавлен с помощью неявного преобразования из MappedValues[W] в any2stringadd[MappedValues[W]] с помощью метода any2stringadd в scala.Predef.
Затемнённый
Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(mappedValues: any2stringadd[MappedValues[W]]).+(other)
Классы определения
any2stringadd

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

Неявный
Этот член добавлен с помощью неявного преобразования из MappedValues[W] в MonadOps[(K, W)] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затемнённый
Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(mappedValues: MonadOps[(K, W)]).filter(p)
Классы определения
MonadOps

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

Неявный
Этот член добавлен с помощью неявного преобразования из MappedValues[W] в MonadOps[(K, W)] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затемнённый
Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(mappedValues: MonadOps[(K, W)]).flatMap(f)
Классы определения
MonadOps

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

Неявный
Этот член добавлен с помощью неявного преобразования из MappedValues[W] в MonadOps[(K, W)] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затемнённый
Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(mappedValues: MonadOps[(K, W)]).map(f)
Классы определения
MonadOps

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

Неявный
Этот член добавлен с помощью неявного преобразования из MappedValues[W] в MonadOps[(K, W)] с помощью метода MonadOps в scala.collection.TraversableOnce.
Затемнённый
Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:
(mappedValues: MonadOps[(K, W)]).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/MapLike$MappedValues.html

Spec-Zone.ru

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