Spec-Zone.ru › Scala 2.12 Library

Трейт scala.collection.immutable.DefaultMap

trait DefaultMap[A, +B] extends Map[A, B]

Словарь по умолчанию, реализующий методы + и - словарей. Реализация использует дефолтный билдер для словарей, определённый в объекте Map. Классы, наследующие от DefaultMap[A, B], всё ещё должны определять:

def get(key: A): Option[B]
def iterator: Iterator[(A, B)]

Он ссылается на исходный словарь.

Также может быть целесообразно переопределить foreach или size, если существуют эффективные реализации.

A

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

B

тип значений, связанных с ключами.

Self Type
DefaultMap[A, B]
Source
DefaultMap.scala
Since

2.8

Линейные Супертипы

Члены-типы

class DefaultKeySet extends AbstractSet[K] with Set[K] with Serializable

Реализация набора, возвращаемого keySet.

Attributes
protected
Definition Classes
MapLike

class DefaultValuesIterable extends AbstractIterable[V] with Iterable[V] with Serializable

Реализация итерируемого объекта, возвращаемого values.

Attributes
protected
Definition Classes
MapLike

class FilteredKeys extends AbstractMap[K, V] with DefaultMap[K, V]

Attributes
protected
Definition Classes
MapLike

class MappedValues[W] extends AbstractMap[K, W] with DefaultMap[K, W]

Attributes
protected
Definition Classes
MapLike

class WithFilter extends FilterMonadic[A, Repr]

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

Definition Classes
TraversableLike

type Self = Map[A, B]

Тип, реализующий эту итерацию

Attributes
protected[this]
Definition Classes
TraversableLike

class ImmutableDefaultKeySet extends DefaultKeySet with Set[K]

Attributes
protected
Definition Classes
MapLike

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

abstract def get(key: A): Option[B]

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

key

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

returns

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

Definition Classes
MapLike → GenMapLike

abstract def iterator: Iterator[(A, B)]

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

returns

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

Definition Classes
MapLike → IterableLike → GenIterableLike

Члены-значения конкретного типа

final def !=(arg0: Any): Boolean

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

возвращает

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

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

final def ##(): Int

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

возвращает

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

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

def +[B1 >: B](kv: (A, B1)): Map[A, B1]

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

kv

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

возвращает

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

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

def +[V1 >: B](elem1: (A, V1), elem2: (A, V1), elems: (A, V1)*): Map[A, V1]

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

V1

тип добавляемых значений

elem1

первый добавляемый элемент.

elem2

второй добавляемый элемент.

elems

оставшиеся элементы для добавления.

возвращает

Новая карта с добавленными связями.

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

def ++[V1 >: B](xs: GenTraversableOnce[(A, V1)]): Map[A, V1]

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

V1

тип добавляемых значений

xs

объект итерации, состоящий из пар ключ-значение.

возвращает

новая неизменяемая карта со связями этой карты и связями из xs.

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

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

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

B

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

That

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

that

множество итераций для добавления.

bf

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

возвращает

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

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

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

returns

новая коллекция типа 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

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

returns

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

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

def -(key: A): Map[A, B]

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

key

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

returns

новая карта без привязки для key

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

def -(elem1: A, elem2: A, elems: A*): Map[A, B]

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

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

elem1

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

elem2

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

elems

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

returns

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

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

def --(xs: GenTraversableOnce[A]): Map[A, B]

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

xs

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

returns

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

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

def ->[B](y: B): (DefaultMap[A, B], B)

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

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

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

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

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

Например, рассмотрим суммирование целочисленных значений списка символов. Начальное значение для суммы равно 0. Сначала seqop преобразует каждый входящий символ в целое число и добавляет его к сумме (раздела). Затем 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: (B) ⇒ C): PartialFunction[A, C]

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

C

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

k

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

returns

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

Definition Classes
PartialFunction → Function1

def apply(key: A): B

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

key

ключ

returns

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

Definition Classes
MapLike → GenMapLike → Function1

def applyOrElse[K1 <: A, V1 >: B](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
Исключения

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

def canEqual(that: Any): Boolean

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

that

объект, с которым эта итерируемая коллекция должна быть сравнена

returns

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

Definition Classes
IterableLike → Equals

def clone(): AnyRef

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

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

возвращает

копию объекта-приемника.

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

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

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

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

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

B

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

pf

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

возвращает

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

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

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

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

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

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

pf

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

возвращает

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

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

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

def companion: GenericCompanion[Iterable]

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

Определяющие классы
Iterable → Iterable → GenIterable → Traversable → Traversable → GenTraversable → GenericTraversableTemplate

def compose[A](g: (A) ⇒ A): (A) ⇒ B

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

A

тип, к которому может быть применена функция g

g

функция A => T1

возвращает

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

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

def contains(key: A): Boolean

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

key

ключ

возвращает

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

[use case]

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

xs

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

start

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

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

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

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

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

dest

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

Definition Classes
TraversableOnce

def count(p: ((A, B)) ⇒ Boolean): Int

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

p

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def default(key: A): B

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

key

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

Definition Classes
MapLike → GenMapLike
Exceptions thrown

def drop(n: Int): Map[A, B]

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

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

n

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

returns

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

Definition Classes
IterableLike → TraversableLike → GenTraversableLike

def dropRight(n: Int): Map[A, B]

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

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

n

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

returns

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

Definition Classes
IterableLike

def dropWhile(p: ((A, B)) ⇒ Boolean): Map[A, B]

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

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def empty: Map[A, B]

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

returns

пустая карта типа This.

Definition Classes
Map → Map → MapLike

def ensuring(cond: (DefaultMap[A, B]) ⇒ Boolean, msg: ⇒ Any): DefaultMap[A, B]

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

def ensuring(cond: (DefaultMap[A, B]) ⇒ Boolean): DefaultMap[A, B]

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

def ensuring(cond: Boolean, msg: ⇒ Any): DefaultMap[A, B]

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

def ensuring(cond: Boolean): DefaultMap[A, B]

Неявный
Этот член добавлен неявным преобразованием из DefaultMap[A, B] в Ensuring[DefaultMap[A, B]] с помощью метода 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: ((A, B)) ⇒ Boolean): Boolean

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

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

p

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

возвращает

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

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

def filter(p: ((A, B)) ⇒ Boolean): Map[A, B]

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

p

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def filterKeys(p: (A) ⇒ Boolean): Map[A, B]

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

p

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

returns

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

Definition Classes
MapLike → MapLike → GenMapLike

def filterNot(p: ((A, B)) ⇒ Boolean): Map[A, B]

Возвращает новую карту, полученную путем удаления всех пар ключ/значение, для которых предикат 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: ((A, B)) ⇒ Boolean): Option[(A, B)]

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

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

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

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 flatten[B]: Map[B]

[use case]

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

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

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

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

returns

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

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

def fold[A1 >: (A, B)](z: A1)(op: (A1, A1) ⇒ A1): A1

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

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

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

A1

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

z

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce

def foldLeft[B](z: B)(op: (B, (A, B)) ⇒ 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: ((A, B), 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: ((A, B)) ⇒ Boolean): Boolean

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

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

p

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

returns

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

Definition Classes
IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce

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

[use case]

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

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

f

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

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

def formatted(fmtstr: String): String

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

Неявный
Этот член добавляется неявным преобразованием из DefaultMap[A, B] в StringFormat[DefaultMap[A, B]] посредством метода StringFormat в scala.Predef.
Definition Classes
StringFormat
Annotations
@inline()

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

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

Definition Classes
GenericTraversableTemplate

final def getClass(): Class[_]

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

returns

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

Definition Classes
AnyRef → Any
Annotations
@native()

def getOrElse(key: A, default: ⇒ B): B

[use case]

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

key

ключ.

default

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

returns

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

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

def groupBy[K](f: ((A, B)) ⇒ K): Map[K, Map[A, B]]

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

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

K

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

f

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

returns

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

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

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

Definition Classes
TraversableLike → GenTraversableLike

def grouped(size: Int): Iterator[Map[A, B]]

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

size

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

returns

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

Definition Classes
IterableLike
См. также

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

def hasDefiniteSize: Boolean

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

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

returns

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

Definition Classes
TraversableLike → TraversableOnce → GenTraversableOnce

def hashCode(): Int

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

returns

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

Definition Classes
GenMapLike → AnyRef → Any

def head: (A, B)

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

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

returns

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

Definition Classes
IterableLike → TraversableLike → GenTraversableLike
Исключения

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

def headOption: Option[(A, B)]

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

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

возвращает

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

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

def init: Map[A, B]

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

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

возвращает

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

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

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

def inits: Iterator[Map[A, B]]

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

возвращает

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

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

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

def isDefinedAt(key: A): 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[A]

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

возвращает

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

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

def keys: collection.Iterable[A]

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

возвращает

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

Классы определений
MapLike → GenMapLike
Аннотации
@migration
Миграция

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

def keysIterator: Iterator[A]

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

возвращает

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

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

def last: (A, B)

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

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

возвращает

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

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

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

def lastOption: Option[(A, B)]

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

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

возвращает

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

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

def lift: (A) ⇒ Option[B]

Преобразует эту частичную функцию в обычную функцию, возвращающую 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: (B) ⇒ W): Map[A, W]

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

f

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

возвращает

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

Определяющие классы
MapLike → 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

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

returns

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

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

UnsupportedOperationException, если эта неизменяемая карта пуста.

def mkString: String

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

returns

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

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

def mkString(sep: String): String

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

sep

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

returns

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

Классы-определения
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.

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

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

final def ne(arg0: AnyRef): Boolean

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

returns

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

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

def newBuilder: Builder[(A, B), Map[A, B]]

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

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

def nonEmpty: Boolean

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

returns

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

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

final def notify(): Unit

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

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

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

final def notifyAll(): Unit

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

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

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

def orElse[A1 <: A, B1 >: B](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]

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

A1

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

B1

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

that

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

returns

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

Definition Classes
PartialFunction

def par: ParMap[A, B]

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

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

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

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

returns

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

Definition Classes
Parallelizable

def parCombiner: Combiner[(A, B), ParMap[A, B]]

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

returns

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

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

def partition(p: ((A, B)) ⇒ Boolean): (Map[A, B], Map[A, B])

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

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

def reduce[A1 >: (A, B)](op: (A1, A1) ⇒ A1): A1

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

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

A1

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

op

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

returns

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

Definition Classes
TraversableOnce → GenTraversableOnce
Exceptions thrown

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

def reduceLeft[B >: (A, B)](op: (B, (A, B)) ⇒ 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 >: (A, B)](op: (B, (A, B)) ⇒ B): Option[B]

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

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

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

B

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

op

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

returns

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

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

def reduceOption[A1 >: (A, B)](op: (A1, A1) ⇒ A1): Option[A1]

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

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

A1

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

op

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

returns

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

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

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

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

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

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

B

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

op

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

returns

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

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

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

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

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

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

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

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

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

B

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

op

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

returns

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

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

def repr: Map[A, B]

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

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

def reversed: scala.List[(A, B)]

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

def runWith[U](action: (B) ⇒ U): (A) ⇒ 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 >: (A, B), That](z: B)(op: (B, B) ⇒ B)(implicit cbf: CanBuildFrom[Map[A, B], B, That]): That

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

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

B

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

That

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

z

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

op

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

cbf

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike

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

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

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

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

B

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

That

фактический тип результирующей коллекции

z

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

op

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

bf

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def scanRight[B, That](z: B)(op: ((A, B), B) ⇒ B)(implicit bf: CanBuildFrom[Map[A, B], 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 seq: Map[A, B]

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

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

returns

последовательный вид набора.

Definition Classes
Map → Map → GenMap → GenMapLike → Iterable → Iterable → GenIterable → Traversable → Traversable → GenTraversable → Parallelizable → TraversableOnce → GenTraversableOnce

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): Map[A, B]

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

from <= indexOf(x) < until

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

returns

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

Definition Classes
IterableLike → TraversableLike → GenTraversableLike

def sliding(size: Int, step: Int): Iterator[Map[A, B]]

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

size

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

step

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

returns

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

Definition Classes
IterableLike
See also

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

def sliding(size: Int): Iterator[Map[A, B]]

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

size

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

returns

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

Definition Classes
IterableLike
See also

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

def span(p: ((A, B)) ⇒ Boolean): (Map[A, B], Map[A, B])

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

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

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike

def splitAt(n: Int): (Map[A, B], Map[A, B])

Разделяет эту итерируемую коллекцию на две части в заданной позиции. Примечание: 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: Map[A, B]

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

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

returns

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

Definition Classes
TraversableLike → GenTraversableLike
Исключения

java.lang.UnsupportedOperationException если итерируемая коллекция пуста.

def tails: Iterator[Map[A, B]]

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

returns

итератор по всем хвостам этой итерируемой коллекции

Definition Classes
TraversableLike
Пример:

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

def take(n: Int): Map[A, B]

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

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

n

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

returns

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

Definition Classes
IterableLike → TraversableLike → GenTraversableLike

def takeRight(n: Int): Map[A, B]

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

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

n

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

returns

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

Definition Classes
IterableLike

def takeWhile(p: ((A, B)) ⇒ Boolean): Map[A, B]

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

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

returns

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

Definition Classes
IterableLike → TraversableLike → GenTraversableLike

def thisCollection: collection.Iterable[(A, B)]

Базовое отображение, рассматриваемое как экземпляр 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 >: (A, B)]: Buffer[E]

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

возвращает

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

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

def toCollection(repr: Map[A, B]): collection.Iterable[(A, B)]

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

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

def toIndexedSeq: IndexedSeq[(A, B)]

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

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

возвращает

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

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

def toIterable: collection.Iterable[(A, B)]

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

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

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

возвращает

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

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

def toIterator: Iterator[(A, B)]

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

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

возвращает

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

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

def toList: scala.List[(A, B)]

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

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

возвращает

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

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

def toMap[T, U](implicit ev: <:<[(A, B), (T, U)]): Map[T, U]

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

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

возвращает

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

Классы определений
Map → TraversableOnce → GenTraversableOnce
Аннотации
@deprecatedOverriding( message = ... , since = "2.11.0" )

def toParArray: ParArray[T]

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

def toSeq: collection.Seq[(A, B)]

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

возвращает

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

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

def toSet[B >: (A, B)]: Set[B]

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

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

возвращает

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

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

def toStream: Stream[(A, B)]

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

возвращает

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

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

def toString(): String

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

возвращает

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

Классы определений
MapLike → TraversableLike → Function1 → AnyRef → Any

def toTraversable: collection.Traversable[(A, B)]

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

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

возвращает

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

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

def toVector: scala.Vector[(A, B)]

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

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

возвращает

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

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

def transform[W, That](f: (A, B) ⇒ W)(implicit bf: CanBuildFrom[Map[A, B], (A, W), That]): That

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

f

Функция над ключами и значениями

returns

обновлённый словарь

Definition Classes
MapLike

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

returns

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

Definition Classes
GenericTraversableTemplate
Annotations
@migration
Migration

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

Exceptions thrown

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

def unzip[A1, A2](implicit asPair: ((A, B)) ⇒ (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

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

returns

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

Definition Classes
GenericTraversableTemplate

def unzip3[A1, A2, A3](implicit asTriple: ((A, B)) ⇒ (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[V1 >: B](key: A, value: V1): Map[A, V1]

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

V1

тип добавленного значения

key

ключ

value

значение

returns

Новый словарь с новой парой ключ/значение

Definition Classes
MapLike → MapLike

def values: collection.Iterable[B]

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

returns

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

Definition Classes
MapLike → GenMapLike
Annotations
@migration
Migration

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

def valuesIterator: Iterator[B]

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

returns

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

Definition Classes
MapLike → GenMapLike

def view(from: Int, until: Int): IterableView[(A, B), Map[A, B]]

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

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

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

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

from

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

until

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

returns

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

Definition Classes
IterableLike → TraversableLike

def view: IterableView[(A, B), Map[A, B]]

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

returns

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

Definition Classes
IterableLike → TraversableLike

final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )

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

Definition Classes
AnyRef
Annotations
@throws( ... )

final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws( ... ) @native()

def withDefault[V1 >: B](d: (A) ⇒ V1): Map[A, V1]

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

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

d

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

returns

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

Definition Classes
Map

def withDefaultValue[V1 >: B](d: V1): Map[A, V1]

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

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

d

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

returns

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

Definition Classes
Map

def withFilter(p: ((A, B)) ⇒ Boolean): FilterMonadic[(A, B), Map[A, B]]

Создаёт нестрогий фильтр этого итерируемого набора.

Примечание: разница между 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: collection.Iterable[B], thisElem: A, thatElem: B): Map[(A, B)]

[use case]

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

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

B

тип второй половины возвращаемых пар

that

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

thisElem

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

thatElem

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

returns

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

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): (DefaultMap[A, B], B)

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

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

def +(other: String): String

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

def filter(p: ((A, B)) ⇒ Boolean): TraversableOnce[(A, B)]

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

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

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

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

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

def withFilter(p: ((A, B)) ⇒ Boolean): Iterator[(A, B)]

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

Spec-Zone.ru

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