Особенность scala.collection.GenMapLike

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

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

Примечание: /: — это альтернативная синтаксическая конструкция 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

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

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

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

Примечание: :\ — это альтернативная синтаксическая конструкция 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

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

Это более общая форма 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 })

Метод, который должен вызываться из каждого хорошо спроектированного метода equals, который может быть переопределен в подклассе. См. Programming in Scala, Chapter 28 для обсуждения и проектирования.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример:

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

Размер этой общей коллекции.

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

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

from <= indexOf(x) < until

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Создаёт копию объекта-получателя.

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

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

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

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

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

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

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

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

Проверяет, является ли аргумент (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).

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

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

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

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

Например:

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)

Применяет функцию f ко всем элементам этого общего отображения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Умножает элементы этой коллекции.

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

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

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

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

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

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

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

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

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

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

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

Создаёт строковое представление этого объекта. По умолчанию представление зависит от платформы. На платформе Java это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.

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

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

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

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

Зиппует это общее отображение со своими индексами.

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