Spec-Zone.ru › Scala 3.2

Интерфейс IterableOnceOps.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))

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

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

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

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

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

Источник
def copyToArray[B >: A](xs: Array[B]): Int

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

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

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

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

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

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

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

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

Источник
def copyToArray[B >: A](xs: Array[B], start: Int): Int

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

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

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

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

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

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

xs

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

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

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

Источник
def copyToArray[B >: A](xs: Array[B], start: Int, len: Int): Int

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

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

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

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

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

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

start

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

xs

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

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

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

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

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

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

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

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

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

that

другой набор
Возвращает

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

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

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

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

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

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

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

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

Source
def min[B >: A](implicit ord: Ordering[B]): A

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

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

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

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

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

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

Исключения
UnsupportedOperationException

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

Source
def minBy[B](f: A => B)(implicit cmp: Ordering[B]): A

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

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

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

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

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

f

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

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

Исключения
UnsupportedOperationException

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

Source
def minByOption[B](f: A => B)(implicit cmp: Ordering[B]): Option[A]

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

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

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

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

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

f

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

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

Source
def minOption[B >: A](implicit ord: Ordering[B]): Option[A]

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

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

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

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

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

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

Source
final def mkString(start: String, sep: String, end: String): String

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

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

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

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

sep

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

start

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

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

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

Source
final def mkString(sep: String): String

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

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

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

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

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

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

Source
final def mkString: String

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

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

Возвращает

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

Source
def nonEmpty: Boolean

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

Возвращает

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

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

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

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

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

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

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

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

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

Source
def reduce[B >: A](op: (B, B) => B): B

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

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

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

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

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

Результат применения оператора reduce op между всеми элементами, если набор непустой.
Выбрасывает
UnsupportedOperationException

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

Source
def reduceLeft[B >: A](op: (B, A) => B): B

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

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

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

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

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

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

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

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

Source
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

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

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

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

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

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

Исходный код
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.2.0/scala/collection/IterableOnceOps.html

Spec-Zone.ru

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