Класс scala.collection.mutable.ImmutableMapAdaptor
класс ImmutableMapAdaptor[A, B] extends AbstractMap[A, B] with Map[A, B] with Serializable
Конструкторы экземпляров
новый ImmutableMapAdaptor(imap: immutable.Map[A, B])
Типовые члены
класс DefaultKeySet extends AbstractSet[K] with Set[K] with Serializable
Реализующий класс множества, возвращаемого методом keySet.
- Атрибуты
- защищённый
- Определяющие классы
- MapLike
класс DefaultValuesIterable extends AbstractIterable[V] with Iterable[V] with Serializable
Реализующий класс итерируемого объекта, возвращаемого методом values.
- Атрибуты
- защищённый
- Определяющие классы
- MapLike
класс FilteredKeys extends AbstractMap[K, V] with DefaultMap[K, V]
- Атрибуты
- защищённый
- Определяющие классы
- MapLike
класс MappedValues[W] extends AbstractMap[K, W] with DefaultMap[K, W]
- Атрибуты
- защищённый
- Определяющие классы
- MapLike
класс WithFilter extends FilterMonadic[A, Repr]
Класс, поддерживающий отфильтрованные операции. Экземпляры этого класса возвращаются методом withFilter.
- Определяющие классы
- TraversableLike
тип Self = Map[A, B]
Тип, реализующий этот итерируемый объект
- Атрибуты
- защищённый[этого]
- Определяющие классы
- TraversableLike
Члены значения
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- returns
trueif !(this == that), false otherwise.
- Определяющие классы
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode за исключением boxed numeric types и null. Для чисел, он возвращает хэш-значение, которое согласуется с равенством значений: если два экземпляра типа значения сравниваются как true, то ## будет генерировать одно и то же хэш-значение для каждого из них. Для null возвращает хэш-код, где null.hashCode вызывает NullPointerException.
- returns
хэш-значение, согласованное с ==
- Определяющие классы
- AnyRef → Any
def +[V1 >: B](elem1: (A, V1), elem2: (A, V1), elems: (A, V1)*): Map[A, V1]
Создает новую карту, содержащую две или более сопоставлений ключ/значение и все сопоставления ключ/значение этой карты.
Указанные сопоставления переопределят существующие сопоставления из этой карты с теми же ключами.
- V1
тип добавляемых значений
- elem1
первый элемент для добавления.
- elem2
второй элемент для добавления.
- elems
остальные элементы для добавления.
- returns
новая карта, содержащая сопоставления этой карты и две или более указанных сопоставлений.
def +[V1 >: B](kv: (A, V1)): Map[A, V1]
Создает новую карту, содержащую новое сопоставление ключ/значение и все сопоставления ключ/значение этой карты.
Сопоставление kv переопределит существующие сопоставления из этой карты с тем же ключом.
- V1
тип значения в паре ключ/значение.
- kv
сопоставление ключ/значение, которое нужно добавить
- returns
новая карта, содержащая сопоставления этой карты и сопоставление
kv.
- Определяющие классы
- MapLike → MapLike → GenMapLike
- Аннотации
- @migration
- Миграция
(Изменено в версии 2.8.0)
+создает новую карту. Используйте+=для добавления элемента в эту карту и возврата самой карты.
def ++[V1 >: B](xs: GenTraversableOnce[(A, V1)]): Map[A, V1]
Создает новую карту, содержащую сопоставления ключ/значение, предоставленные указанным объектом, который можно пройти, и все сопоставления ключ/значение этой карты.
Обратите внимание, что существующие сопоставления из этой карты с тем же ключом, что и в xs, будут переопределены.
- V1
тип добавляемых значений
- xs
объект, который можно пройти.
- returns
новая карта, содержащая сопоставления этой карты и те, которые предоставлены
xs.
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.- returns
новая коллекция типа
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.
- Definition Classes
- TraversableLike
def ++:[B](that: TraversableOnce[B]): Map[B]
Как и ++, возвращает новую коллекцию, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда.
Она отличается от ++ тем, что правый операнд определяет тип результирующей коллекции, а не левый. Мнемоника: двоеточие находится на стороне нового типа коллекции.
Пример:
scala> val x = List(1) x: List[Int] = List(1) scala> val y = LinkedList(2) y: scala.collection.mutable.LinkedList[Int] = LinkedList(2) scala> val z = x ++: y z: scala.collection.mutable.LinkedList[Int] = LinkedList(1, 2)
- B
тип элементов возвращаемой коллекции.
- that
перебираемый объект для добавления.
- returns
новая изменяемая карта, которая содержит все элементы этой изменяемой карты, за которыми следуют все элементы
that.
- Definition Classes
- TraversableLike
def ++=(xs: TraversableOnce[(A, B)]): ImmutableMapAdaptor.this.type
Добавляет все элементы, полученные из TraversableOnce, в эту изменяемую коллекцию.
- xs
TraversableOnce, производящий элементы для добавления.
- returns
сама изменяемая коллекция.
- Definition Classes
- Growable
def +=(kv: (A, B)): ImmutableMapAdaptor.this.type
Добавляет новую пару ключ/значение в эту карту. Если в карте уже есть отображение для ключа, оно будет перезаписано новым значением.
- kv
пара ключ/значение.
- returns
сама карта
- Definition Classes
- ImmutableMapAdaptor → MapLike → Builder → Growable
def +=(elem1: (A, B), elem2: (A, B), elems: (A, B)*): ImmutableMapAdaptor.this.type
Добавляет два или более элементов в эту изменяемую коллекцию.
- elem1
первый элемент для добавления.
- elem2
второй элемент для добавления.
- elems
остальные элементы для добавления.
- returns
сама изменяемая коллекция
- Definition Classes
- Growable
def -(elem1: A, elem2: A, elems: A*): Map[A, B]
Создаёт новую карту со всеми отображениями ключ/значение этой карты, за исключением отображений с ключами, равными любому из указанных двух или более ключей.
- elem1
первый удаляемый элемент.
- elem2
второй удаляемый элемент.
- elems
остальные удаляемые элементы.
- returns
новая карта, содержащая все отображения этой карты, за исключением отображений с ключом, равным
elem1,elem2или любому изelems.
- Definition Classes
- MapLike → Subtractable
- Annotations
- @migration
- Migration
(Изменено в версии 2.8.0)
-создаёт новую карту. Используйте-=для удаления элемента из этой карты и возврата самой карты.
def -(key: A): Map[A, B]
Создаёт новую карту со всеми парами ключ/значение этой карты, за исключением пары с указанным ключом.
- key
ключ для удаления
- returns
новая карта со всеми соответствиями этой карты, за исключением соответствия с ключом
key.
- Definition Classes
- MapLike → MapLike → Subtractable → GenMapLike
- Annotations
- @migration
- Migration
(Изменено в версии 2.8.0)
-создаёт новую карту. Используйте-=для удаления элемента из этой карты и возвращения самой карты.
def --(xs: GenTraversableOnce[A]): Map[A, B]
Создаёт новую карту со всеми парами ключ/значение этой карты, за исключением пар с ключами, равными любому из ключей, предоставленных указанным объектом итерации.
- xs
объект итерации.
- returns
новая карта со всеми парами ключ/значение этой карты, за исключением пар с ключом, равным ключу из
xs.
- Definition Classes
- MapLike → Subtractable
- Annotations
- @migration
- Migration
(Изменено в версии 2.8.0)
--создаёт новую карту. Используйте--=для удаления элемента из этой карты и возвращения самой карты.
def --=(xs: TraversableOnce[A]): ImmutableMapAdaptor.this.type
Удаляет все элементы, сгенерированные итератором, из этой сжимаемой коллекции.
- xs
итератор, генерирующий элементы для удаления.
- returns
сама сжимаемая коллекция
- Definition Classes
- Shrinkable
def -=(key: A): ImmutableMapAdaptor.this.type
Удаляет ключ из этой карты.
- key
ключ для удаления
- returns
сама карта.
- Definition Classes
- ImmutableMapAdaptor → MapLike → Shrinkable
def -=(elem1: A, elem2: A, elems: A*): ImmutableMapAdaptor.this.type
Удаляет два или более элементов из этой сжимаемой коллекции.
- elem1
первый удаляемый элемент.
- elem2
второй удаляемый элемент.
- elems
оставшиеся элементы для удаления.
- returns
сама сжимаемая коллекция
- Definition Classes
- Shrinkable
def ->[B](y: B): (ImmutableMapAdaptor[A, B], B)
- Implicit
- Этот член добавлен неявным преобразованием из ImmutableMapAdaptor[A, B] в ArrowAssoc[ImmutableMapAdaptor[A, B]] с помощью метода ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
- Annotations
- @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— элементы этого итерируемого объекта или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
final def ==(arg0: Any): Boolean
Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- returns
true, если принимающий объект эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- AnyRef → Any
def addString(b: scala.StringBuilder, start: String, sep: String, end: String): scala.StringBuilder
Добавляет все привязки этой карты к создателю строк, используя начальные, конечные и разделительные строки. Записанный текст начинается со строки start и заканчивается строкой end. Внутри строковые представления всех привязок этой карты в форме key -> value разделены строкой sep.
- b
создатель, к которому добавляются строки.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
создатель строк
b, к которому были добавлены элементы.
- Определяющие классы
- MapLike → TraversableOnce
def addString(b: scala.StringBuilder): scala.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, к которому были добавлены элементы.
- Определяющие классы
- TraversableOnce
def addString(b: scala.StringBuilder, sep: String): scala.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, к которому были добавлены элементы.
- Определяющие классы
- 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 преобразует каждый входной символ в Int и добавляет его к сумме (раздела). Затем combop просто нужно суммировать промежуточные результаты разделов:
List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })
- B
тип накопленных результатов
- z
начальное значение для накопленного результата раздела — обычно это будет нейтральный элемент для оператора
seqop(например,Nilдля конкатенации списков или0для суммирования) и может вычисляться более одного раза- seqop
оператор, используемый для накопления результатов внутри раздела
- combop
ассоциативный оператор, используемый для объединения результатов из разных разделов
- Определяющие классы
- 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
- ImmutableMapAdaptor → MapLike → Function1 → GenMapLike
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 clear(): Unit
Удаляет все привязки из карты. После завершения этой операции карта будет пустой.
- Definition Classes
- ImmutableMapAdaptor → MapLike → Builder → Growable → Clearable
def clone(): Map[A, B]
Создаёт копию объекта-получателя.
По умолчанию реализация метода clone зависит от платформы.
- returns
копия объекта-получателя.
def collect[B](pf: PartialFunction[A, B]): Map[B]
Создаёт новую коллекцию, применяя частичную функцию ко всем элементам этой изменяемой карты, для которых эта функция определена.
- B
тип элементов возвращаемой коллекции.
- pf
частичная функция, которая фильтрует и отображает изменяемую карту.
- returns
новая изменяемая карта, полученная путём применения заданной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Definition Classes
- TraversableLike → GenTraversableLike
def collectFirst[B](pf: PartialFunction[(A, B), 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 → Iterable → GenIterable → Traversable → Traversable → GenTraversable → GenericTraversableTemplate
def compose[A](g: (A) ⇒ A): (A) ⇒ B
Компонует две инстанции Function1 в новую Function1, при этом эта функция применяется последней.
- A
тип, к которому функция
gможет быть применена- g
функция A => T1
- returns
новая функция
f, такая чтоf(x) == apply(g(x))
- Definition Classes
- Function1
- Annotations
- @unspecialized()
def contains(key: A): Boolean
Проверяет, содержит ли эта карта привязку для ключа.
- key
ключ
- returns
true, если дляkeyсуществует привязка в этой карте,falseв противном случае.
- Definition Classes
- ImmutableMapAdaptor → MapLike → GenMapLike
def copyToArray(xs: Array[A], start: Int, len: Int): Unit
Копирует элементы этой изменяемой карты в массив. Заполняет заданный массив xs не более чем len элементами этой изменяемой карты, начиная с позиции start. Копирование прекратится, как только будет достигнут конец текущей изменяемой карты, или конец целевого массива, или len элементов были скопированы.
- xs
массив для заполнения.
- start
начальный индекс.
- len
максимальное количество копируемых элементов.
- Definition Classes
- IterableLike → TraversableLike → TraversableOnce → GenTraversableOnce
def copyToArray(xs: Array[A]): Unit
Копирует элементы этой изменяемой карты в массив. Заполняет заданный массив xs значениями этой изменяемой карты. Копирование прекратится, как только будет достигнут конец текущей изменяемой карты или конец целевого массива.
- xs
массив для заполнения.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def copyToArray(xs: Array[A], start: Int): Unit
Копирует элементы этой изменяемой карты в массив. Заполняет заданный массив 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.
def ensuring(cond: (ImmutableMapAdaptor[A, B]) ⇒ Boolean, msg: ⇒ Any): ImmutableMapAdaptor[A, B]
- Implicit
- Этот член добавлен неявным преобразованием из ImmutableMapAdaptor[A, B] в Ensuring[ImmutableMapAdaptor[A, B]] выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (ImmutableMapAdaptor[A, B]) ⇒ Boolean): ImmutableMapAdaptor[A, B]
- Implicit
- Этот член добавлен неявным преобразованием из ImmutableMapAdaptor[A, B] в Ensuring[ImmutableMapAdaptor[A, B]] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: ⇒ Any): ImmutableMapAdaptor[A, B]
- Implicit
- Этот член добавлен неявным преобразованием из ImmutableMapAdaptor[A, B] в Ensuring[ImmutableMapAdaptor[A, B]] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean): ImmutableMapAdaptor[A, B]
- Implicit
- Этот член добавлен неявным преобразованием из ImmutableMapAdaptor[A, B] в Ensuring[ImmutableMapAdaptor[A, B]] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- 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).
- returns
true, если аргумент является ссылкой на объект-получатель;falseв противном случае.
- Definition Classes
- AnyRef
def equals(that: Any): Boolean
Структурно сравнивает два отображения; т.е. проверяет, содержатся ли все отображения, содержащиеся в этом отображении, также в другом отображении, и наоборот.
- that
другое отображение
- returns
true, если оба отображения содержат ровно те же отображения,falseв противном случае.
- Definition Classes
- GenMapLike → Equals → AnyRef → Any
def exists(p: ((A, B)) ⇒ Boolean): Boolean
Проверяет, выполняется ли предикат хотя бы для одного элемента в этой итерируемой коллекции.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
false, если эта итерируемая коллекция пуста, иначеtrue, если данный предикатpвыполняется для некоторых элементов этой итерируемой коллекции, иначеfalse
- Definition Classes
- 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): collection.Map[A, B]
Фильтрует эту карту, оставляя только ключи, удовлетворяющие предикату.
Примечание: предикат должен принимать любой ключ типа K, а не только те, которые уже присутствуют в карте, так как предикат проверяется до запроса к базовой карте.
- p
предикат для проверки ключей
- returns
неизменяемая карта, содержащая только те пары ключ-значение этой карты, где ключ удовлетворяет предикату
p. Результирующая карта оборачивает исходную карту без копирования каких-либо элементов.
- Definition Classes
- 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]
Создает новый набор, применяя функцию ко всем элементам этой изменяемой карты и используя элементы полученных наборов.
Например:
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]
Преобразует эту изменяемую карту итерируемых наборов в изменяемую карту, образованную элементами этих итерируемых наборов.
Тип результирующего набора будет определяться статическим типом изменяемой карты. Например:
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
Применяет функцию f ко всем элементам этой изменяемой карты.
Примечание: этот метод лежит в основе реализации большинства других операций с объемом. Подклассы должны переопределять этот метод, если существует более эффективная реализация.
- f
функция, которая применяется для своего побочного эффекта к каждому элементу. Результат функции
fигнорируется.
- Definition Classes
- IterableLike → TraversableLike → GenTraversableLike → TraversableOnce → GenTraversableOnce → FilterMonadic
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной строкой format. Форматные строки аналогичны строкам String.format (@см java.lang.String.format).
- Неявный
- Этот член добавлен неявным преобразованием из ImmutableMapAdaptor[A, B] в StringFormat[ImmutableMapAdaptor[A, B]] с помощью метода StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Annotations
- @inline()
def genericBuilder[B]: Builder[B, Iterable[B]]
Общий билдер, который создает экземпляры Traversable для произвольных типов элементов.
- Definition Classes
- GenericTraversableTemplate
def get(key: A): Option[B]
Возвращает значение, связанное с ключом.
- key
значение ключа
- returns
объект Option, содержащий значение, связанное с
keyв этом отображении, илиNone, если значение не найдено.
- Definition Classes
- ImmutableMapAdaptor → MapLike → GenMapLike
final def getClass(): Class[_]
Возвращает представление класса объекта во время выполнения.
- returns
объект класса, соответствующий типу получателя во время выполнения.
def getOrElse(key: A, default: ⇒ B): B
Возвращает значение, связанное с ключом, или значение по умолчанию, если ключ не содержится в отображении.
- key
ключ.
- default
вычисление, возвращающее значение по умолчанию в случае, если в отображении нет привязки для
key.- returns
значение, связанное с
key, если оно существует, в противном случае результат вычисленияdefault.
- Definition Classes
- MapLike → GenMapLike
def getOrElseUpdate(key: A, op: ⇒ B): B
Если заданный ключ уже есть в этом отображении, возвращает связанное значение.
В противном случае, вычисляет значение из заданного выражения op, сохраняет его с ключом в отображении и возвращает это значение.
Реализации отображений с конкурентным доступом могут оценивать выражение op несколько раз или могут оценивать op без вставки результата.
- key
ключ для проверки
- op
вычисление, возвращающее значение для связывания с
key, еслиkeyранее не привязан.- returns
значение, связанное с ключом (либо ранее, либо в результате выполнения метода).
- Definition Classes
- MapLike
def groupBy[K](f: ((A, B)) ⇒ K): immutable.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
- Exceptions thrown
NoSuchElementException, если итерируемый набор пуст.
def headOption: Option[(A, B)]
Выбирает первый элемент, если он есть.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- returns
первый элемент этого коллектора, если он не пуст,
None, если он пуст.
- Definition Classes
- TraversableLike → GenTraversableLike
var imap: immutable.Map[A, B]
- Attributes
- protected
def init: Map[A, B]
Выбирает все элементы, кроме последнего.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- returns
итерируемый набор, состоящий из всех элементов этого итерируемого набора, кроме последнего.
- Definition Classes
- TraversableLike → GenTraversableLike
- Exceptions thrown
UnsupportedOperationException, если итерируемый набор пуст.
def inits: Iterator[Map[A, B]]
Итерирует по начальным фрагментам этого итерируемого набора. Первое значение будет этим итерируемым набором, а последнее — пустым итерируемым набором, а промежуточные значения будут результатами последовательных применений init.
- returns
итератор по всем начальным фрагментам этого итерируемого набора
- Definition Classes
- 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
ключ
- returns
true, если дляkeyесть привязка в этой карте,falseв противном случае.
- Definition Classes
- ImmutableMapAdaptor → MapLike → PartialFunction → GenMapLike
def isEmpty: Boolean
Проверяет, является ли карта пустой.
- returns
true, если карта не содержит никаких привязок ключ/значение,falseв противном случае.
- Definition Classes
- ImmutableMapAdaptor → MapLike → IterableLike → GenericTraversableTemplate → 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[(A, B)]
Создает новый итератор по всем парам ключ/значение этой карты
- returns
новый итератор
- Definition Classes
- ImmutableMapAdaptor → MapLike → IterableLike → GenIterableLike
def keySet: collection.Set[A]
Собирает все ключи этой карты в множестве.
- returns
множество, содержащее все ключи этой карты.
- Definition Classes
- ImmutableMapAdaptor → MapLike → GenMapLike
def keys: collection.Iterable[A]
Собирает все ключи этой карты в итерируемом наборе.
- returns
ключи этой карты как итерируемый набор.
- Definition Classes
- ImmutableMapAdaptor → MapLike → GenMapLike
- Annotations
- @migration
- Migration
(Изменено в версии 2.8.0) Возвращает Iterable[A] вместо Iterator[A].
def keysIterator: Iterator[A]
Создает итератор для всех ключей.
- returns
итератор по всем ключам.
- Definition Classes
- ImmutableMapAdaptor → MapLike → GenMapLike
def last: (A, B)
Выбирает последний элемент.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- returns
Последний элемент этого итерируемого набора.
- Definition Classes
- TraversableLike → GenTraversableLike
- Исключения
NoSuchElementExceptionЕсли итерируемый набор пуст.
def lastOption: Option[(A, B)]
Возвращает последний элемент, если он существует.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- returns
последний элемент этого итерируемого набора, если он не пуст,
None, если он пуст.
- Definition Classes
- TraversableLike → GenTraversableLike
def lift: (A) ⇒ Option[B]
Преобразует эту частичную функцию в обычную функцию, возвращающую Option результат.
- returns
функцию, которая принимает аргумент
x, возвращающуюSome(this(x)), еслиthisопределено дляx, иNoneв противном случае.
- Definition Classes
- PartialFunction
- См. также
Function.unlift
def map[B](f: (A) ⇒ B): Map[B]
Создает новый набор, применяя функцию ко всем элементам этой изменяемой карты.
- B
тип элементов возвращаемого набора.
- f
функция, которую нужно применить к каждому элементу.
- returns
новая изменяемая карта, полученная путем применения заданной функции
fк каждому элементу этой изменяемой карты и сбора результатов.
- Definition Classes
- TraversableLike → GenTraversableLike → FilterMonadic
def mapResult[NewTo](f: (Map[A, B]) ⇒ NewTo): Builder[(A, B), NewTo]
Создает новый билдер, применяя функцию преобразования к результатам этого билдера.
- NewTo
тип коллекции, возвращаемый
f.- f
функция преобразования.
- returns
новый билдер, который идентичен текущему билдеру, за исключением того, что к результату этого билдера применена функция преобразования.
- Definition Classes
- Builder
- Примечание
После вызова
mapResultисходный билдер больше не должен использоваться.
def mapValues[W](f: (B) ⇒ W): collection.Map[A, W]
Преобразует этот массив, применяя функцию к каждому извлеченному значению.
- f
функция, используемая для преобразования значений этого массива.
- returns
вид массива, который отображает каждый ключ этого массива на
f(this(key)). Результирующий массив оборачивает исходный массив без копирования каких-либо элементов.
- Definition Classes
- MapLike → GenMapLike
def max: A
Находит наибольший элемент.
- returns
наибольший элемент этого изменяемого массива.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationException, если этот изменяемый массив пуст.
def maxBy[B](f: (A) ⇒ B): A
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- returns
первый элемент этого изменяемого массива с наибольшим значением, измеренным функцией f.
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationException, если этот изменяемый массив пуст.
def min: A
Находит наименьший элемент.
- returns
наименьший элемент этого изменяемого массива
- Definition Classes
- TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationException, если этот изменяемый массив пуст.
def minBy[B](f: (A) ⇒ B): A
Находит первый элемент, который дает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- returns
первый элемент этого изменяемого массива с наименьшим значением, измеренным функцией f.
- Definition Classes
- 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).
- возвращает
true, если аргумент не является ссылкой на объект получателя;falseв противном случае.
- Определяющие классы
- AnyRef
def newBuilder: Builder[(A, B), Map[A, B]]
Общее реализация newBuilder для всех изменяемых карт в терминах empty.
Переопределяет реализацию MapLike для повышения эффективности.
- Атрибуты
- protected[this]
- Определяющие классы
- MapLike → MapLike → TraversableLike → HasNewBuilder
def nonEmpty: Boolean
Проверяет, не пуста ли итерация или коллекция.
- возвращает
true, если итерируемая коллекция содержит хотя бы один элемент;falseв противном случае.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
final def notify(): Unit
Разбуживает единственную нить, ожидающую монитора объекта получателя.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не определен SLS как член AnyRef
final def notifyAll(): Unit
Разбуживает все нити, ожидающие монитора объекта получателя.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не определен SLS как член AnyRef
def orElse[A1 <: A, B1 >: B](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]
Компонует эту частичную функцию с резервной частичной функцией, которая применяется, когда эта частичная функция не определена.
- A1
тип аргумента резервной функции
- B1
тип возвращаемого значения резервной функции
- that
резервная функция
- возвращает
частичная функция, которая имеет область определения объединение областей определения этой частичной функции и
that. Результирующая частичная функция принимаетxкthis(x), гдеthisопределена, и кthat(x), где она не определена.
- Определяющие классы
- PartialFunction
def par: ParMap[A, B]
Возвращает параллельную реализацию этой коллекции.
Для большинства типов коллекций этот метод создает новую параллельную коллекцию, копируя все элементы. Для этих коллекций par занимает линейное время. Изменяемые коллекции в этой категории не создают изменяемую параллельную коллекцию с тем же основным набором данных, поэтому изменения в одной коллекции не будут отражены в другой.
Конкретные коллекции (например, ParArray или mutable.ParHashMap) переопределяют это поведение по умолчанию, создавая параллельную коллекцию, которая использует тот же базовый набор данных. Для этих коллекций par занимает постоянное или сублинейное время.
Все параллельные коллекции возвращают ссылку на себя.
- возвращает
параллельная реализация этой коллекции
- Определяющие классы
- Parallelizable
def parCombiner: Combiner[(A, B), ParMap[A, B]]
Реализация par по умолчанию использует комбайнер, предоставленный этим методом, для создания новой параллельной коллекции.
- возвращает
комбайнер для параллельной коллекции типа
ParRepr
- Атрибуты
- protected[this]
- Определяющие классы
- MapLike → MapLike → TraversableLike → Parallelizable
def partition(p: ((A, B)) ⇒ Boolean): (Map[A, B], Map[A, B])
Разделяет эту итерируемую коллекцию на две итерируемые коллекции согласно предикату.
- p
предикат для разделения.
- возвращает
пара итерируемых коллекций: первая итерируемая коллекция состоит из всех элементов, удовлетворяющих предикату
p, а вторая — из всех элементов, которые не удовлетворяют ему. Относительный порядок элементов в результирующих итерируемых коллекциях такой же, как и в исходной итерируемой коллекции.
- Определяющие классы
- TraversableLike → GenTraversableLike
def product: A
Перемножает элементы этой коллекции.
- returns
произведение всех элементов в этом изменяемом отображении чисел типа
Int. ВместоInt, любой другой типTс неявной реализациейNumeric[T]может использоваться в качестве типа элемента изменяемого отображения и типа результатаproduct. Примеры таких типов:Long,Float,Double,BigInt.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def put(key: A, value: B): Option[B]
Добавляет новую пару ключ/значение в это отображение и возвращает ранее связанное значение (опционально). Если отображение уже содержит сопоставление для ключа, оно будет переопределено новым значением.
- key
ключ для обновления
- value
новое значение
- returns
опциональное значение, содержащее значение, связанное с ключом до выполнения операции
put, илиNone, еслиkeyне было определено в отображении ранее.
- Определяющие классы
- MapLike
def reduce[A1 >: (A, B)](op: (A1, A1) ⇒ A1): A1
Сводит элементы этого обхода или итератора, используя указанный ассоциативный бинарный оператор.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
- A1
Типовой параметр для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора сводки
opко всем элементам, если обход или итератор не пуст.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
- Выбрасываемые исключения
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являются элементами этого обхода или итератора.
- Определяющие классы
- TraversableOnce
- Выбрасываемые исключения
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
Опциональное значение, содержащее результат применения оператора сводки
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являются элементами этого итерируемого набора.
- Definition Classes
- IterableLike → TraversableOnce → GenTraversableOnce
- Исключения
UnsupportedOperationException, если этот итерируемый набор пуст.
def reduceRightOption[B >: (A, B)](op: ((A, B), B) ⇒ B): Option[B]
При необходимости применяет бинарный оператор ко всем элементам этого итерируемого объекта или итератора, справа налево.
Примечание: не завершится для бесконечных коллекций.
Примечание: может возвращать разные результаты при разных запусках, если только базовый тип коллекции упорядочен или оператор ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
объект Option, содержащий результат
reduceRight(op), если этот итерируемый объект или итератор не пустой,Noneв противном случае.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def remove(key: A): Option[B]
Удаляет ключ из этого словаря, возвращая ранее сопоставленное значение с этим ключом как объект Option.
- key
ключ для удаления
- returns
объект Option, содержащий значение, ранее сопоставленное с
key, илиNone, еслиkeyне было определено в словаре ранее.
- Definition Classes
- MapLike
def repr: Map[A, B]
Коллекция типа итерируемая коллекция, лежащая в основе этого TraversableLike объекта. По умолчанию это реализуется как сам TraversableLike объект, но это можно переопределить.
- Definition Classes
- TraversableLike → GenTraversableLike
def result(): Map[A, B]
Результат, когда этот словарь используется как строитель
- returns
представление самого словаря.
def retain(p: (A, B) ⇒ Boolean): ImmutableMapAdaptor.this.type
Сохраняет только те отображения, для которых предикат p возвращает true.
- p
предикат проверки
- Definition Classes
- ImmutableMapAdaptor → MapLike
def reversed: List[(A, B)]
- Attributes
- protected[this]
- Definition Classes
- 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
- См. также
applyOrElse.
def sameElements(that: GenIterable[A]): Boolean
Проверяет, содержит ли другая итерируемая коллекция те же элементы в том же порядке, что и эта изменяемая карта.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- 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
последовательное представление коллекции.
- Определяющие классы
- Map → Map → GenMap → GenMapLike → Iterable → Iterable → GenIterable → Traversable → Traversable → GenTraversable → Parallelizable → TraversableOnce → GenTraversableOnce
def size: Int
Размер этой изменяемой карты.
- returns
число элементов в этой изменяемой карте.
- Определяющие классы
- ImmutableMapAdaptor → GenTraversableLike → TraversableOnce → GenTraversableOnce
def sizeHint(coll: TraversableLike[_, _], delta: Int): Unit
Указывает, что ожидается, что result этого построителя будет иметь тот же размер, что и заданная коллекция, плюс некоторое значение delta. Это подсказка будет предоставлена только в том случае, если известно, что коллекция имеет недорогой метод size. В настоящее время предполагается, что это так тогда и только тогда, когда коллекция имеет тип IndexedSeqLike. Некоторые классы построителей оптимизируют свое представление на основе подсказки. Однако реализации построителей по-прежнему должны работать корректно, даже если подсказка неверна, т.е. добавляется другое количество элементов.
- coll
коллекция, которая служит подсказкой для размера результата.
- delta
коррекция, добавляемая к
coll.sizeдля получения подсказки размера.
- Определяющие классы
- Builder
def sizeHint(coll: TraversableLike[_, _]): Unit
Указывает, что ожидается, что result этого построителя будет иметь тот же размер, что и заданная коллекция, плюс некоторое значение delta. Это подсказка будет предоставлена только в том случае, если известно, что коллекция имеет недорогой метод size, который определяется вызовом sizeHint.
Некоторые классы построителей оптимизируют свое представление на основе подсказки. Однако реализации построителей по-прежнему должны работать корректно, даже если подсказка неверна, т.е. добавляется другое количество элементов.
- coll
коллекция, которая служит подсказкой для размера результата.
- Определяющие классы
- Builder
def sizeHint(size: Int): Unit
Указывает, сколько элементов, как ожидается, будет добавлено при следующем вызове result. Некоторые классы построителей оптимизируют свое представление на основе подсказки. Однако реализации построителей по-прежнему должны работать корректно, даже если подсказка неверна, т.е. добавляется другое количество элементов.
- size
подсказка о количестве добавляемых элементов.
- Определяющие классы
- Builder
def sizeHintBounded(size: Int, boundingColl: TraversableLike[_, _]): Unit
Указывает, сколько элементов, как ожидается, будет добавлено при следующем вызове result, а также верхнюю границу, заданную размером некоторой другой коллекции. Некоторые классы построителей оптимизируют свое представление на основе подсказки. Однако реализации построителей по-прежнему должны работать корректно, даже если подсказка неверна, т.е. добавляется другое количество элементов.
- size
подсказка о количестве добавляемых элементов.
- boundingColl
ограничивающая коллекция. Если это IndexedSeqLike, то размеры, превышающие размер коллекции, уменьшаются.
- Определяющие классы
- Builder
def sizeHintIfCheap: Int
Размер этой коллекции или итератора, если его можно вычислить недорого.
- returns
число элементов в этой коллекции или итераторе, или -1, если размер нельзя определить недорого
- Атрибуты
- protected[collection]
- Определяющие классы
- GenTraversableOnce
def slice(from: Int, until: Int): Map[A, B]
Выбирает интервал элементов. Возвращаемая коллекция состоит из всех элементов x, которые удовлетворяют инварианту:
from <= indexOf(x) < until
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
итерируемая коллекция, содержащая элементы больше или равные индексу
from, простирающиеся до (но не включая) индексuntilэтой итерируемой коллекции.
- Определяющие классы
- 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
Определяет префикс представления этого объекта в строковом формате.
- returns
строковое представление, которое начинается с результата применения
toStringк этой карте. Если не переопределено в подклассах, строковый префикс каждой карты -"Map".
- Definition Classes
- MapLike → TraversableLike → GenTraversableLike
def sum: A
Вычисляет сумму элементов этой коллекции.
- 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. По умолчанию он реализуется как текущий объект набора, но это можно переопределить.
- Attributes
- protected[this]
- Definition Classes
- IterableLike → TraversableLike
def to[Col[_]]: Col[A]
Преобразует этот изменяемый словарь в другой, копируя все элементы.
- Col
Тип набора для построения.
- returns
новый набор, содержащий все элементы этого изменяемого словаря.
- Definition Classes
- TraversableLike → TraversableOnce → GenTraversableOnce
def toArray: Array[A]
Преобразует этот изменяемый словарь в массив.
- returns
массив, содержащий все элементы этого изменяемого словаря. Должно быть доступно
ClassTagдля типа элементов этого изменяемого словаря.
- Definition Classes
- TraversableOnce → GenTraversableOnce
def toBuffer[E >: (A, B)]: Buffer[E]
Использует содержимое этого словаря для создания нового изменяемого буфера.
- returns
буфер, содержащий все элементы этого словаря.
- Definition Classes
- MapLike → TraversableOnce → GenTraversableOnce
def toCollection(repr: Map[A, B]): collection.Iterable[(A, B)]
Преобразование из наборов типа Repr в объекты Iterable. По умолчанию это реализуется как просто приведение типов, но это можно переопределить.
- Attributes
- protected[this]
- Definition Classes
- IterableLike → TraversableLike
def toIndexedSeq: immutable.IndexedSeq[(A, B)]
Преобразует этот итерируемый объект или итератор в индексированную последовательность.
Примечание: не завершится для коллекций бесконечного размера.
- возвращает
индексированная последовательность, содержащая все элементы этого итерируемого объекта или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toIterable: collection.Iterable[(A, B)]
Возвращает эту итерируемую коллекцию как итерируемую коллекцию.
Новая коллекция не будет создана; ленивые коллекции останутся ленивыми.
Примечание: не завершится для коллекций бесконечного размера.
- возвращает
a
Iterableсодержащая все элементы этой итерируемой коллекции.
- Классы-определения
- IterableLike → TraversableOnce → GenTraversableOnce
def toIterator: Iterator[(A, B)]
Возвращает Iterator над элементами в этой итерируемой коллекции. Возвращает тот же результат, что и iterator.
Примечание: не завершится для коллекций бесконечного размера.
- возвращает
Iterator, содержащий все элементы этой итерируемой коллекции.
- Классы-определения
- IterableLike → TraversableLike → GenTraversableOnce
- Аннотации
- @deprecatedOverriding( сообщение = ... , с = "2.11.0" )
def toList: List[(A, B)]
Преобразует эту изменяемую карту в список.
- возвращает
список, содержащий все элементы этой изменяемой карты.
- Классы-определения
- ImmutableMapAdaptor → TraversableOnce → GenTraversableOnce
def toMap[T, U]: collection.Map[T, U]
Преобразует эту изменяемую карту в карту. Этот метод недоступен, если элементы не являются членами Tuple2, каждая ((T, U)) становится парой ключ-значение в карте. Повторные ключи будут перезаписаны последующими ключами: если это неупорядоченная коллекция, какой ключ находится в результирующей карте, не определено.
- возвращает
карта типа
immutable.Map[T, U], содержащая все пары ключ/значение типа(T, U)этой изменяемой карты.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toParArray: ParArray[T]
- Неявный
- Этот член добавлен неявным преобразованием из ImmutableMapAdaptor[A, B] в CollectionsHaveToParArray[ImmutableMapAdaptor[A, B], T] производимым методом CollectionsHaveToParArray в scala.collection.parallel. Это преобразование произойдёт только если неявное значение типа (ImmutableMapAdaptor[A, B]) ⇒ GenTraversableOnce[T] присутствует в области видимости.
- Классы-определения
- CollectionsHaveToParArray
def toSeq: collection.Seq[(A, B)]
Преобразует эту изменяемую карту в последовательность.
: предполагает быстрый Notesize метод. Подклассы должны переопределять, если это не так.
- возвращает
последовательность, содержащую все элементы этой изменяемой карты.
- Классы-определения
- MapLike → MapLike → TraversableOnce → GenTraversableOnce
def toSet[B >: (A, B)]: immutable.Set[B]
Преобразует этот итерируемый объект или итератор в множество.
Примечание: не завершится для коллекций бесконечного размера.
- возвращает
множество, содержащее все элементы этого итерируемого объекта или итератора.
- Классы-определения
- TraversableOnce → GenTraversableOnce
def toStream: immutable.Stream[(A, B)]
Преобразует этот итерируемый набор в поток.
- возвращает
поток, содержащий все элементы этого итерируемого набора.
- Определяющие классы
- IterableLike → TraversableLike → GenTraversableOnce
def toString(): String
Преобразует эту изменяемую карту в строку.
- возвращает
строковое представление этого набора. По умолчанию эта строка состоит из
stringPrefixэтой изменяемой карты, за которой следуют все элементы, разделенные запятыми и заключенные в скобки.
- Определяющие классы
- ImmutableMapAdaptor → MapLike → Function1 → TraversableLike → AnyRef → Any
def toTraversable: collection.Traversable[(A, B)]
Преобразует этот итерируемый набор в неопределенный Traversable. Вернет тот же набор, если этот экземпляр уже Traversable.
Примечание: не завершится для наборов бесконечного размера.
- возвращает
Traversable, содержащий все элементы этого итерируемого набора.
- Определяющие классы
- TraversableLike → TraversableOnce → GenTraversableOnce
- Аннотации
- @deprecatedOverriding( message = ... , since = "2.11.0" )
def toVector: Vector[(A, B)]
Преобразует этот итерируемый или итератор в вектор.
Примечание: не завершится для наборов бесконечного размера.
- возвращает
вектор, содержащий все элементы этого итерируемого или итератора.
- Определяющие классы
- TraversableOnce → GenTraversableOnce
def transform(f: (A, B) ⇒ B): ImmutableMapAdaptor.this.type
Применяет функцию преобразования ко всем значениям, содержащимся в этой карте. Функция преобразования генерирует новые значения из существующих ключей, связанных со значениями.
- f
преобразование, которое нужно применить
- возвращает
сама карта.
- Определяющие классы
- ImmutableMapAdaptor → 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.- возвращает
двухмерный набор наборов, в котором n-я строка является n-м столбцом этого набора.
- Определяющие классы
- GenericTraversableTemplate
- Аннотации
- @migration
- Миграция
(Изменено в версии 2.9.0)
transposeгенерируетIllegalArgumentException, если наборы не имеют одинаковый размер.- Исключения
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
неявное преобразование, которое утверждает, что тип элемента этого набора является парой.
- возвращает
пара наборов, содержащих первую, соответственно вторую половину каждой пары элементов этого набора.
- Определяющие классы
- 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 update(key: A, value: B): Unit
Добавляет новую пару ключ/значение в эту карту. Если карта уже содержит отображение для ключа, оно будет перезаписано новым значением.
- key
Ключ для обновления
- value
Новое значение
- Definition Classes
- ImmutableMapAdaptor → MapLike
def updated[V1 >: B](key: A, value: V1): Map[A, V1]
Создаёт новую карту, содержащую все пары ключ/значение текущей карты плюс новую пару с заданным ключом и значением.
- V1
тип добавленного значения
- key
Ключ для добавления
- value
Новое значение
- returns
Новая неизменяемая карта с добавленной связью от
keyдоvalueк этой карте.
def values: collection.Iterable[B]
Собраны все значения этой карты в итерируемой коллекции.
- returns
значения этой карты как итерируемая коллекция.
- Definition Classes
- ImmutableMapAdaptor → MapLike → GenMapLike
- Annotations
- @migration
- Migration
(Изменено в версии 2.8.0)
valuesвозвращает Iterable[B] вместо Iterator[B].
def valuesIterator: Iterator[B]
Создаёт итератор для всех значений в этой карте.
- returns
итератор по всем значениям, связанным с каким-либо ключом в этой карте.
- Definition Classes
- ImmutableMapAdaptor → 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
def withDefault(d: (A) ⇒ B): Map[A, B]
Тот же самый массив с заданной функцией по умолчанию.
Вызов методов трансформации (например, map) не сохранит значение по умолчанию.
- d
функция, сопоставляющая ключи со значениями, используемая для отсутствующих ключей
- returns
обёртка над массивом со значением по умолчанию
- Definition Classes
- Map
def withDefaultValue(d: B): Map[A, B]
Тот же самый массив со заданным значением по умолчанию.
Вызов методов трансформации (например, 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)]
Возвращает изменяемый массив, сформированный из этого изменяемого массива и другого итерируемого набора, объединяя соответствующие элементы парами. Если один из двух наборов длиннее другого, оставшиеся элементы игнорируются.
Примечание: результаты могут отличаться при разных запусках, если тип базового набора не упорядочен.
- B
тип второй половины возвращаемых пар
- that
Итерируемый набор, предоставляющий вторую половину каждой пары результата
- returns
новый изменяемый массив, содержащий пары, состоящие из соответствующих элементов этого изменяемого массива и
that. Длина возвращаемого набора — это минимальное из длин этого изменяемого массива иthat.
- Definition Classes
- IterableLike → GenIterableLike
def zipAll[B](that: collection.Iterable[B], thisElem: A, thatElem: B): Map[(A, B)]
Возвращает изменяемый массив, сформированный из этого изменяемого массива и другого итерируемого набора, объединяя соответствующие элементы парами. Если один из двух наборов короче другого, для расширения короче набора до длины более длинного используются заполнительные элементы.
Примечание: результаты могут отличаться при разных запусках, если тип базового набора не упорядочен.
- B
тип второй половины возвращаемых пар
- that
Итерируемый набор, предоставляющий вторую половину каждой пары результата
- thisElem
элемент, используемый для заполнения результата, если этот изменяемый массив короче, чем
that.- thatElem
элемент, используемый для заполнения результата, если
thatкороче, чем этот изменяемый массив.- returns
новый изменяемый массив, содержащий пары, состоящие из соответствующих элементов этого изменяемого массива и
that. Длина возвращаемого набора — это максимальное из длин этого изменяемого массива иthat. Если этот изменяемый массив короче, чемthat, значенияthisElemиспользуются для заполнения результата. Еслиthatкороче, чем этот изменяемый массив, значенияthatElemиспользуются для заполнения результата.
- Definition Classes
- IterableLike → GenIterableLike
def zipWithIndex: Map[(A, Int)]
Сжатие этой изменяемой карты с её индексами.
Примечание: могут быть получены разные результаты при разных запусках, если только тип базовой коллекции не упорядочен.
- возвращает
Новая изменяемая карта, содержащая пары, состоящие из всех элементов этой изменяемой карты, сопоставленных с их индексом. Индексы начинаются с
0.
- Определяющие классы
- IterableLike → GenIterableLike
List("a", "b", "c").zipWithIndex = List(("a", 0), ("b", 1), ("c", 2))
def →[B](y: B): (ImmutableMapAdaptor[A, B], B)
- Неявный
- Этот член добавлен неявным преобразованием из ImmutableMapAdaptor[A, B] в ArrowAssoc[ImmutableMapAdaptor[A, B]] с помощью метода ArrowAssoc в scala.Predef.
- Определяющие классы
- ArrowAssoc
Члены-значения с затемнённым неявным значением
def +(other: String): String
- Неявный
- Этот член добавлен путём неявного преобразования из ImmutableMapAdaptor[A, B] в any2stringadd[ImmutableMapAdaptor[A, B]] с помощью метода any2stringadd в scala.Predef.
- Затемнённый
- Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(immutableMapAdaptor: any2stringadd[ImmutableMapAdaptor[A, B]]).+(other)
- Классы определений
- any2stringadd
def filter(p: ((A, B)) ⇒ Boolean): TraversableOnce[(A, B)]
- Неявный
- Этот член добавлен путём неявного преобразования из ImmutableMapAdaptor[A, B] в MonadOps[(A, B)] с помощью метода MonadOps в scala.collection.TraversableOnce.
- Затемнённый
- Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(immutableMapAdaptor: MonadOps[(A, B)]).filter(p)
- Классы определений
- MonadOps
def flatMap[B](f: ((A, B)) ⇒ GenTraversableOnce[B]): TraversableOnce[B]
- Неявный
- Этот член добавлен путём неявного преобразования из ImmutableMapAdaptor[A, B] в MonadOps[(A, B)] с помощью метода MonadOps в scala.collection.TraversableOnce.
- Затемнённый
- Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(immutableMapAdaptor: MonadOps[(A, B)]).flatMap(f)
- Классы определений
- MonadOps
def map[B](f: ((A, B)) ⇒ B): TraversableOnce[B]
- Неявный
- Этот член добавлен путём неявного преобразования из ImmutableMapAdaptor[A, B] в MonadOps[(A, B)] с помощью метода MonadOps в scala.collection.TraversableOnce.
- Затемнённый
- Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(immutableMapAdaptor: MonadOps[(A, B)]).map(f)
- Классы определений
- MonadOps
def withFilter(p: ((A, B)) ⇒ Boolean): Iterator[(A, B)]
- Неявный
- Этот член добавлен путём неявного преобразования из ImmutableMapAdaptor[A, B] в MonadOps[(A, B)] с помощью метода MonadOps в scala.collection.TraversableOnce.
- Затемнённый
- Этот неявно унаследованный член затемнён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(immutableMapAdaptor: 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/mutable/ImmutableMapAdaptor.html
Этот класс может использоваться в качестве адаптера для создания изменяемых карт из неизменяемых реализаций карт. Метод
emptyнеобходимо переопределить, если исходная неизменяемая карта не пустая. Методemptyдолжен возвращать представление пустой карты.(С версии 2.11.0) адаптеры ненадёжны и склонны к проблемам производительности
1