Trait scala.collection.GenIterable

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

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

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

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

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

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

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

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

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

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

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

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

Выбирает последний элемент (если он существует).

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

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

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

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

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

Реализация 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 может быть ленивой и не вычисленной.

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

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

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

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

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

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

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

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

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

Эквивалентно 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 зависит от платформы.

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

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

Копирует элементы этой коллекции в массив. Заполняет заданный массив 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).

Метод равенства для ссылочных типов. Реализация по умолчанию делегирует вызов к eq.

См. также equals в scala.Any.

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

Детали о том, когда и если вызывается метод 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)

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

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

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)

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

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

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

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

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

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

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

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

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

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

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

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

Билдер, строящий экземпляры типа Traversable[A]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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))

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

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

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

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))

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

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

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

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

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

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