Spec-Zone.ru › Scala 3.1

Объект scala.collection.immutable.Empty

Исходный код

object Empty extends Stream[Nothing]

Суперадресные типы
25 типов
класс Stream[Nothing]
интерфейс Serializable
интерфейс LinearSeq[Nothing]
интерфейс LinearSeqOps[Nothing, Stream, Stream[Nothing]]
интерфейс LinearSeq[Nothing]
интерфейс LinearSeqOps[Nothing, Stream, Stream[Nothing]]
класс AbstractSeq[Nothing]
интерфейс Seq[Nothing]
интерфейс SeqOps[Nothing, Stream, Stream[Nothing]]
интерфейс Iterable[Nothing]
класс AbstractSeq[Nothing]
интерфейс Seq[Nothing]
интерфейс Equals
интерфейс SeqOps[Nothing, Stream, Stream[Nothing]]
интерфейс PartialFunction[Int, Nothing]
интерфейс Int => Nothing
класс AbstractIterable[Nothing]
интерфейс Iterable[Nothing]
интерфейс IterableFactoryDefaults[Nothing, Stream]
интерфейс IterableOps[Nothing, Stream, Stream[Nothing]]
интерфейс IterableOnceOps[Nothing, Stream, Stream[Nothing]]
интерфейс IterableOnce[Nothing]
класс Object
интерфейс Matchable
класс Any
Тип "self"
Empty.type

Конкретные методы

Исходный код
def force: Empty.type

Вынуждает оценку всего Stream и возвращает её.

Возвращает

Полностью реализованное Stream.

Примечание

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

Исходный код
override def head: Nothing

Классы определений LinearSeqOps -> IterableOps

Исходный код
override def isEmpty: Boolean

Классы определений LinearSeqOps -> SeqOps -> IterableOnceOps

Исходный код
override def knownSize: Int

Классы определений IterableOnce

Исходный код
override def tail: Stream[Nothing]

Классы определений Stream -> LinearSeqOps -> IterableOps

Наследованные методы

Исходный код@inline
final def ++[B](suffix: IterableOnce[B]): Stream[B]

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

Наследован от IterableOps

Исходный код@inline
final override def ++:[B](prefix: IterableOnce[B]): Stream[B]

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

Классы определений SeqOps -> IterableOps
Наследован от SeqOps

Исходный код@inline
final def +:[B](elem: B): Stream[B]

Псевдоним для prepended. Обратите внимание, что операторы с окончанием двоеточием ассоциативны справа (см. пример). Мнемоника для +: против :+: двоеточие ставится со стороны коллекции.

Наследован от SeqOps

Исходный код@inline
final def :+[B](elem: B): Stream[B]

Псевдоним для appended. Обратите внимание, что операторы с окончанием двоеточием ассоциативны справа (см. пример). Мнемоника для +: против :+: двоеточие ставится со стороны коллекции.

Наследован от SeqOps

Исходный код@inline
final def :++[B](suffix: IterableOnce[B]): Stream[B]

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

Наследован от SeqOps

Исходный код
override def addString(sb: StringBuilder, start: String, sep: String, end: String): StringBuilder

Добавляет все элементы этой неизменяемой последовательности в буфер строки, используя строки start, end и separator. Записываемый текст начинается со строки start и заканчивается строкой end. Внутри строковые представления (относительно метода toString) всех элементов этой неизменяемой последовательности разделяются строкой sep.

Неопределённые элементы представляются как "_", неопределённый хвост представляется как "<not computed>", а циклы представляются как "<cycle>".

Параметры значений
end

конечная строка.

sb

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

sep

разделительная строка.

start

начальная строка.

Возвращает

буфер строк b, в который были добавлены элементы.

Классы определений Stream -> IterableOnceOps
Наследован от Stream

Source@inline
final def addString(b: StringBuilder): StringBuilder

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

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

Возвращаемое значение

строковый буфер b, в который были добавлены элементы.

Унаследовано от IterableOnceOps

Source@inline
final def addString(b: StringBuilder, sep: String): StringBuilder

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

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

sep

разделительная строка.

Возвращаемое значение

строковый буфер b, в который были добавлены элементы.

Унаследовано от IterableOnceOps

Source
def andThen[C](k: PartialFunction[Nothing, C]): PartialFunction[Int, C]

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

Обратите внимание, что вызов isDefinedAt для результирующей частичной функции может применить первую частичную функцию и выполнить её побочное действие. Для повышения эффективности рекомендуется вызывать applyOrElse вместо isDefinedAt или apply.

Параметры типов
C

тип результата функции преобразования.

Параметры значений
k

функция преобразования

Возвращаемое значение

частичная функция с областью определения этой частичной функции, суженной другой частичной функцией, которая отображает аргументы x в k(this(x)).

Унаследовано от PartialFunction

Source
override def andThen[C](k: Nothing => C): PartialFunction[Int, C]

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

Если тип функции в момент выполнения является PartialFunction, тогда используется другой andThen метод (обратите внимание на его предостережения).

Параметры типов
C

тип результата функции преобразования.

Параметры значений
k

функция преобразования

Возвращаемое значение

частичная функция с областью определения этой частичной функции, возможно суженной указанной функцией, которая отображает аргументы x в k(this(x)).

Классы определений PartialFunction -> Function1
Унаследовано от PartialFunction

Source
def appended[B](elem: B): Stream[B]

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

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

Пример:

scala> val a = List(1)
a: List[Int] = List(1)

scala> val b = a :+ 2
b: List[Int] = List(1, 2)

scala> println(a)
List(1)
Параметры типа
B

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

Параметры значения
elem

добавляемый элемент

Возвращает

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

Унаследовано от SeqOps

Исходный код
def appendedAll[B](suffix: IterableOnce[B]): Stream[B]

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

Параметры типа
B

тип элемента возвращаемого набора.

Параметры значения
suffix

присоединяемая последовательность.

Возвращает

новый набор типа CC[B], содержащий все элементы этой последовательности, за которыми следуют все элементы suffix.

Унаследовано от SeqOps

Исходный код@throws(scala.throws.$lessinit$greater$default$1[scala.IndexOutOfBoundsException])
override def apply(n: Int): Nothing

Классы определений LinearSeqOps -> SeqOps
Унаследовано от LinearSeqOps

Исходный код
def applyOrElse[A1 <: Int, B1](x: A1, default: A1 => B1): B1

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

Обратите внимание, что выражение pf.applyOrElse(x, default) эквивалентно

if(pf isDefinedAt x) pf(x) else default(x)

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

- объединение частичных функций в цепочки orElse/andThen не приводит к чрезмерному вычислению apply/isDefinedAt - lift и unlift не вычисляют исходные функции дважды при каждом вызове - runWith позволяет эффективно объединять частичные функции в императивном стиле с условным применением действий

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

Параметры значения
default

функция по умолчанию

x

аргумент функции

Возвращает

результат применения этой функции или функции по умолчанию.

Унаследовано от PartialFunction

Исходный код
def canEqual(that: Any): Boolean

Унаследовано от Seq

Исходный код@tailrec
final override def collect[B](pf: PartialFunction[Nothing, B]): Stream[B]

Классы определений Stream -> IterableOps -> IterableOnceOps
Унаследовано от Stream

Source@tailrec
final override def collectFirst[B](pf: PartialFunction[Nothing, B]): Option[B]

Definition Classes Stream -> IterableOnceOps
Inherited from Stream

Source
def combinations(n: Int): Iterator[Stream[Nothing]]

Итерация по комбинациям. _Комбинация_ длиной n — это подпоследовательность исходной последовательности, элементы которой взяты в порядке следования. Таким образом, "xy" и "yy" являются комбинациями длины 2 из "xyy", но "yx" — нет. Если существует более одного способа сгенерировать одну и ту же подпоследовательность, будет возвращена только одна.

Например, "xyyy" имеет три различных способа сгенерировать "xy" в зависимости от того, какой элемент — первый, второй или третий "y" — выбран. Однако, так как все они идентичны, будет выбран только один. Какой из трёх будет выбран — деталь реализации, не определённая.

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

Returns

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

Пример

"abbbc".combinations(2) = Iterator(ab, ac, bb, bc)

Inherited from SeqOps

Source
def compose[R](k: PartialFunction[R, Int]): PartialFunction[R, Nothing]

Компонует другую частичную функцию k с этой частичной функцией, так что эта частичная функция применяется к результатам k.

Обратите внимание, что вызов isDefinedAt на результирующей частичной функции может применить первую частичную функцию и выполнить её побочные эффекты. Для повышения эффективности рекомендуется использовать applyOrElse вместо isDefinedAt или apply.

Type parameters
R

тип параметра функции преобразования.

Value parameters
k

функция преобразования

Returns

частичная функция с областью определения другой частичной функции, суженной с помощью этой частичной функции, которая отображает аргументы x в this(k(x)).

Inherited from PartialFunction

Source@unspecialized
def compose[A](g: A => Int): A => Nothing

Компонует две функции Function1 в новую Function1, применяя эту функцию последней.

Type parameters
A

тип, к которому может быть применена функция g

Value parameters
g

функция A => T1

Returns

новая функция f такая, что f(x) == apply(g(x))

Inherited from Function1

Source@inline
final override def concat[B](suffix: IterableOnce[B]): Stream[B]

Definition Classes SeqOps -> IterableOps
Inherited from SeqOps

Source
override def contains[A1](elem: A1): Boolean

Definition Classes LinearSeqOps -> SeqOps
Inherited from LinearSeqOps

Source
def containsSlice[B](that: Seq[B]): Boolean

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

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

Value parameters
that

исходная последовательность

Returns

true если эта последовательность содержит срез с теми же элементами, что и that, в противном случае false.

Inherited from SeqOps

Source
def copyToArray[B](xs: Array[B], start: Int, len: Int): Int

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

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

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

Type parameters
B

тип элементов массива.

Value parameters
len

максимальное количество копируемых элементов.

start

начальный индекс xs.

xs

массив для заполнения.

Returns

количество элементов, записанных в массив

Note

Переиспользование: После вызова этого метода итератор, на котором он был вызван, должен быть отброшен. Его использование неопределено и может измениться.

Inherited from IterableOnceOps

Source@deprecatedOverriding("This should always forward to the 3-arg version of this method", since = "2.13.4")
def copyToArray[B](xs: Array[B], start: Int): Int

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

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

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

Type parameters
B

тип элементов массива.

Value parameters
start

начальный индекс xs.

xs

массив для заполнения.

Returns

количество элементов, записанных в массив

Note

Переиспользование: После вызова этого метода итератор, на котором он был вызван, должен быть отброшен. Его использование неопределено и может измениться.

Inherited from IterableOnceOps

Source@deprecatedOverriding("This should always forward to the 3-arg version of this method", since = "2.13.4")
def copyToArray[B](xs: Array[B]): Int

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

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

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

Параметры типа
B

тип элементов массива.

Параметры значения
xs

массив для заполнения.

Возвращает

количество элементов, записанных в массив

Примечание

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

Унаследовано от IterableOnceOps

Источник
def corresponds[B](that: IterableOnce[B])(p: (Nothing, B) => Boolean): Boolean

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

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

Параметры типа
B

тип элементов that

Параметры значения
p

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

that

другой набор

Возвращает

true если у обоих наборов одинаковая длина, и p(x, y) равно true для всех соответствующих элементов x этого итератора и y that, в противном случае false

Унаследовано от IterableOnceOps

Источник
def corresponds[B](that: Seq[B])(p: (Nothing, B) => Boolean): Boolean

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

Параметры типа
B

тип элементов that

Параметры значения
p

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

that

другая последовательность

Возвращает

true если у обеих последовательностей одинаковая длина, и p(x, y) равно true для всех соответствующих элементов x этой последовательности и y that, в противном случае false.

Унаследовано от SeqOps

Источник
def count(p: Nothing => Boolean): Int

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

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

Параметры значения
p

предикат для проверки элементов.

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def diff[B](that: Seq[B]): Stream[Nothing]

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

Параметры значения
that

последовательность элементов для удаления

Возвращает

новая последовательность, содержащая все элементы этой последовательности за исключением некоторых вхождений элементов, которые также присутствуют в that. Если значение элемента x появляется n раз в that, то первые n вхождений x не будут частью результата, но все последующие вхождения будут.

Унаследовано от SeqOps

Источник
def distinct: Stream[Nothing]

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

Возвращает

новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.

Унаследовано от SeqOps

Источник
def distinctBy[B](f: Nothing => B): Stream[Nothing]

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

Параметры типа
B

тип элементов после преобразования функцией f

Параметры значения
f

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

Возвращает

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

Унаследовано от SeqOps

Исходный код
def drop(n: Int): Stream[Nothing]

Унаследовано от IterableOps

Исходный код
def dropRight(n: Int): Stream[Nothing]

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

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

Параметры значения
n

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

Возвращает

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

Унаследовано от IterableOps

Исходный код
def dropWhile(p: Nothing => Boolean): Stream[Nothing]

Унаследовано от IterableOps

Исходный код
def elementWise: ElementWiseExtractor[Int, Nothing]

Возвращает объект-экстрактор с методом unapplySeq, который извлекает каждый элемент данных последовательности.

Пример
val firstChar: String => Option[Char] = _.headOption
Seq("foo", "bar", "baz") match {
  case firstChar.unlift.elementWise(c0, c1, c2) =>
    println(s"$c0, $c1, $c2") // Output: f, b, b
}
Унаследовано от PartialFunction

Исходный код
override def empty: Stream[Nothing]

Классы определения IterableFactoryDefaults -> IterableOps
Унаследовано от IterableFactoryDefaults

Исходный код
def endsWith[B](that: Iterable[B]): Boolean

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

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

Параметры значения
that

Последовательность для проверки

Возвращает

true если у этой последовательности that в качестве суффикса, false в противном случае.

Унаследовано от SeqOps

Source
override def equals(o: Any): Boolean

Definition Classes Seq -> Equals -> Any
Inherited from Seq

Source
override def exists(p: Nothing => Boolean): Boolean

Definition Classes LinearSeqOps -> IterableOnceOps
Inherited from LinearSeqOps

Source
override def filter(pred: Nothing => Boolean): Stream[Nothing]

Definition Classes Stream -> IterableOps -> IterableOnceOps
Inherited from Stream

Source
override def filterNot(pred: Nothing => Boolean): Stream[Nothing]

Definition Classes Stream -> IterableOps -> IterableOnceOps
Inherited from Stream

Source@tailrec
final override def find(p: Nothing => Boolean): Option[Nothing]

Definition Classes Stream -> LinearSeqOps -> IterableOnceOps
Inherited from Stream

Source
override def findLast(p: Nothing => Boolean): Option[Nothing]

Definition Classes LinearSeqOps -> SeqOps
Inherited from LinearSeqOps

Source
final override def flatMap[B](f: Nothing => IterableOnce[B]): Stream[B]

Definition Classes Stream -> IterableOps -> IterableOnceOps
Inherited from Stream

Source
def flatten[B](implicit asIterable: Nothing => IterableOnce[B]): Stream[B]

Inherited from IterableOps

Source
def fold[A1](z: A1)(op: (A1, A1) => A1): A1

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

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

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

Type parameters
A1

параметр типа для бинарного оператора, надтип A.

Value parameters
op

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

z

нейтральный элемент для операции fold; может быть добавлен к результату произвольное количество раз, и не должен изменять результат (например, Nil для конкатенации списков, 0 для сложения или 1 для умножения).

Returns

результат применения оператора fold op между всеми элементами и z, или z если эта коллекция пуста.

Inherited from IterableOnceOps

Source@tailrec
final override def foldLeft[B](z: B)(op: (B, Nothing) => B): B

Специализация потока foldLeft, которая позволяет сборщику мусора собирать по ходу.

Type parameters
B

Тип значения, которое накапливается.

Value parameters
op

Операция, выполняемая над последовательными элементами Stream.

z

Начальное значение, заданное в функцию op.

Returns

Накопленное значение из последовательных применений op.

Definition Classes Stream -> LinearSeqOps -> IterableOnceOps
Inherited from Stream

Source
def foldRight[B](z: B)(op: (Nothing, B) => B): B

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

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

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

Type parameters
B

тип результата бинарного оператора.

Value parameters
op

бинарный оператор.

z

начальное значение.

Returns

результат вставки op между последовательными элементами этой коллекции, двигаясь справа налево со стартовым значением z справа: op(x1, op(x2, ... op(xn, z)...)), где x1, ..., xn являются элементами этой коллекции. Возвращает z если эта коллекция пуста.

Inherited from IterableOnceOps

Source
override def forall(p: Nothing => Boolean): Boolean

Definition Classes LinearSeqOps -> IterableOnceOps
Inherited from LinearSeqOps

Source@tailrec
final override def foreach[U](f: Nothing => U): Unit

Применяет данную функцию f к каждому элементу этой линейной последовательности (при сохранении порядка элементов).

Параметры значения
f

Обработка, применяемая к каждому элементу.

Примечание

Переопределено здесь как final для запуска оптимизации вызова хвоста, которая заменяет 'this' на 'tail' на каждой итерации. Это абсолютно необходимо для того, чтобы сборщик мусора мог собрать базовый поток по мере потребления элементов.

Эта функция заставит поток полностью реализоваться, если f не выбросит исключение.

Определяющие классы Stream -> LinearSeqOps -> IterableOnceOps
Унаследовано от Stream

Исходный код
protected def fromSpecific(coll: IterableOnce[Nothing]): Stream[Nothing]

Унаследовано от IterableFactoryDefaults

Исходный код
def groupBy[K](f: Nothing => K): Map[K, Stream[Nothing]]

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

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

Параметры типа
K

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

Параметры значения
f

функция-дискриминатор.

Возвращаемое значение

Карта, отображающая ключи на итерируемые коллекции, в которой выполняется следующее инвариантное условие:

(xs groupBy f)(k) = xs filter (x => f(x) == k)

То есть каждый ключ k связан с итерируемой коллекцией тех элементов x для которых f(x) равно k.

Унаследовано от IterableOps

Исходный код
def groupMap[K, B](key: Nothing => K)(f: Nothing => B): Map[K, Stream[B]]

Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с функцией-дискриминатором 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)

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

Параметры типа
B

тип значений, возвращаемых функцией преобразования.

K

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

Параметры значения
f

функция преобразования элементов

key

функция-дискриминатор

Унаследовано от IterableOps

Исходный код
def groupMapReduce[K, B](key: Nothing => K)(f: Nothing => B)(reduce: (B, B) => B): Map[K, B]

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

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

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

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

Унаследовано от IterableOps

Исходный код
def grouped(size: Int): Iterator[Stream[Nothing]]

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

Параметры значения
size

количество элементов в группе

Возвращаемое значение

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

См. также

scala.collection.Iterator, метод grouped

Унаследовано от IterableOps

Исходный код
override def hashCode(): Int

Определяющие классы Seq -> Any
Унаследовано от Seq

Исходный код
override def headOption: Option[Nothing]

Определяющие классы LinearSeqOps -> IterableOps
Унаследовано от LinearSeqOps

Исходный код@deprecatedOverriding("Override indexOf(elem, from) instead - indexOf(elem) calls indexOf(elem, 0)", "2.13.0")
def indexOf[B](elem: B): Int

Находит индекс первого вхождения некоторого значения в эту последовательность.

Параметры типа
B

тип элемента elem.

Параметры значения
elem

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

Возвращаемое значение

индекс >= 0 первого элемента этой последовательности, который равен (как определяется ==) elem, или -1, если такого элемента нет.

Унаследовано от SeqOps

Исходный код
def indexOf[B](elem: B, from: Int): Int

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

Параметры типа
B

тип элемента elem.

Параметры значения
elem

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

from

начальный индекс

Возвращаемое значение

индекс >= from первого элемента этой последовательности, который равен (как определяется ==) elem, или -1, если такого элемента нет.

Унаследовано от SeqOps

Исходный код@deprecatedOverriding("Override indexOfSlice(that, from) instead - indexOfSlice(that) calls indexOfSlice(that, 0)", "2.13.0")
def indexOfSlice[B](that: Seq[B]): Int

Находит первый индекс, где эта последовательность содержит заданную последовательность как срез.

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

Параметры значения
that

последовательность, для проверки.

Возвращаемое значение

первый индекс >= 0 такой, что элементы этой последовательности, начиная с этого индекса, соответствуют элементам последовательности that, или -1 если такой подпоследовательности не существует.

Унаследовано от SeqOps

Исходный код
def indexOfSlice[B](that: Seq[B], from: Int): Int

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

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

Параметры значения
from

начальный индекс

that

последовательность для проверки

Возвращает

первый индекс >= from такой, что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательности that, или -1 если такая подпоследовательность отсутствует.

Унаследовано от SeqOps

Источник
override def indexWhere(p: Nothing => Boolean, from: Int): Int

Классы определения LinearSeqOps -> SeqOps
Унаследовано от LinearSeqOps

Источник@deprecatedOverriding("Override indexWhere(p, from) instead - indexWhere(p) calls indexWhere(p, 0)", "2.13.0")
def indexWhere(p: Nothing => Boolean): Int

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

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

Параметры значения
p

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

Возвращает

индекс >= 0 первого элемента этой последовательности, удовлетворяющего предикату p, или -1, если такой элемент отсутствует.

Унаследовано от SeqOps

Источник
def indices: Range

Создаёт диапазон всех индексов этой последовательности.

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

Возвращает

значение Range от 0 до значения, на единицу меньшего, чем длина этой последовательности.

Унаследовано от SeqOps

Источник
def init: Stream[Nothing]

Начальная часть коллекции без её последнего элемента.

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

Унаследовано от IterableOps

Источник
def inits: Iterator[Stream[Nothing]]

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

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

Возвращает

итератор по всем начальным частям (inits) этой коллекции

Пример

List(1,2,3).inits = Iterator(List(1,2,3), List(1,2), List(1), Nil)

Унаследовано от IterableOps

Источник
def intersect[B](that: Seq[B]): Stream[Nothing]

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

Параметры значения
that

последовательность элементов для пересечения.

Возвращает

новая последовательность, содержащая все элементы этой последовательности, которые также присутствуют в that. Если значение элемента x встречается n раз в that, то первые n вхождений x будут сохранены в результате, но любые последующие вхождения будут опущены.

Унаследовано от SeqOps

Источник
override def isDefinedAt(x: Int): Boolean

Классы определения LinearSeqOps -> SeqOps
Унаследовано от LinearSeqOps

Источник
override def isTraversableAgain: Boolean

Классы определения IterableOps -> IterableOnceOps
Унаследовано от IterableOps

Источник
override def iterableFactory: SeqFactory[Stream]

Классы определения Stream -> LinearSeq -> LinearSeq -> Seq -> Iterable -> Seq -> Iterable -> IterableOps
Унаследовано от Stream

Источник
def iterator: Iterator[Nothing]

Унаследовано от LinearSeqOps

Источник
override def last: Nothing

Классы определения LinearSeqOps -> IterableOps
Унаследовано от LinearSeqOps

Источник
def lastIndexOf[B](elem: B, end: Int): Int

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

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

Параметры типа
B

тип элемента elem.

Параметры значения
elem

значение элемента для поиска.

end

конечный индекс.

Возвращает

индекс <= end последнего элемента этой последовательности, равного (как определяется ==) elem, или -1, если такой элемент отсутствует.

Унаследовано от SeqOps

Источник@deprecatedOverriding("Override lastIndexOfSlice(that, end) instead - lastIndexOfSlice(that) calls lastIndexOfSlice(that, Int.MaxValue)", "2.13.0")
def lastIndexOfSlice[B](that: Seq[B]): Int

Находит последний индекс, где эта последовательность содержит заданную последовательность как срез.

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

Параметры значения
that

последовательность для проверки

Возвращает

последний индекс, такой что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательности that, или -1 если такая подпоследовательность отсутствует.

Унаследовано от SeqOps

Источник
def lastIndexOfSlice[B](that: Seq[B], end: Int): Int

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

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

Параметры значения
end

индекс окончания

that

последовательность для проверки

Возвращает

последний индекс <= end такой, что элементы этой последовательности, начиная с этого индекса, соответствуют элементам последовательности that, или -1 если такая подпоследовательность не существует.

Унаследовано от SeqOps

Источник
override def lastIndexWhere(p: Nothing => Boolean, end: Int): Int

Классы определений LinearSeqOps -> SeqOps
Унаследовано от LinearSeqOps

Источник@deprecatedOverriding("Override lastIndexWhere(p, end) instead - lastIndexWhere(p) calls lastIndexWhere(p, Int.MaxValue)", "2.13.0")
def lastIndexWhere(p: Nothing => Boolean): Int

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

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

Параметры значения
p

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

Возвращает

индекс последнего элемента этой последовательности, удовлетворяющего предикату p, или -1, если такового нет.

Унаследовано от SeqOps

Источник
def lastOption: Option[Nothing]

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

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

Возвращает

последний элемент этой итерируемой коллекции$, если она непуста, None если она пуста.

Унаследовано от IterableOps

Источник
def lazyAppendedAll[B](suffix: => IterableOnce[B]): Stream[B]

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

Параметры значения
suffix

Коллекция, которая добавляется к этому потоку

Возвращает

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

Унаследовано от Stream

Источник
def lazyZip[B](that: Iterable[B]): LazyZip2[Nothing, B, Empty.type]

Аналогично 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)
Параметры типа
B

тип второго элемента в каждой паре

Параметры значения
that

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

Возвращает

декоратор LazyZip2, который позволяет выполнять строгие операции над лениво вычисляемыми парами или объединенными вызовами lazyZip. Также поддерживается неявное преобразование в Iterable[(A, B)].

Унаследовано от Iterable

Источник
def length: Int

Унаследовано от LinearSeqOps

Источник
override def lengthCompare(that: Iterable[_]): Int

Классы определений LinearSeqOps -> SeqOps
Унаследовано от LinearSeqOps

Источник
override def lengthCompare(len: Int): Int

Классы определений LinearSeqOps -> SeqOps
Унаследовано от LinearSeqOps

Источник@inline
final def lengthIs: SizeCompareOps

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

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

this.lengthIs < len     // this.lengthCompare(len) < 0
this.lengthIs <= len    // this.lengthCompare(len) <= 0
this.lengthIs == len    // this.lengthCompare(len) == 0
this.lengthIs != len    // this.lengthCompare(len) != 0
this.lengthIs >= len    // this.lengthCompare(len) >= 0
this.lengthIs > len     // this.lengthCompare(len) > 0
Унаследовано от SeqOps

Источник
def lift: Int => Option[Nothing]

Преобразует эту частичную функцию в простую функцию, возвращающую Option результат.

Возвращает

функцию, которая принимает аргумент x к Some(this(x)) если this определена для x, и к None в противном случае.

См. также

Function.unlift

Унаследовано от PartialFunction

Источник
final override def map[B](f: Nothing => B): Stream[B]

Классы определений Stream -> IterableOps -> IterableOnceOps
Унаследовано от Stream

Источник
def max[B](implicit ord: Ordering[B]): Nothing

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

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

Параметры типа
B

Тип, для которого определено упорядочение.

Параметры значения
ord

Упорядочение, используемое для сравнения элементов.

Возвращает

наибольший элемент этой коллекции относительно упорядочения ord.

Исключения
UnsupportedOperationException

если эта коллекция пуста.

Унаследовано от IterableOnceOps

Источник
def maxBy[B](f: Nothing => B)(implicit cmp: Ordering[B]): Nothing

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

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

Параметры типа
B

Тип результата функции f.

Параметры значения
cmp

Порядок для сравнения элементов.

f

Функция измерения.

Возвращает

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

Исключения
UnsupportedOperationException

если этот набор пустой.

Унаследовано от IterableOnceOps

Источник
def maxByOption[B](f: Nothing => B)(implicit cmp: Ordering[B]): Option[Nothing]

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

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

Параметры типа
B

Тип результата функции f.

Параметры значения
cmp

Порядок для сравнения элементов.

f

Функция измерения.

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def maxOption[B](implicit ord: Ordering[B]): Option[Nothing]

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

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

Параметры типа
B

Тип, по которому определен порядок.

Параметры значения
ord

Порядок для сравнения элементов.

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def min[B](implicit ord: Ordering[B]): Nothing

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

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

Параметры типа
B

Тип, по которому определен порядок.

Параметры значения
ord

Порядок для сравнения элементов.

Возвращает

наименьший элемент этого набора относительно порядка ord.

Исключения
UnsupportedOperationException

если этот набор пустой.

Унаследовано от IterableOnceOps

Источник
def minBy[B](f: Nothing => B)(implicit cmp: Ordering[B]): Nothing

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

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

Параметры типа
B

Тип результата функции f.

Параметры значения
cmp

Порядок для сравнения элементов.

f

Функция измерения.

Возвращает

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

Исключения
UnsupportedOperationException

если этот набор пустой.

Унаследовано от IterableOnceOps

Источник
def minByOption[B](f: Nothing => B)(implicit cmp: Ordering[B]): Option[Nothing]

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

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

Параметры типа
B

Тип результата функции f.

Параметры значения
cmp

Порядок для сравнения элементов.

f

Функция измерения.

Возвращает

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

Унаследовано от IterableOnceOps

Источник
def minOption[B](implicit ord: Ordering[B]): Option[Nothing]

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

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

Параметры типа
B

Тип, по которому определен порядок.

Параметры значения
ord

Порядок для сравнения элементов.

Возвращает

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

Унаследовано от IterableOnceOps

Источник@inline
final def mkString: String

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

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

Возвращает

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

Унаследовано от IterableOnceOps

Источник@inline
final def mkString(sep: String): String

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

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

Параметры значения
sep

разделительная строка.

Возвращает

строковое представление этой коллекции. В результирующей строке строковые представления (в соответствии с методом toString) всех элементов этой коллекции разделяются строкой sep.

Пример

List(1, 2, 3).mkString("|") = "1|2|3"

Унаследовано от IterableOnceOps

Источник
final def mkString(start: String, sep: String, end: String): String

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

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

Параметры значения
end

конечная строка.

sep

разделительная строка.

start

начальная строка.

Возвращает

строковое представление этой коллекции. Результирующая строка начинается со строки start и заканчивается строкой end. Внутри строковые представления (в соответствии с методом toString) всех элементов этой коллекции разделяются строкой sep.

Пример

List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"

Унаследовано от IterableOnceOps
END_OF_DOCUMENT_MARKER

Source
protected def newSpecificBuilder: Builder[Nothing, Stream[Nothing]]

Унаследовано от IterableFactoryDefaults

Source@deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")
def nonEmpty: Boolean

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

Возвращает

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

Унаследовано от IterableOnceOps

Source
def orElse[A1 <: Int, B1](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]

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

Параметры типа
A1

тип аргумента функции-обработчика исключений

B1

тип результата функции-обработчика исключений

Параметры значения
that

функция-обработчик исключений

Возвращает

частичная функция, областью определения которой является объединение областей определения этой частичной функции и that. Результирующая частичная функция принимает x к this(x), где this определена, и к that(x) в противном случае.

Унаследовано от PartialFunction

Source
def padTo[B](len: Int, elem: B): Stream[B]

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

Параметры типа
B

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

Параметры значения
elem

значение для заполнения

len

целевая длина

Возвращает

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

Унаследовано от SeqOps

Source
override def partition(p: Nothing => Boolean): (Stream[Nothing], Stream[Nothing])

Классы определения Stream -> IterableOps
Унаследовано от Stream

Source
def partitionMap[A1, A2](f: Nothing => Either[A1, A2]): (Stream[A1], Stream[A2])

Применяет функцию 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))
Параметры типа
A1

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

A2

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

Параметры значения
f

функция 'разделения', отображающая элементы этой итерационной коллекции на scala.util.Either

Возвращает

пару итерационных коллекций: первая из значений, возвращаемых f, которые были заключены в scala.util.Left, и вторая из значений, заключенных в scala.util.Right.

Унаследовано от IterableOps

Source
def patch[B](from: Int, other: IterableOnce[B], replaced: Int): Stream[B]

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

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

Параметры типа
B

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

Параметры значения
from

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

other

заменяющая последовательность

replaced

количество элементов, которые нужно опустить в исходной последовательности

Возвращает

новую последовательность, состоящую из всех элементов этой последовательности, за исключением того, что replaced элементы, начиная с from, заменяются всеми элементами other.

Унаследовано от SeqOps

Source
def permutations: Iterator[Stream[Nothing]]

Итерирует по различным перестановкам.

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

Возвращает

Итератор, который проходит по различным перестановкам этой последовательности.

Пример

"abb".permutations = Iterator(abb, bab, bba)

Унаследовано от SeqOps

Source
final override def prepended[B](elem: B): Stream[B]

Классы определения Stream -> SeqOps
Унаследовано от Stream

Source
def prependedAll[B](prefix: IterableOnce[B]): Stream[B]

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

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

Параметры типа
B

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

Параметры значения
prefix

итерационная коллекция для вставки.

Возвращает

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

Унаследовано от SeqOps

Source
def product[B](implicit num: Numeric[B]): B

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

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

Параметры типа
B

тип результата оператора *.

Параметры значения
num

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

Возвращает

произведение всех элементов этой коллекции относительно оператора * в num.

Унаследовано от IterableOnceOps
END_OF_DOCUMENT_MARKER

Источник
def reduce[B](op: (B, B) => B): B

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

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

Параметры типа
B

Параметр типа для бинарного оператора, надтипом A.

Параметры значения
op

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

Возвращает

Результат применения оператора reduce op между всеми элементами, если коллекция не пуста.

Исключения
UnsupportedOperationException

если эта коллекция пуста.

Унаследовано от IterableOnceOps

Источник
final override def reduceLeft[B](f: (B, Nothing) => B): B

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

Параметры типа
B

Тип накапливаемого значения.

Параметры значения
f

Операция, выполняемая над последовательными элементами Stream.

Возвращает

Накопленное значение из последовательных применений f.

Классы определения Stream -> IterableOnceOps
Унаследовано от Stream

Источник
def reduceLeftOption[B](op: (B, Nothing) => B): Option[B]

Применяет бинарный оператор ко всем элементам этой коллекции слева направо (по возможности).

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

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

Параметры типа
B

тип результата бинарного оператора.

Параметры значения
op

бинарный оператор.

Возвращает

значение-опция, содержащее результат reduceLeft(op), если эта коллекция не пуста, None в противном случае.

Унаследовано от IterableOnceOps

Источник
def reduceOption[B](op: (B, B) => B): Option[B]

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

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

Параметры типа
B

Параметр типа для бинарного оператора, надтипом A.

Параметры значения
op

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

Возвращает

Значение-опция, содержащее результат применения оператора reduce op между всеми элементами, если коллекция не пуста, и None в противном случае.

Унаследовано от IterableOnceOps

Источник
def reduceRight[B](op: (Nothing, B) => B): B

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

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

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

Параметры типа
B

тип результата бинарного оператора.

Параметры значения
op

бинарный оператор.

Возвращает

результат вставки op между последовательными элементами этой коллекции справа налево: op(x1, op(x2, ..., op(xn-1, xn)...)), где x1, ..., xn — это элементы этой коллекции.

Исключения
UnsupportedOperationException

если эта коллекция пуста.

Унаследовано от IterableOnceOps

Источник
def reduceRightOption[B](op: (Nothing, B) => B): Option[B]

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

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

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

Параметры типа
B

тип результата бинарного оператора.

Параметры значения
op

бинарный оператор.

Возвращает

значение-опцию, содержащую результат reduceRight(op) если эта коллекция не пуста, None в противном случае.

Унаследовано от IterableOnceOps

Источник
def reverse: Stream[Nothing]

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

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

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

Возвращает

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

Унаследовано от SeqOps

Источник
def reverseIterator: Iterator[Nothing]

Итератор, возвращающий элементы в обратном порядке.

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

Примечание: xs.reverseIterator эквивалентно xs.reverse.iterator, но может быть более эффективным.

Возвращает

итератор, возвращающий элементы этой последовательности в обратном порядке

Унаследовано от SeqOps

Источник
protected def reversed: Iterable[Nothing]

Унаследовано от IterableOnceOps

Источник
def runWith[U](action: Nothing => U): Int => Boolean

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

Обратите внимание, что выражение pf.runWith(action)(x) эквивалентно

if(pf isDefinedAt x) { action(pf(x)); true } else false

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

Параметры значения
action

функция-действие

Возвращает

функция, которая отображает аргументы x в isDefinedAt(x). Результирующая функция выполняет action(this(x)) там, где this определена.

См. также

applyOrElse.

Унаследовано от PartialFunction

Источник
override def sameElements[B](that: IterableOnce[B]): Boolean

Классы определения LinearSeqOps -> SeqOps
Унаследовано от LinearSeqOps

Исходный код
def scan[B](z: B)(op: (B, B) => B): Поток[B]

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

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

Параметры типа
B

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

Параметры значения
op

ассоциативный оператор для сканирования

z

нейтральный элемент для оператора op

Возвращает

новая итеративная коллекция, содержащая префиксное сканирование элементов в этой итеративной коллекции

Унаследовано от IterableOps

Исходный код
override def scanLeft[B](z: B)(op: (B, Nothing) => B): Поток[B]

Классы определения Поток -> IterableOps -> IterableOnceOps
Унаследовано от Поток

Исходный код
def scanRight[B](z: B)(op: (Nothing, B) => B): Поток[B]

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

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

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

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

Пример:

List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)
Параметры типа
B

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

Параметры значения
op

бинарный оператор, применяемый к промежуточному результату и элементу

z

начальное значение

Возвращает

коллекция с промежуточными результатами

Унаследовано от IterableOps

Исходный код
def search[B](elem: B, from: Int, to: Int)(implicit ord: Ordering[B]): SearchResult

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

Последовательность должна быть отсортирована с тем же Ordering перед вызовом; в противном случае результаты не определены.

Параметры значения
elem

элемент для поиска.

from

индекс, с которого начинается поиск.

ord

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

to

индекс, следующий за тем, где поиск заканчивается.

Возвращает

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

См. также

scala.collection.IndexedSeq

scala.math.Ordering

scala.collection.SeqOps, метод sorted

Примечание

если to <= from, пространство поиска пустое, и возвращается InsertionPoint в from

Унаследовано от SeqOps

Исходный код
def search[B](elem: B)(implicit ord: Ordering[B]): SearchResult

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

Последовательность должна быть отсортирована с тем же Ordering перед вызовом; в противном случае результаты не определены.

Параметры значения
elem

элемент для поиска.

ord

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

Возвращает

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

См. также

scala.collection.IndexedSeq

scala.math.Ordering

scala.collection.SeqOps, метод sorted

Унаследовано от SeqOps

Исходный код
override def segmentLength(p: Nothing => Boolean, from: Int): Int

Классы определения LinearSeqOps -> SeqOps
Унаследовано от LinearSeqOps

Исходный код
final def segmentLength(p: Nothing => Boolean): Int

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

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

Параметры значения
p

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

Возвращает

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

Унаследовано от SeqOps

Исходный код
final override def size: Int

Классы определения SeqOps -> IterableOnceOps
Унаследовано от SeqOps

Исходный код
final override def sizeCompare(that: Iterable[_]): Int

Классы определения SeqOps -> IterableOps
Унаследовано от SeqOps

Исходный код
final override def sizeCompare(otherSize: Int): Int

Классы определения SeqOps -> IterableOps
Унаследовано от SeqOps

Исходный код@inline
final def sizeIs: SizeCompareOps

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

Эти операции реализуются с помощью 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
Унаследовано от IterableOps

Исходный код
def slice(from: Int, until: Int): Поток[Nothing]

Унаследовано от IterableOps
END_OF_DOCUMENT_MARKER

Источник
def sliding(size: Int, step: Int): Iterator[Stream[Nothing]]

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

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

Параметры значения
size

количество элементов в группе

step

расстояние между первыми элементами последовательных групп

Возвращает

Итератор, производящий итерируемые коллекции размера size, за исключением последнего элемента (который может быть единственным элементом), который будет меньше, если осталось меньше size элементов для группировки.

См. также

scala.collection.Iterator, метод sliding

Пример

List(1, 2, 3, 4, 5).sliding(2, 2) = Iterator(List(1, 2), List(3, 4), List(5))

List(1, 2, 3, 4, 5, 6).sliding(2, 3) = Iterator(List(1, 2), List(4, 5))

Унаследовано от IterableOps

Источник
def sliding(size: Int): Iterator[Stream[Nothing]]

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

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

Параметры значения
size

количество элементов в группе

Возвращает

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

См. также

scala.collection.Iterator, метод sliding

Пример

List().sliding(2) = empty iterator

List(1).sliding(2) = Iterator(List(1))

List(1, 2).sliding(2) = Iterator(List(1, 2))

List(1, 2, 3).sliding(2) = Iterator(List(1, 2), List(2, 3))

Унаследовано от IterableOps

Источник
def sortBy[B](f: Nothing => B)(implicit ord: Ordering[B]): Stream[Nothing]

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

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

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

Сортировка стабильна. То есть, элементы, которые равны (как определено ord.compare), появляются в отсортированном наборе в том же порядке, что и в исходном.

Параметры типа
B

целевой тип преобразования f, и тип, где определено упорядочение ord.

Параметры значения
f

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

ord

упорядочение, предполагаемое в области B.

Возвращает

набор, состоящий из элементов этого набора, отсортированных в соответствии с упорядочением, где x < y если ord.lt(f(x), f(y)).

См. также

scala.math.Ordering

Пример
val words = "The quick brown fox jumped over the lazy dog".split(' ')
// this works because scala.Ordering will implicitly provide an Ordering[Tuple2[Int, Char]]
words.sortBy(x => (x.length, x.head))
res0: Array[String] = Array(The, dog, fox, the, lazy, over, brown, quick, jumped)
Унаследовано от SeqOps

Источник
def sortWith(lt: (Nothing, Nothing) => Boolean): Stream[Nothing]

Сортирует этот набор в соответствии с функцией сравнения.

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

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

Сортировка является стабильной. То есть, элементы, которые равны (как определено lt), появляются в том же порядке в отсортированной последовательности, что и в исходной.

Параметры значения
lt

функция сравнения, которая проверяет, предшествует ли её первый аргумент второму аргументу в желаемой упорядоченности.

Возвращает

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

Пример
List("Steve", "Tom", "John", "Bob").sortWith(_.compareTo(_) < 0) =
List("Bob", "John", "Steve", "Tom")
Унаследовано от SeqOps

Источник
def sorted[B](implicit ord: Ordering[B]): Stream[Nothing]

Сортирует эту последовательность в соответствии с Ordering.

Сортировка является стабильной. То есть, элементы, которые равны (как определено ord.compare), появляются в том же порядке в отсортированной последовательности, что и в исходной.

Параметры значения
ord

упорядочение, используемое для сравнения элементов.

Возвращает

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

См. также

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

Унаследовано от SeqOps

Источник
def span(p: Nothing => Boolean): (Stream[Nothing], Stream[Nothing])

Унаследовано от IterableOps

Источник
override def splitAt(n: Int): (Stream[Nothing], Stream[Nothing])

Классы-предки IterableOps -> IterableOnceOps
Унаследовано от IterableOps

Источник
def startsWith[B](that: IterableOnce[B], offset: Int): Boolean

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

Примечание: Если и объект-получатель this и аргумент that являются бесконечными последовательностями, этот метод может не завершиться.

Параметры значения
offset

индекс, где ищется последовательность.

that

последовательность для проверки

Возвращает

true если последовательность that содержится в этой последовательности в индексе offset, в противном случае false.

Унаследовано от SeqOps

Источник
def stepper[S <: Stepper[_]](implicit shape: StepperShape[Nothing, S]): S

Возвращает scala.collection.Stepper для элементов этой коллекции.

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

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

END_OF_DOCUMENT_MARKER
  • Для коллекций Int, Short, Byte или Char, возвращается scala.collection.IntStepper

  • Для коллекций Double или Float, возвращается scala.collection.DoubleStepper

  • Для коллекций Long возвращается scala.collection.LongStepper

  • Для любого другого типа элементов возвращается scala.collection.AnyStepper

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

Унаследовано от IterableOnce

Источник
def sum[B](implicit num: Numeric[B]): B

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

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

Параметры типа
B

тип результата операции +.

Параметры значения
num

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

Возвращаемое значение

сумма всех элементов этой коллекции относительно операции + в num.

Унаследовано от IterableOnceOps

Источник
override def tails: Iterator[Stream[Nothing]]

Классы определений LinearSeqOps -> IterableOps
Унаследовано от LinearSeqOps

Источник
override def take(n: Int): Stream[Nothing]

Классы определений Stream -> IterableOps -> IterableOnceOps
Унаследовано от Stream

Источник
def takeRight(n: Int): Stream[Nothing]

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

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

Параметры значения
n

количество элементов для взятия из этой итерируемой коллекции.

Возвращаемое значение

итерируемая коллекция, содержащая только последние n элементов этой итерируемой коллекции, или же вся итерируемая коллекция, если она содержит меньше n элементов. Если n отрицательно, возвращается пустая итерируемая коллекция.

Унаследовано от IterableOps

Источник
def takeWhile(p: Nothing => Boolean): Stream[Nothing]

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

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

Параметры значения
p

Предикат для проверки элементов.

Возвращаемое значение

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

Унаследовано от IterableOps

Источник
override def tapEach[U](f: Nothing => U): Stream[Nothing]

Классы определений IterableOps -> IterableOnceOps
Унаследовано от IterableOps

Источник
def to[C1](factory: Factory[Nothing, C1]): C1

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

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

Унаследовано от IterableOnceOps

Источник
def toArray[B : ClassTag]: Array[B]

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

Примечание реализации: НЕ вызывайте Array.from из этого метода.

Унаследовано от IterableOnceOps

Источник@inline
final def toBuffer[B]: Buffer[B]

Унаследовано от IterableOnceOps

Источник
def toIndexedSeq: IndexedSeq[Nothing]

Унаследовано от IterableOnceOps

Источник
def toList: List[Nothing]

Унаследовано от IterableOnceOps

Источник
def toMap[K, V](implicit ev: Nothing <:< (K, V)): Map[K, V]

Унаследовано от IterableOnceOps

Источник
final override def toSeq: Empty.type

Классы определений Seq -> IterableOnceOps
Унаследовано от Seq

Источник
def toSet[B]: Set[B]

Унаследовано от IterableOnceOps

Источник
override def toString: String

Возвращает

строковое представление этого набора. Неопределённые элементы представлены как "_", неопределённый хвост представлен как "<not computed>", а циклы — как "<cycle>" Примеры:

  • "Stream(_, <not computed>)", непустой поток, заголовок которого не был вычислен;

  • "Stream(_, 1, _, <not computed>)", поток с как минимум тремя элементами, второй из которых был вычислен;

  • "Stream(1, 2, 3, <cycle>)", бесконечный поток, содержащий цикл на четвёртом элементе.

Определяющие классы Stream -> Seq -> Function1 -> Iterable -> Any
Унаследовано от Stream

Источник
def toVector: Vector[Nothing]

Унаследовано от IterableOnceOps

Источник
def transpose[B](implicit asIterable: Nothing => Iterable[B]): Stream[Stream[B]]

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

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

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

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

Параметры типа
B

тип элементов каждого итерируемого набора.

Параметры значения
asIterable

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

Возвращает

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

Исключения
IllegalArgumentException

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

Унаследовано от IterableOps

Источник
def unapply(a: Int): Option[Nothing]

Попытка извлечь B из A в выражении сопоставления с образцом.

Унаследовано от PartialFunction

Источник
def unzip[A1, A2](implicit asPair: Nothing => (A1, A2)): (Stream[A1], Stream[A2])

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

val xs = Iterable(
           (1, "one"),
           (2, "two"),
           (3, "three")).unzip
// xs == (Iterable(1, 2, 3),
//        Iterable(one, two, three))
Параметры типа
A1

тип первой половины пар элементов

A2

тип второй половины пар элементов

Параметры значения
asPair

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

Возвращает

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

Унаследовано от IterableOps

Источник
def unzip3[A1, A2, A3](implicit asTriple: Nothing => (A1, A2, A3)): (Stream[A1], Stream[A2], Stream[A3])

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

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))
Параметры типа
A1

тип первого члена троек элементов

A2

тип второго члена троек элементов

A3

тип третьего члена троек элементов

Параметры значения
asTriple

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

Возвращает

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

Унаследовано от IterableOps

Источник
def updated[B](index: Int, elem: B): Stream[B]

Копия этого последовательности с заменой одного элемента.

Параметры типа
B

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

Параметры значения
elem

элемент для замены

index

позиция замены

Возвращает

новый набор, который является копией этого набора с элементом в позиции index заменённым на elem.

Исключения
IndexOutOfBoundsException

если index не удовлетворяет 0 <= index < length. В случае ленивого набора это исключение может быть выброшено в более позднее время или вообще не быть выброшено (если конец набора никогда не будет вычислен).

Унаследовано от SeqOps

Источник
override def view: SeqView[Nothing]

Определяющие классы SeqOps -> IterableOps
Унаследовано от SeqOps

Источник
final override def withFilter(p: Nothing => Boolean): WithFilter[Nothing, Stream]

collection.WithFilter , позволяющий GC заголовка потока во время обработки

Определяющие классы Stream -> IterableOps
Унаследовано от Stream

Источник
final override def zip[B](that: IterableOnce[B]): Stream[(Nothing, B)]

Определяющие классы Stream -> IterableOps
Унаследовано от Stream

Источник
def zipAll[A1, B](that: Iterable[B], thisElem: A1, thatElem: B): Stream[(A1, B)]

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

Параметры значения
that

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

thatElem

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

thisElem

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

Возвращает

новый набор типа That, содержащий пары, состоящие из соответствующих элементов этого итерируемого набора и that. Длина возвращаемого набора равна максимальному из длин этого итерируемого набора и that. Если этот итерируемый набор короче that, используются значения thisElem для заполнения результата. Если that короче этого итерируемого набора, используются значения thatElem для заполнения результата.

Унаследовано от IterableOps

Source
final override def zipWithIndex: Stream[(Nothing, Int)]

Определяющие классы Stream -> IterableOps -> IterableOnceOps
Унаследовано от Stream

© 2002-2022 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://scala-lang.org/api/3.1.1/scala/collection/immutable/Stream$$Empty$.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API