Класс scala.Option

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

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

Псевдоним для concat

Выражение 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)

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

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

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

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

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

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

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

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

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

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

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

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

Копирует элементы в массив, возвращая количество записанных элементов.

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

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

Копирует элементы в массив, возвращая количество записанных элементов.

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

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

Копирует элементы в массив, возвращая количество записанных элементов.

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

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

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

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

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

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

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

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

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

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

Проверяет, является ли аргумент ссылкой на объект-получатель (that).

Метод 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
}

Возвращает вложенное значение scala.Option, если оно непустое. В противном случае, возвращает None.

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

option match {
  case Some(Some(b)) => Some(b)
  case _             => 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).

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

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

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

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

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

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

Разделяет эту итерируемую коллекцию на карту итерируемых коллекций по функции дискриминатора key. Каждый элемент в группе преобразуется в значение типа B с помощью функции value.

Это эквивалентно groupBy(key).mapValues(_.map(f)), но более эффективно.

case class User(name: String, age: Int)

def namesByAge(users: Seq[User]): Map[Int, Seq[String]] =
  users.groupMap(_.age)(_.name)

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

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

Это эквивалентно groupBy(key).mapValues(_.map(f).reduce(reduce)), но более эффективно.

def occurrences[A](as: Seq[A]): Map[A, Int] =
  as.groupMapReduce(identity)(_ => 1)(_ + _)

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

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

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

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

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

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

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

Часть коллекции без последнего элемента.

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

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

Примечание: Даже при применении к представлению или ленивому набору элементы всегда будут принудительно получены.

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

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

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

Возвращает true, если вариант (option) является None, и false в противном случае.

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

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

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

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

Проверяет, можно ли многократно перебирать этот итерируемый набор. Всегда true для Iterables и false для Iterators, если не переопределено.

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

Возвращает итератор, возвращающий значение scala.Option, если оно не пустое, или пустой итератор, если опция пуста.

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

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

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

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

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

Вызовы lazyZip могут быть объединены для поддержки более высоких арностей (до 4) без дополнительных затрат на построение и деконструирование промежуточных кортежей.

val xs = List(1, 2, 3)
val res = (xs lazyZip xs lazyZip xs lazyZip xs).map((a, b, c, d) => a + b + c + d)
// res == List(4, 8, 12)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Применяет функцию f к каждому элементу итерируемого набора и возвращает пару итерируемых наборов: первый содержит значения, возвращённые f, которые были обернуты в scala.util.Left, а второй — те, что были обернуты в scala.util.Right.

Пример:

val xs = `Iterable`(1, "one", 2, "two", 3, "three") partitionMap {
 case i: Int => Left(i)
 case s: String => Right(s)
}
// xs == (`Iterable`(1, 2, 3),
//        `Iterable`(one, two, three))

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

Имя n-го элемента этого произведения, нумерация с 0. В стандартной реализации — пустая строка.

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

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

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

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

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

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

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

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

Возвращает значение бинарного оператора к элементам этого итерируемого набора, слева направо.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример:

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

Сравнивает размер этой итерируемой коллекции с размером другой Iterable.

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

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

Эти операции реализованы с помощью sizeCompare(Int), и позволяют использовать следующие более удобочитаемые выражения:

this.sizeIs < size     // this.sizeCompare(size) < 0
this.sizeIs <= size    // this.sizeCompare(size) <= 0
this.sizeIs == size    // this.sizeCompare(size) == 0
this.sizeIs != size    // this.sizeCompare(size) != 0
this.sizeIs >= size    // this.sizeCompare(size) >= 0
this.sizeIs > size     // this.sizeCompare(size) > 0

Выбирает интервал элементов. Возвращаемый итерируемый набор состоит из всех элементов 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).

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

Возвращает Stepper для элементов этого набора.

Stepper позволяет создавать поток Java для работы с набором, см. scala.jdk.StreamConverters. Для наборов, содержащих примитивные значения, Stepper можно использовать как итератор, который не упаковывает элементы.

Неявный параметр StepperShape определяет тип возвращаемого Stepper в соответствии с типом элемента этого набора.

Для наборов Int, Short, Byte или Char возвращается IntStepperДля наборов Double или Float возвращается DoubleStepperДля наборов Long возвращается LongStepperДля любого другого типа элемента возвращается AnyStepper

Обратите внимание, что этот метод переопределяется в дочерних классах, и возвращаемый тип уточняется до S with EfficientSplit, например, IndexedSeqOps.stepper. Для Stepper, помеченных scala.collection.Stepper.EfficientSplit, конвертеры в scala.jdk.StreamConverters позволяют создавать параллельные потоки, в то время как обычные Stepper можно преобразовать только в последовательные потоки.

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

Остальная часть набора без первого элемента.

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

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

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

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

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

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

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

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

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

xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]

Преобразование коллекции в массив.

Возвращает 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
}

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

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

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

Создаёт строковое представление этого объекта. По умолчанию представление зависит от платформы. На платформе 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))

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

Преобразует Option пары в Option первого элемента и Option второго элемента.

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

option match {
  case Some((x, y)) => (Some(x), Some(y))
  case _            => (None,    None)
}

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

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

option match {
  case Some((x, y, z)) => (Some(x), Some(y), Some(z))
  case _               => (None,    None,    None)
}

Просмотр элементов этого набора.

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

Возвращает scala.Some, сформированную из этого option и другого option, объединяя соответствующие элементы в пару. Если один из двух options пустой, None возвращается.

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

(option1, option2) match {
  case (Some(x), Some(y)) => Some((x, y))
  case _                  => None
}

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

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

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

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

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

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

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

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

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

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

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

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

Например:

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: String) => 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)

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

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

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)

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

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

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

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

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

Применяет f к каждому элементу для его побочных эффектов. Примечание: параметр [U] необходим для помощи в выводе типа scalac.

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

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

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

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

Делегирует addString, который может быть переопределен.

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

Делегирует addString, который может быть переопределен.

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

Делегирует addString, который может быть переопределен.

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

Размер этого итерируемого множества.

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

Возвращает Stepper для элементов этого множества.

Stepper позволяет создавать Java поток для работы со множеством, см. scala.jdk.StreamConverters. Для коллекций, содержащих примитивные значения, Stepper может использоваться как итератор, который не упаковывает элементы.

Неявный параметр StepperShape определяет тип возвращаемого Stepper в соответствии с типом элемента этой коллекции.

Для коллекций Int, Short, Byte или Char возвращается IntStepperДля коллекций Double или Float возвращается DoubleStepperДля коллекций Long возвращается LongStepperДля любого другого типа элементов возвращается AnyStepper

Обратите внимание, что этот метод переопределен в подклассах и тип возвращаемого значения уточняется до S with EfficientSplit, например IndexedSeqOps.stepper. Для Steppers, помеченных scala.collection.Stepper.EfficientSplit, конвертеры в scala.jdk.StreamConverters позволяют создавать параллельные потоки, в то время как обычные Steppers могут быть преобразованы только в последовательные потоки.

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

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

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

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

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

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

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