Класс scala.Option

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

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

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

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

Отличается от ++ тем, что правый операнд определяет тип возвращаемой коллекции, а не левый. Мнемоника: двоеточие находится с той стороны нового типа коллекции.

Пример:

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 и ниже могут использовать перегруз.

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

Она отличается от ++ тем, что правый операнд определяет тип результирующей коллекции, а не левый. Мемоническое правило: двоеточие находится на стороне типа новой коллекции.

Пример:

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)

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

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

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

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

Добавляет все элементы этой итерируемой коллекции в строковый билдер, используя разделительную строку. Записанный текст состоит из строковых представлений (относительно метода 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

Добавляет все элементы этой итерируемой коллекции в строковый билдер, используя начальную, конечную и разделительную строки. Записанный текст начинается со строки start и заканчивается строкой end. Внутри, строковые представления (относительно метода 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 , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)

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

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

Преобразует принимаемый объект в тип T0.

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

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

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

Возвращает scala.Some, содержащий результат применения pf к содержимому этого scala.Option, если этот параметр не пустой и pf определен для этого значения. В противном случае возвращает None.

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

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

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

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

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

Это эквивалентно:

option match {
  case Some(x) => x == elem
  case None    => false
}

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает true, если этот вариант не пустой и предикат p возвращает true при применении к значению этого scala.Option. В противном случае возвращает false.

Это эквивалентно:

option match {
  case Some(x) => p(x)
  case None    => false
}

Возвращает этот scala.Option, если он не пустой и применение предиката p к значению этого scala.Option возвращает true. В противном случае возвращает None.

Это эквивалентно:

option match {
  case Some(x) if p(x) => Some(x)
  case _               => None
}

Возвращает этот scala.Option, если он не пустой и применение предиката p к значению этого scala.Option возвращает false. В противном случае возвращает None.

Это эквивалентно:

option match {
  case Some(x) if !p(x) => Some(x)
  case _                => None
}

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

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

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

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

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

Возвращает результат применения f к значению этого scala.Option, если этот scala.Option не пуст. Возвращает None если этот scala.Option пуст. Несколько отличается от map, так как f ожидается, что вернет scala.Option (который может быть None).

Эквивалентно:

option match {
  case Some(x) => f(x)
  case None    => None
}

Возвращает результат применения f к значению этого scala.Option, если scala.Option не пуст. В противном случае вычисляет выражение ifEmpty.

Эквивалентно:

option match {
  case Some(x) => f(x)
  case None    => ifEmpty
}

Также эквивалентно:

option map f getOrElse ifEmpty

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

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

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

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

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

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

Возвращает true, если этот параметр пуст или предикат p возвращает true, когда применяется к значению этого scala.Option.

Это эквивалентно:

option match {
  case Some(x) => p(x)
  case None    => true
}

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

Это эквивалентно:

option match {
  case Some(x) => f(x)
  case None    => ()
}

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

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

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

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

Это эквивалентно:

option match {
  case Some(x) => x
  case None    => default
}

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает true, если опция является экземпляром scala.Some, иначе false.

Это эквивалентно:

option match {
  case Some(_) => true
  case None    => false
}

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

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

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

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

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

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

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

Возвращает scala.Some, содержащий результат применения f к значению этого scala.Option, если этот scala.Option непустой. В противном случае возвращает None.

Это эквивалентно:

option match {
  case Some(x) => Some(f(x))
  case None    => None
}

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

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

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

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

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

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

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

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

Возвращает false, если опция None, иначе true.

Это эквивалентно:

option match {
  case Some(_) => true
  case None    => false
}

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

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

Возвращает этот scala.Option, если он не пуст, в противном случае возвращает результат вычисления alternative.

Эквивалентно:

option match {
  case Some(x) => Some(x)
  case None    => alternative
}

Возвращает значение опции, если она не пуста, или null если она пуста.

Хотя использование null не рекомендуется, код, написанный для использования scala.Option, часто должен взаимодействовать с кодом, ожидающим и возвращающим null.

Эквивалентно:

option match {
  case Some(x) => x
  case None    => null
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример:

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

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

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

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

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

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

from <= indexOf(x) < until

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает scala.util.Right, содержащий переданный аргумент right, если он пустой, или scala.util.Left, содержащий значение этого scala.Option, если этот scala.Option непустой.

Это эквивалентно:

option match {
  case Some(x) => Left(x)
  case None    => Right(right)
}

Возвращает список из одного элемента, содержащий значение scala.Option, если он непустой, или пустой список, если scala.Option пустой.

Это эквивалентно:

option match {
  case Some(x) => List(x)
  case None    => Nil
}

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

Возвращает scala.util.Left содержащий заданный аргумент left если этот scala.Option пуст, или scala.util.Right содержащий значение этого scala.Option, если он непуст.

Это эквивалентно:

option match {
  case Some(x) => Right(x)
  case None    => Left(left)
}

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

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

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

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

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

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

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

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

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

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

Транспонирует этот итерируемый набор перебираемых наборов в итерируемый набор итерируемых наборов.

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

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 = Iterable(
           (1, "one"),
           (2, "two"),
           (3, "three")).unzip
// xs == (Iterable(1, 2, 3),
//        Iterable(one, two, three))

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

val xs = Iterable(
           (1, "one", '1'),
           (2, "two", '2'),
           (3, "three", '3')).unzip3
// xs == (Iterable(1, 2, 3),
//        Iterable(one, two, three),
//        Iterable(1, 2, 3))

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

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

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

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

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

Необходимо для предотвращения неявного преобразования scala.Option в scala.collection.Iterable в for выражениях.

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

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

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

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

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

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

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

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

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

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

Например:

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)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание: разница между c filter p и c withFilter p в том, что первый создаёт новое множество, а второй только ограничивает область последующих map, flatMap, foreach, и withFilter операций.

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