Spec-Zone.ru › Scala 3.1

Трейт scala.collection.IterableOnceOps

Исходный код

Трейт IterableOnceOps[+A, +CC[_], +C]

Этот реализуемый трейт можно добавить в IterableOnce для получения основных методов, общих для Iterator и Iterable. IterableOnce должен поддерживать несколько вызовов iterator, но может или не может возвращать тот же Iterator каждый раз.

Супертипы
Класс Any
Известные подтипы
254 типа
trait IterableOps[A, CC, C]
trait EvidenceIterableFactoryDefaults[A, CC, Ev]
class ArraySeq[A]
class булевых значений
class байтовых значений
class символьных значений
class двойных значений
class плавающей точки значений
class целочисленных значений
class длинных значений
class ссылочных значений[T]
class коротких значений
class единичных значений
class UnrolledBuffer[T]
trait Iterable[A]
class AbstractIterable[A]
class AbstractMap[K, V]
class AbstractMap[K, V]
class HashMap[K, V]
class IntMap[T]
class ListMap[K, V]
class LongMap[T]
class Map1[K, V]
class Map2[K, V]
class Map3[K, V]
class Map4[K, V]
class WithDefault[K, V]
class WithDefault[K, V]
class TreeMap[K, V]
class TreeSeqMap[K, V]
class VectorMap[K, V]
class AbstractMap[K, V]
class TrieMap[K, V]
class AnyRefMap[K, V]
class CollisionProofHashMap[K, V]
class HashMap[K, V]
class LinkedHashMap[K, V]
class ListMap[K, V]
class LongMap[V]
class WithDefault[K, V]
class WithDefault[K, V]
class OpenHashMap[Key, Value]
class TreeMap[K, V]
class SystemProperties
class AbstractSeq[A]
class AbstractSeq[A]
class LazyList[A]
class Список[A]
class ::[A]
object Nil.type
class NumericRange[T]
class Исключительно[T]
class Включая[T]
class Очередь[A]
class Диапазон
class Исключительно
class Включая
class Поток[A]
class Cons[A]
object Empty.type
class Вектор[A]
class Оборачивающая строка
class AbstractSeq[A]
class AbstractBuffer[A]
class Массивный буфер[A]
class Двухстороннюю очередь[A]
class Очередь[A]
class Стек[A]
class Список буфера[A]
class Массивный последовательность[T]
class булевых значений
class байтовых значений
class символьных значений
class двойных значений
class плавающей точки значений
class целочисленных значений
class длинных значений
class ссылочных значений[T]
class коротких значений
class единичных значений
class StringBuilder
class AbstractSet[A]
class AbstractSet[A]
class ValueSet
class Неизменяемый набор ключей
class BitSet
class BitSet1
class BitSet2
class BitSetN
class HashSet[A]
class Список набора[A]
class Set1[A]
class Set2[A]
class Set3[A]
class Set4[A]
class Неизменяемый набор отсортированных ключей
class TreeSet[A]
class AbstractSet[A]
class BitSet
class HashSet[A]
class LinkedHashSet[A]
class TreeSet[A]
class AbstractView[A]
class AbstractMapView[K, V]
class Фильтр[K, V]
class Фильтр ключей[K, V]
class Id[K, V]
class MapValues[K, V, W]
class TapEach[K, V, U]
class AbstractSeqView[A]
class AbstractIndexedSeqView[A]
class Срез[A]
class StringView
class ArrayBufferView[A]
class Id[A]
class Id[A]
class Обратный[A]
class Обратный[A]
class Добавленный[A]
class Добавленный[A]
class Добавленный[A]
class Collect[A, B]
class Concat[A]
class Concat[A]
class Concat[A]
class DistinctBy[A, B]
class Drop[A]
class Drop[A]
class Drop[A]
class DropRight[A]
class DropRight[A]
class DropRight[A]
class DropWhile[A]
class Elems[A]
object Empty.type
class Заполнение[A]
class Фильтр[A]
class FlatMap[A, B]
class Итерация[A]
class LeftPartitionMapped[A, A1, A2]
class Map[A, B]
class Map[A, B]
class Map[A, B]
class PadTo[A]
class Префикс[A]
class Префикс[A]
class Префикс[A]
class RightPartitionMapped[A, A1, A2]
class ScanLeft[A, B]
class Single[A]
class Tabulate[A]
class Take[A]
class Take[A]
class Take[A]
class TakeRight[A]
class TakeRight[A]
class TakeRight[A]
class TakeWhile[A]
class Unfold[A, S]
class Updated[A]
class Zip[A, B]
class ZipAll[A, B]
class ZipWithIndex[A]
class AbstractIterable[A]
class Очередь с приоритетами[A]
trait Map[K, V]
trait DefaultMap[K, V]
trait SeqMap[K, V]
trait SeqMap[K, V]
trait SeqMap[K, V]
trait SortedMap[K, V]
trait SortedMap[K, V]
trait SortedMap[K, V]
trait Map[K, V]
trait Map[K, V]
trait Map[K, V]
trait MultiMap[K, V]
trait Seq[A]
trait IndexedSeq[A]
trait IndexedSeq[A]
trait IndexedSeq[T]
trait IndexedBuffer[A]
trait LinearSeq[A]
trait LinearSeq[A]
trait Seq[A]
trait Seq[A]
trait Буфер[A]
class Accumulator[A, CC, C]
class AnyAccumulator[A]
class DoubleAccumulator
class IntAccumulator
class LongAccumulator
trait Набор[A]
trait Отсортированный набор[A]
trait BitSet
trait SortedSet[A]
trait SortedSet[A]
trait Набор[A]
trait Набор[A]
trait Просмотр[A]
trait MapView[K, V]
trait SeqView[A]
trait IndexedSeqView[A]
class Sorted[A, B]
trait Iterable[A]
trait Iterable[A]
trait IterableFactoryDefaults[A, CC]
trait MapFactoryDefaults[K, V, CC, WithFilterCC]
class WeakHashMap[K, V]
trait MapOps[K, V, CC, C]
trait SortedMapFactoryDefaults[K, V, CC, WithFilterCC, UnsortedCC]
trait SortedMapOps[K, V, CC, C]
trait StrictOptimizedSortedMapOps[K, V, CC, C]
trait StrictOptimizedSortedMapOps[K, V, CC, C]
trait SortedMapOps[K, V, CC, C]
trait SortedMapOps[K, V, CC, C]
trait StrictOptimizedMapOps[K, V, CC, C]
trait StrictOptimizedMapOps[K, V, CC, C]
trait MapOps[K, V, CC, C]
trait MapOps[K, V, CC, C]
trait SeqOps[A, CC, C]
trait IndexedSeqOps[A, CC, C]
trait IndexedSeqOps[A, CC, C]
trait IndexedSeqOps[A, CC, C]
trait LinearSeqOps[A, CC, C]
trait StrictOptimizedLinearSeqOps[A, CC, C]
trait LinearSeqOps[A, CC, C]
trait StrictOptimizedSeqOps[A, CC, C]
trait StrictOptimizedSeqOps[A, CC, C]
trait ArrayDequeOps[A, CC, C]
trait SeqOps[A, CC, C]
trait SeqOps[A, CC, C]
trait SetOps[A, CC, C]
trait SortedSetOps[A, CC, C]
trait BitSetOps[C]
trait SortedSetFactoryDefaults[A, CC, WithFilterCC]
trait StrictOptimizedSortedSetOps[A, CC, C]
trait StrictOptimizedSortedSetOps[A, CC, C]
trait SortedSetOps[A, CC, C]
trait SortedSetOps[A, CC, C]
trait StrictOptimizedSetOps[A, CC, C]
trait StrictOptimizedSetOps[A, CC, C]
trait SetOps[A, CC, C]
trait SetOps[A, CC, C]
trait StrictOptimizedIterableOps[A, CC, C]
trait Итератор[A]
class AbstractIterator[A]
class GroupedIterator[B]
class BufferedLineIterator
class LineIterator
class MatchIterator
trait BufferedIterator[A]
class Источник
class Буферизованный источник
Тип самого себя
IterableOnce[A]

Абстрактные методы

Источник
def collect[B](pf: PartialFunction[A, B]): CC[B]

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

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

тип элементов возвращаемой коллекции.
Параметры значения
pf

частичная функция, которая фильтрует и отображает коллекцию.
Возвращает

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

Источник
def drop(n: Int): C

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

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

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

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

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

Источник
def dropWhile(p: A => Boolean): C

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

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

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

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

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

Источник
def filter(p: A => Boolean): C

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

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

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

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

Источник
def filterNot(pred: A => Boolean): C

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

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

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

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

Источник
def flatMap[B](f: A => IterableOnce[B]): CC[B]

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

Например:

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)
Параметры типа
B

тип элементов возвращаемого набора.
Параметры значения
f

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

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

Источник
def flatten[B](implicit asIterable: A => IterableOnce[B]): CC[B]

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

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

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)
Параметры типа
B

тип элементов каждого итерируемого набора.
Параметры значения
asIterable

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

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

Источник
def map[B](f: A => B): CC[B]

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

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

тип элементов возвращаемого набора.
Параметры значения
f

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

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

Источник
def scanLeft[B](z: B)(op: (B, A) => B): CC[B]

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

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

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

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

тип элементов в результирующем наборе
Параметры значения
op

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

z

начальное значение
Возвращает

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

Источник
def slice(from: Int, until: Int): C

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

from <= indexOf(x) < until

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

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

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

until

наименьший индекс для ИСКЛЮЧЕНИЯ из этого набора.
Возвращает

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

Источник
def span(p: A => Boolean): (C, C)

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

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

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

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

предикат проверки
Возвращает

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

Источник
def take(n: Int): C

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

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

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

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

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

Источник
def takeWhile(p: A => Boolean): C

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

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

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

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

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

Источник
def tapEach[U](f: A => U): C

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

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

тип возвращаемого значения f
Параметры значения
f

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

логически такой же набор, как этот

Источник
def zipWithIndex: CC[(A, Int)]

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

Возвращает

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

List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))

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

Source
def addString(b: StringBuilder, start: String, sep: String, end: String): StringBuilder

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

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

end

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

sep

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

start

начальная строка.
Возвращает

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

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, в который были добавлены элементы.

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, в который были добавлены элементы.

Source
def collectFirst[B](pf: PartialFunction[A, B]): Option[B]

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

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

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

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

частичная функция
Возвращает

значение option, содержащее pf, применённое к первому значению, для которого оно определено, или None если такового нет.
Пример

Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)

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

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

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

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

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

тип элементов массива.
Параметры значения
xs

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

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

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

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

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

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

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

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

тип элементов массива.
Параметры значения
start

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

xs

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

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

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

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

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

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

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

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

тип элементов массива.
Параметры значения
len

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

start

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

xs

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

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

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

Source
def corresponds[B](that: IterableOnce[B])(p: (A, B) => Boolean): Boolean

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

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

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

тип элементов that
Параметры значения
p

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

that

другая коллекция
Возвращает

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

Source
def count(p: A => Boolean): Int

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

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

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

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

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

Source
def exists(p: A => Boolean): Boolean

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

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

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

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

true если заданный предикат p выполняется хотя бы для одного элемента этого набора, в противном случае false

Источник
def find(p: A => Boolean): Option[A]

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

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

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

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

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

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

Источник
def fold[A1 >: A](z: A1)(op: (A1, A1) => A1): A1

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

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

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

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

параметр типа для бинарного оператора, являющийся надтипом A.

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

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

z

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

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

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

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

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

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

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

тип результата бинарного оператора.
Параметры значения
op

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

z

начальное значение.
Возвращает

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

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

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

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

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

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

тип результата бинарного оператора.
Параметры значения
op

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

z

начальное значение.
Возвращает

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

Источник
def forall(p: A => Boolean): Boolean

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

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

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

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

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

Исходный код
def foreach[U](f: A => U): Unit

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

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

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

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

Возвращает

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

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

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

Возвращает

true если она многократно проходима, false в противном случае.

Исходный код
def max[B >: A](implicit ord: Ordering[B]): A

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

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

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

Тип, по которому определено упорядочение.
Параметры значения
ord

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

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

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

Исходный код
def maxBy[B](f: A => B)(implicit cmp: Ordering[B]): A

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

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

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

Тип результата функции f.
Параметры значения
cmp

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

f

Функция измерения.
Возвращает

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

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

Исходный код
def maxByOption[B](f: A => B)(implicit cmp: Ordering[B]): Option[A]

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

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

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

Тип результата функции f.
Параметры значения
cmp

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

f

Функция измерения.
Возвращает

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

Исходный код
def maxOption[B >: A](implicit ord: Ordering[B]): Option[A]

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

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

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

Тип, по которому определяется порядок.
Параметры значения
ord

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

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

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

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

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

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

Тип, по которому определяется порядок.
Параметры значения
ord

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

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

Исключения
UnsupportedOperationException

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

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

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

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

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

Тип результата функции f.
Параметры значения
cmp

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

f

Функция измерения.
Возвращает

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

Исключения
UnsupportedOperationException

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

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

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

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

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

Тип результата функции f.
Параметры значения
cmp

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

f

Функция измерения.
Возвращает

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

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

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

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

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

Тип, по которому определяется порядок.
Параметры значения
ord

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

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

Источник
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)"

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

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

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

class="attributes">
Параметры значения
sep

строка-разделитель.
Возвращает

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

Пример

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

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

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

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

class="attributes">
Возвращает

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

Источник@deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")
def nonEmpty: Boolean

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

class="attributes">
Возвращает

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

Источник
def product[B >: A](implicit num: Numeric[B]): B

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

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

class="attributes">
Параметры типа
B

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

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

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

произведение всех элементов этого набора по отношению к оператору * в num.

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

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

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

class="attributes">
Параметры типа
B

параметр типа для бинарного оператора, являющегося надтипом A.
Параметры значения
op

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

результат применения оператора reduce op между всеми элементами, если набор не пустой.
Исключения
UnsupportedOperationException

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

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

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

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

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

Тип параметров
B

тип результата бинарного оператора.
Параметры значения
op

бинарный оператор.
Возвращает

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

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

Исходный код
def reduceLeftOption[B >: A](op: (B, A) => B): Option[B]

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

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

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

Тип параметров
B

тип результата бинарного оператора.
Параметры значения
op

бинарный оператор.
Возвращает

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

Исходный код
def reduceOption[B >: A](op: (B, B) => B): Option[B]

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

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

Тип параметров
B

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

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

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

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

Исходный код
def reduceRight[B >: A](op: (A, B) => B): B

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

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

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

Тип параметров
B

тип результата бинарного оператора.
Параметры значения
op

бинарный оператор.
Возвращает

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

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

Исходный код
def reduceRightOption[B >: A](op: (A, B) => B): Option[B]

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

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

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

Тип параметров
B

тип результата бинарного оператора.
Параметры значения
op

бинарный оператор.
Возвращает

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

Исходный код
protected def reversed: Iterable[A]

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

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

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

Возвращает

количество элементов в этой коллекции.

Исходный код
def splitAt(n: Int): (C, C)

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

Примечание: c splitAt n эквивалентно (но возможно более эффективно) (c take n, c drop n).

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

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

позиция, по которой следует разделить.
Возвращает

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

Исходный код
def sum[B >: A](implicit num: Numeric[B]): B

Вычисляет сумму элементов этой коллекции.

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

Тип параметров
B

тип результата оператора +.
Параметры значения
num

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

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

Исходный код
def to[C1](factory: Factory[A, C1]): C1

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

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

Исходный код
def toArray[B >: A : ClassTag]: Array[B]

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

Примечание: НЕ вызывайте Array.from из этого метода.

Исходный код@inline
final def toBuffer[B >: A]: Buffer[B]

Исходный код
def toIndexedSeq: IndexedSeq[A]

Исходный код
def toList: List[A]

Исходный код
def toMap[K, V](implicit ev: A <:< (K, V)): Map[K, V]

Исходный код
def toSeq: Seq[A]

Возвращает

Эта коллекция в виде Seq[A]. Эквивалентно to(Seq), но может быть быстрее.

Исходный код
def toSet[B >: A]: Set[B]

Исходный код
def toVector: Vector[A]

© 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/IterableOnceOps.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API