Трейт scala.collection.GenIterableLike

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

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

Примечание: /: — это альтернативная запись для 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 преобразует каждый входной символ в целое число и добавляет его к сумме (раздела). Затем, combop просто суммирует промежуточные результаты разделов:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание: Реализации в подклассах, которые не являются многократно проходимыми, должны позаботиться о том, чтобы не потреблять никаких элементов при вызове 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).

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

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

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

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

Выбирает первые 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]] нет. В последнем примере, из-за стирания аргумента типа во время компиляции невозможно проверить, соответствуют ли содержимое списка запрошенному типу.

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

на которых она определена.

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

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

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

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

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

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

Сравнивает объект-получатель (this) с объектом-аргументом (that) на предмет эквивалентности.

Любая реализация этого метода должна быть отношением эквивалентности:

Она рефлексивна: для любого экземпляра x типа Any, x.equals(x) должен возвращать true.Она симметрична: для любых экземпляров x и y типа Any, x.equals(y) должен возвращать true, если и только если y.equals(x) возвращает true.Она транзитивна: для любых экземпляров x, y и z типа Any, если x.equals(y) возвращает true и y.equals(z) возвращает true, то x.equals(z) должен возвращать true.

Если вы переопределяете этот метод, вы должны убедиться, что ваша реализация остаётся отношением эквивалентности. Кроме того, при переопределении этого метода обычно необходимо переопределить hashCode, чтобы гарантировать, что объекты, которые являются "равными" (o1.equals(o2) возвращает true ), имеют одинаковый хэш-код scala.Int. (o1.hashCode.equals(o2.hashCode)).

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

и используя элементы полученных коллекций.

Например:

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 (@см. java.lang.String.format).

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

Алгоритм хэширования по умолчанию зависит от платформы.

Следует понимать, что для двух объектов могут совпадать хэш-коды (o1.hashCode.equals(o2.hashCode)) но они могут быть не равны (o1.equals(o2) возвращает false). Вырожденная реализация может всегда возвращать 0. Однако, требуется, чтобы если два объекта равны (o1.equals(o2) возвращает true) у них были одинаковые хэш-коды (o1.hashCode.equals(o2.hashCode)). Поэтому, при переопределении этого метода, убедитесь, что поведение согласуется с методом equals.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Объединяет эту общую итерируемую коллекцию с ее индексами.

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