Особенность scala.collection.SeqOps
Компаньон объект SeqOps
trait SeqOps[+A, +CC[_], +C] extends IterableOps[A, CC, C]
- AbstractIndexedSeqView, AbstractSeq, AbstractSeqView, IndexedSeq, IndexedSeqOps, IndexedSeqView, Appended, Concat, Drop, DropRight, Id, Map, Prepended, Reverse, Slice, Take, TakeRight, LinearSeq, LinearSeqOps, Seq, SeqView, Appended, Concat, Drop, DropRight, Id, Map, Prepended, Reverse, Sorted, Take, TakeRight, StrictOptimizedLinearSeqOps, StrictOptimizedSeqOps, StringView, ::, AbstractSeq, ArraySeq, ofBoolean, ofByte, ofChar, ofDouble, ofFloat, ofInt, ofLong, ofRef, ofShort, ofUnit, IndexedSeq, IndexedSeqOps, LazyList, LinearSeq, LinearSeqOps, Список, Nil, ДиапазонЧисел, Exclusive, Inclusive, Очередь, Диапазон, Exclusive, Inclusive, Последовательность, SeqOps, Cons, Empty, StrictOptimizedSeqOps, Вектор, ОборачивающаяСтрока, AbstractBuffer, AbstractSeq, БуферМассива, ArrayBufferView, ДвусторонняяОчередь, ArrayDequeOps, ArraySeq, ofBoolean, ofByte, ofChar,
- ofDouble, ofFloat, ofInt, ofLong, ofRef, ofShort, ofUnit, Буфер, Индексированный буфер, Индексированная последовательность, Индексированная последовательность операций, Список буфер, Очередь, Последовательность, Последовательность операций, Стек, Строка буфер, Развёрнутый буфер, Аккумулятор, Любой аккумулятор, Двойной аккумулятор, Целочисленный аккумулятор, Длинный аккумулятор, Поток
Члены-значения абстрактного типа
abstract def apply(i: Int): A
Получить элемент по указанному индексу. Эта операция предоставляется для удобства в Seq. Не следует предполагать, что она будет эффективной, если у вас нет IndexedSeq.
- Annotations
- @throws(scala.this.throws.<init>$default$1[IndexOutOfBoundsException])
abstract def coll: C
- возвращает
Это коллекция в виде
C.
- Атрибуты
- protected
- Определяющие классы
- IterableOps
abstract def fromSpecific(coll: IterableOnce[A]): C
Определяет, как преобразовать заданную Iterable[A] в коллекцию типа C.
Этот процесс может выполняться строго или нестрого (т.е. без оценки элементов результирующих коллекций). Другими словами, этот метод определяет модель оценки коллекции.
- Атрибуты
- protected
- Определяющие классы
- IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В обычном случае, гдеC =:= CC[A], это можно сделать, добавив в смесь трайт IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как свидетельствует аннотация
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, если он вызывается сIterable[A], полученным от коллекцииthis(как это происходит при реализации операций, где мы используемView[A]), он безопасен.
abstract def getClass(): Class[_ <: AnyRef]
Возвращает представление класса объекта во время выполнения.
- возвращает
объект класса, соответствующий типу получателя во время выполнения.
- Определяющие классы
- Any
abstract def iterableFactory: IterableFactory[CC]
Объект-компаньон этой коллекции итерируемых данных, предоставляющий различные методы фабрик.
- Определяющие классы
- IterableOps
- Примечание
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа необходимо переопределить этот метод, чтобы вернуть фабрику для нового типа (в противном случае компилятор выдаст ошибку).
abstract def iterator: Iterator[A]
Итератор может быть использован только один раз
- Определяющие классы
- IterableOnce
abstract def length: Int
Длина (количество элементов) последовательности. size является псевдонимом для length в коллекциях Seq.
abstract def newSpecificBuilder: Builder[A, C]
- возвращает
строгий билдер для того же типа коллекции. Обратите внимание, что в случае ленивых коллекций (например, View или immutable.LazyList) реализация этого метода возможна, но результирующий
Builderнарушит ленивость. Вследствие этого операции предпочтительно реализовывать с помощьюfromSpecificвместо этого метода.
- Атрибуты
- protected
- Определяющие классы
- IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В обычном случае, гдеC =:= CC[A], это можно сделать, добавив в смесь трайт IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как свидетельствует аннотация
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, если возвращаемый билдер заполняется только значениямиA, взятыми из экземпляраthis, он безопасен.
abstract def toIterable: Iterable[A]
- возвращает
Эта коллекция в виде
Iterable[A]. Новый коллекция не будет создана, еслиthisуже являетсяIterable[A].
- Определяющие классы
- IterableOps
Члены-значения конкретного типа
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- returns
trueесли !(this == that), иначе false.
- Definition Classes
- Any
final def ##(): Int
Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для числовых типов возвращает значение хэша, соответствующее равенству значений: если две инстанции типа значения сравниваются как true, то ## вернёт одно и то же значение хэша для каждой из них. Для null возвращает хэш-код, где null.hashCode выбрасывает NullPointerException.
- returns
значение хэша, соответствующее ==
- Definition Classes
- Any
def +(other: String): String
- Implicit
- Этот член добавлен неявным преобразованием из SeqOps[A, CC, C] вany2stringadd[SeqOps[A, CC, C]] с помощью метода any2stringadd в scala.Predef.
- Definition Classes
- any2stringadd
final def ++[B >: A](suffix: IterableOnce[B]): CC[B]
Псевдоним для concat
- Definition Classes
- IterableOps
- Annotations
- @inline()
final def ++:[B >: A](prefix: IterableOnce[B]): CC[B]
Псевдоним для prependedAll
- Definition Classes
- SeqOps → IterableOps
- Annotations
- @inline()
final def +:[B >: A](elem: B): CC[B]
Псевдоним для prepended.
Обратите внимание, что операторы с суффиксом :- являются правоассоциативными (см. пример). Мемоническая подсказка для +: против :+: двоеточие идёт со стороны коллекции.
- Annotations
- @inline()
def ->[B](y: B): (SeqOps[A, CC, C], B)
- Implicit
- Этот член добавлен неявным преобразованием из SeqOps[A, CC, C] вArrowAssoc[SeqOps[A, CC, C]] с помощью метода ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
- Annotations
- @inline()
final def :+[B >: A](elem: B): CC[B]
Псевдоним для appended
Обратите внимание, что операторы с суффиксом :- являются правоассоциативными (см. пример). Мемоническая подсказка для +: против :+: двоеточие идёт со стороны коллекции.
- Annotations
- @inline()
final def :++[B >: A](suffix: IterableOnce[B]): CC[B]
Псевдоним для appendedAll
- Annotations
- @inline()
final def ==(arg0: Any): Boolean
Проверка двух объектов на равенство. Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- returns
trueесли объект-получатель эквивалентен аргументу;falseв противном случае.
- Definition Classes
- Any
final def addString(b: mutable.StringBuilder): mutable.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
строковый буфер, в который добавляются элементы.
- returns
строковый буфер
b, в который были добавлены элементы.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
final def addString(b: mutable.StringBuilder, sep: String): mutable.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
разделитель.
- returns
строковый буфер
b, в который были добавлены элементы.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
def addString(b: mutable.StringBuilder, start: String, sep: String, end: String): mutable.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
строковый буфер, в который добавляются элементы.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
строковый буфер
b, в который были добавлены элементы.
- Definition Classes
- IterableOnceOps
def appended[B >: A](elem: B): CC[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
добавляемый элемент
- returns
новая последовательность, состоящая из всех элементов этой последовательности, за которыми следует
value.
def appendedAll[B >: A](suffix: IterableOnce[B]): CC[B]
Возвращает новую последовательность, содержащую элементы левого операнда, за которыми следуют элементы правого операнда. Тип элемента последовательности — это самый общий суперкласс, охватывающий типы элементов двух операндов.
- B
тип элемента возвращаемой коллекции.
- suffix
присоединяемая коллекция.
- returns
новая коллекция типа
CC[B], которая содержит все элементы этой последовательности, за которыми следуют все элементыsuffix.
final def asInstanceOf[T0]: T0
Приведение типа объекта-получателя к типу T0.
Обратите внимание, что успех приведения типов во время выполнения обусловлен семантикой стирания типов в Scala. Поэтому выражение 1.asInstanceOf[String] выбросит ClassCastException во время выполнения, в то время как выражение List(1).asInstanceOf[List[String]] — нет. В последнем примере, поскольку тип аргумента стирается во время компиляции, невозможно проверить, соответствуют ли содержимое списка требуемому типу.
- returns
объект-получатель.
- Definition Classes
- Any
- Exceptions thrown
ClassCastExceptionесли объект-получатель не является экземпляром стирания типаT0.
def collect[B](pf: PartialFunction[A, B]): CC[B]
Создаёт новую итерируемую коллекцию, применяя частичную функцию ко всем элементам этой итерируемой коллекции, для которых функция определена.
- B
тип элемента возвращаемой итерируемой коллекции.
- pf
частичная функция, которая фильтрует и отображает итерируемую коллекцию.
- returns
новая итерируемая коллекция, полученная в результате применения заданной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращён. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def collectFirst[B](pf: PartialFunction[A, B]): Option[B]
Находит первый элемент коллекции, для которого заданная частичная функция определена, и применяет частичную функцию к нему.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции по основанию не упорядочен.
- pf
частичная функция
- returns
значение опциона, содержащее pf, применённую к первому значению, для которого она определена, или
Noneесли такого значения нет.
- Definition Classes
- IterableOnceOps
Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)
def combinations(n: Int): Iterator[C]
Итерируется по комбинациям. _Комбинация_ длины n — это подпоследовательность исходной последовательности, элементы которой взяты в порядке следования. Таким образом, "xy" и "yy" являются комбинациями длины 2 "xyy", но "yx" нет. Если существует более одного способа сгенерировать ту же подпоследовательность, будет возвращён только один.
Например, "xyyy" имеет три различных способа сгенерировать "xy" в зависимости от того, какой первый, второй или третий "y" был выбран. Однако, так как все они идентичны, будет выбран только один. Какой из трёх будет выбран, является реализационным деталью, которая не определена.
Примечание: Даже когда применяется к представлению или ленивой коллекции, элементы всегда будут принудительно вычисляться.
- returns
Итератор, проходящий по возможным n-элементным комбинациям этой последовательности.
"abbbc".combinations(2) = Iterator(ab, ac, bb, bc)
final def concat[B >: A](suffix: IterableOnce[B]): CC[B]
Возвращает новую последовательность, содержащую элементы левого операнда, за которыми следуют элементы правого операнда. Тип элемента последовательности — это наиболее конкретный суперкласс, охватывающий типы элементов двух операндов.
- B
тип элемента возвращаемой коллекции.
- suffix
проходимая последовательность для добавления.
- returns
новая последовательность, которая содержит все элементы этой последовательности, за которыми следуют все элементы
suffix.
- Definition Classes
- SeqOps → IterableOps
- Annotations
- @inline()
def contains[A1 >: A](elem: A1): Boolean
Проверяет, содержит ли эта последовательность данное значение в качестве элемента.
Примечание: может не завершиться для коллекций бесконечного размера.
- elem
элемент для проверки.
- returns
trueесли у этой последовательности есть элемент, который равен (как определено==)elem,falseв противном случае.
def containsSlice[B](that: Seq[B]): Boolean
Проверяет, содержит ли эта последовательность заданную последовательность в качестве слайса.
Примечание: может не завершиться для коллекций бесконечного размера.
- that
последовательность для проверки
- returns
trueесли эта последовательность содержит слайс с теми же элементами, что иthat, в противном случаеfalse.
def copyToArray[B >: A](xs: Array[B], start: Int, len: Int): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет данный массив xs начиная с индекса start не более чем len элементами этой коллекции.
Копирование прекратится, когда будут скопированы все элементы этой коллекции, или будет достигнут конец массива, или будет скопировано len элементов.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- len
максимальное количество копируемых элементов.
- returns
количество элементов, записанных в массив
- Definition Classes
- IterableOnceOps
- Note
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван. Использование итератора не определено и может измениться. Примечание: не завершится для коллекций бесконечного размера.
def copyToArray[B >: A](xs: Array[B], start: Int): Int
Копирует элементы в массив, возвращая количество записанных элементов.
Заполняет заданный массив xs начиная с индекса start значениями этой коллекции.
Копирование остановится, как только будут скопированы все элементы этой коллекции или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- returns
количество элементов, записанных в массив. Примечание: не завершится для коллекций бесконечного размера.
- Definition Classes
- IterableOnceOps
def copyToArray[B >: A](xs: Array[B]): Int
Копирует элементы в массив, возвращая количество записанных элементов.
Заполняет заданный массив xs начиная с индекса start значениями этой коллекции.
Копирование остановится, как только будут скопированы все элементы этой коллекции или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- returns
количество элементов, записанных в массив. Примечание: не завершится для коллекций бесконечного размера.
- Definition Classes
- IterableOnceOps
def corresponds[B](that: Seq[B])(p: (A, B) => Boolean): Boolean
Проверяет, соответствует ли каждый элемент этой последовательности соответствующему элементу другой последовательности, удовлетворяя тестовому предикату.
- B
тип элементов
that- that
другая последовательность
- p
тестовый предикат, который связывает элементы из обеих последовательностей
- returns
trueесли обе последовательности имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтой последовательности иyизthat, иначеfalse.
def corresponds[B](that: IterableOnce[B])(p: (A, B) => Boolean): Boolean
Проверяет, соответствует ли каждый элемент итератора этой коллекции соответствующему элементу другой коллекции, удовлетворяя тестовому предикату.
- B
тип элементов
that- that
другая коллекция
- p
тестовый предикат, который связывает элементы из обеих коллекций
- returns
trueесли обе коллекции имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтого итератора иyизthat, иначеfalse
- Definition Classes
- IterableOnceOps
def count(p: (A) => Boolean): Int
Подсчитывает количество элементов в коллекции, которые удовлетворяют предикату.
- p
предикат, используемый для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Definition Classes
- IterableOnceOps
def diff[B >: A](that: Seq[B]): C
Вычисляет разность мультимножеств между этой последовательностью и другой последовательностью.
- that
последовательность элементов для удаления
- returns
новая последовательность, которая содержит все элементы этой последовательности, за исключением некоторых вхождений элементов, которые также присутствуют в
that. Если значение элементаxвстречается n раз вthat, то первые n вхожденийxне будут частью результата, но любые последующие вхождения будут.
def distinct: C
Выбирает все элементы этой последовательности, игнорируя дубликаты.
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
def distinctBy[B](f: (A) => B): C
Выбирает все элементы этой последовательности, игнорируя дубликаты, определяемые == после применения преобразующей функции f.
- B
тип элементов после преобразования
f- f
Преобразующая функция, результат которой используется для определения уникальности каждого элемента
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
def drop(n: Int): C
Выбирает все элементы, кроме первых n.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не является упорядоченным.
- n
количество элементов, которые нужно удалить из этой итерируемой коллекции.
- returns
итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, кроме первых
nэлементов, или же пустая итерируемая коллекция, если эта итерируемая коллекция содержит меньше, чемnэлементов. Еслиnотрицательно, не удалять ни одного элемента.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться, и может привести к изменениям в новом итераторе.
def dropRight(n: Int): C
Выбирает все элементы, кроме последних n.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не является упорядоченным.
- n
количество элементов, которые нужно удалить из этой итерируемой коллекции.
- returns
итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, кроме последних
nэлементов, или же пустая итерируемая коллекция, если эта итерируемая коллекция содержит меньше, чемnэлементов. Еслиnотрицательно, не удалять ни одного элемента.
- Definition Classes
- IterableOps
def dropWhile(p: (A) => Boolean): C
Удаляет самую длинную префиксную последовательность элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не является упорядоченным.
- p
Предикат, используемый для проверки элементов.
- returns
самый длинный суффикс этой итерируемой коллекции, первый элемент которого не удовлетворяет предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться, и может привести к изменениям в новом итераторе.
def empty: C
Пустая итерируемая коллекция того же типа, что и эта итерируемая коллекция
- returns
пустая итерируемая коллекция типа
C.
- Definition Classes
- IterableOps
def endsWith[B >: A](that: Iterable[B]): Boolean
Проверяет, заканчивается ли эта последовательность заданной последовательностью.
Примечание: не завершится для коллекций бесконечного размера.
- that
тестируемая последовательность
- returns
trueесли эта последовательность имеетthatв качестве суффикса,falseв противном случае.
def ensuring(cond: (SeqOps[A, CC, C]) => Boolean, msg: => Any): SeqOps[A, CC, C]
- Implicit
- Этот член добавлен неявным преобразованием из SeqOps[A, CC, C] в Ensuring[SeqOps[A, CC, C]] выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (SeqOps[A, CC, C]) => Boolean): SeqOps[A, CC, C]
- Implicit
- Этот член добавлен неявным преобразованием из SeqOps[A, CC, C] в Ensuring[SeqOps[A, CC, C]] выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: => Any): SeqOps[A, CC, C]
- Неявный
- Этот член добавляется неявным преобразованием из SeqOps[A, CC, C] в Ensuring[SeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean): SeqOps[A, CC, C]
- Неявный
- Этот член добавляется неявным преобразованием из SeqOps[A, CC, C] в Ensuring[SeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def equals(arg0: Any): Boolean
Сравнивает объект получателя (this) с объектом аргумента (that) на предмет эквивалентности.
Любая реализация этого метода должна быть отношением эквивалентности:
-
Он рефлексивен: для любого экземпляра
x типа Any, x.equals(x) должен возвращать true.Он симметричен: для любых экземпляров x и y типа Any, x.equals(y) должен возвращать true тогда и только тогда, когда y.equals(x) возвращает true.Он транзитивен: для любых экземпляров x, y, и z типа Any если x.equals(y) возвращает true и y.equals(z) возвращает true, то x.equals(z) должен возвращать true.Если вы переопределяете этот метод, вы должны убедиться, что ваша реализация остается отношением эквивалентности. Кроме того, при переопределении этого метода обычно необходимо переопределить hashCode, чтобы гарантировать, что объекты, которые являются «равными» (o1.equals(o2) возвращает true) имеют одинаковый хэш-код scala.Int. (o1.hashCode.equals(o2.hashCode)).
- возвращает
trueесли объект получателя эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- Any
def exists(p: (A) => Boolean): Boolean
Проверяет, выполняется ли предикат хотя бы для одного элемента этой коллекции.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- возвращает
trueесли заданный предикатpудовлетворяется хотя бы одним элементом этой коллекции, в противном случаеfalse
- Определяющие классы
- IterableOnceOps
def filter(pred: (A) => Boolean): C
Выбирает все элементы этой итерируемой коллекции, которые удовлетворяют предикату.
- возвращает
новый итератор, состоящий из всех элементов этой итерируемой коллекции, которые удовлетворяют заданному предикату
p. Порядок элементов сохраняется.
- Определяющие классы
- IterableOps → IterableOnceOps
def filterNot(pred: (A) => Boolean): C
Выбирает все элементы этой итерируемой коллекции, которые не удовлетворяют предикату.
- pred
предикат, используемый для проверки элементов.
- возвращает
новая итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, которые не удовлетворяют заданному предикату
pred. Их порядок может не сохраняться.
- Определяющие классы
- IterableOps → IterableOnceOps
def find(p: (A) => Boolean): Option[A]
Находит первый элемент коллекции, удовлетворяющий предикату, если таковой имеется.
Примечание: может не завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- p
предикат, используемый для проверки элементов.
- возвращает
необязательное значение, содержащее первый элемент в коллекции, который удовлетворяет
p, илиNoneесли такового не существует.
- Определяющие классы
- IterableOnceOps
def findLast(p: (A) => Boolean): Option[A]
Находит последний элемент последовательности, удовлетворяющий предикату, если таковой имеется.
Примечание: не будет завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- возвращает
необязательное значение, содержащее последний элемент в последовательности, который удовлетворяет
p, илиNoneесли такового не существует.
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
функция, применяемая к каждому элементу.
- returns
новая итерируемая коллекция, полученная путём применения данной функции со значениями в виде коллекции
fк каждому элементу этой итерируемой коллекции и конкатенации результатов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был применён, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
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.- returns
новая итерируемая коллекция, полученная путём конкатенации всех итерируемых коллекций элементов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был применён, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def fold[A1 >: A](z: A1)(op: (A1, A1) => A1): A1
Сворачивает элементы этой коллекции, используя указанный ассоциативный бинарный оператор. Реализация по умолчанию в IterableOnce эквивалентна foldLeft, но может быть переопределена для более эффективного порядка обхода.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
Примечание: не завершится для коллекций бесконечного размера.
- A1
параметр типа для бинарного оператора, надтип
A.- z
нейтральный элемент для операции свёртки; может быть добавлен к результату произвольное количество раз, и не должен изменять результат (например,
Nilдля конкатенации списков, 0 для сложения или 1 для умножения).- op
бинарный оператор, который должен быть ассоциативным.
- returns
результат применения оператора свёртки
opмежду всеми элементами иz, илиz, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def foldLeft[B](z: B)(op: (B, A) => B): B
Применяет бинарный оператор к начальному значению и всем элементам этой коллекции, слева направо.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
результирующий тип бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, слева направо, с начальным значениемzслева:op(...op(z, x_1), x_2, ..., x_n)
где
x1, ..., xn— элементы этой коллекции. Возвращаетz, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def foldRight[B](z: B)(op: (A, B) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции и начальному значению, справа налево.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
результирующий тип бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, справа налево, с начальным значениемzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xn— элементы этой коллекции. Возвращаетz, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def forall(p: (A) => Boolean): Boolean
Проверяет, выполняется ли предикат для всех элементов этой коллекции.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
trueесли эта коллекция пуста или заданный предикатpвыполняется для всех элементов этой коллекции, в противном случаеfalse.
- Определяющие классы
- IterableOnceOps
def foreach[U](f: (A) => U): Unit
Применить f к каждому элементу для его побочных эффектов. Примечание: параметр [U] необходим для помощи выводу типов scalac.
- Определяющие классы
- IterableOnceOps
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной строкой format. Форматные строки такие же, как для String.format (@see java.lang.String.format).
- Неявный
- Этот член добавляется неявным преобразованием из SeqOps[A, CC, C] в StringFormat[SeqOps[A, CC, C]] с помощью метода StringFormat в scala.Predef.
- Определяющие классы
- StringFormat
- Аннотации
- @inline()
def groupBy[K](f: (A) => K): immutable.Map[K, C]
Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с некоторой функцией дискриминатора.
Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно обрабатывать элементы.
- K
тип ключей, возвращаемых функцией дискриминатора.
- f
функция дискриминатора.
- returns
-
Карта из ключей в итерируемые коллекции, для которой выполняется следующее инвариантное условие:
(xs groupBy f)(k) = xs filter (x => f(x) == k)
То есть каждый ключ
kсвязан с итерируемой коллекцией тех элементов,x, для которыхf(x)равноk.
- Определяющие классы
- IterableOps
def groupMap[K, B](key: (A) => K)(f: (A) => B): immutable.Map[K, CC[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)
Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно обрабатывать элементы.
- K
тип ключей, возвращаемых функцией дискриминатора
- B
тип значений, возвращаемых функцией преобразования
- key
функция дискриминатора
- f
функция преобразования элементов
- Определяющие классы
- IterableOps
def groupMapReduce[K, B](key: (A) => K)(f: (A) => B)(reduce: (B, B) => B): immutable.Map[K, B]
Разделяет эту итерируемую коллекцию на карту в соответствии с функцией дискриминатора key. Все значения, имеющие один и тот же дискриминатор, затем преобразуются функцией value и затем сводятся к одному значению с помощью функции 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[C]
Разделяет элементы на итерируемые коллекции фиксированного размера.
- size
количество элементов в группе
- returns
Итератор, создающий итерируемые коллекции размера
size, за исключением последней, которая будет меньше размераsize, если элементы не делятся равномерно.
- Определяющие классы
- IterableOps
- См. также
scala.collection.Iterator, метод
grouped
def hashCode(): Int
Вычислить значение хэш-кода для объекта.
Алгоритм хэширования по умолчанию зависит от платформы.
Обратите внимание, что допустимо, чтобы два объекта имели идентичные хэш-коды (o1.hashCode.equals(o2.hashCode)) и при этом не быть равными (o1.equals(o2) возвращает false). Вырожденная реализация всегда могла бы возвращать 0. Однако, требуется, чтобы если два объекта равны (o1.equals(o2) возвращает true), то они имели идентичные хэш-коды (o1.hashCode.equals(o2.hashCode)). Поэтому, переопределяя этот метод, обязательно убедитесь, что поведение согласуется с методом equals.
- returns
значение хэш-кода для этого объекта.
- Определяющие классы
- Any
def head: A
Выбирает первый элемент этой итерируемой коллекции.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции.
- Определяющие классы
- IterableOps
- Выбрасываемые исключения
NoSuchElementExceptionесли итерируемая коллекция пуста.
def headOption: Option[A]
Необязательно выбирает первый элемент.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции, если она не пуста,
None, если она пуста.
- Определяющие классы
- IterableOps
def indexOf[B >: A](elem: B): Int
Находит индекс первого вхождения некоторого значения в этой последовательности.
- B
тип элемента
elem.- elem
значение элемента, которое нужно найти.
- returns
индекс
>= 0первого элемента этой последовательности, который равен (как определено==)elem, или-1, если такого не существует.
- Аннотации
- @deprecatedOverriding("Override indexOf(elem, from) instead - indexOf(elem) calls indexOf(elem, 0)", "2.13.0")
def indexOf[B >: A](elem: B, from: Int): Int
Находит индекс первого вхождения некоторого значения в этой последовательности после или на каком-то начальном индексе.
- B
тип элемента
elem.- elem
значение элемента, которое нужно найти.
- from
начальный индекс
- returns
индекс
>= fromпервого элемента этой последовательности, который равен (как определено==)elem, или-1, если такого не существует.
def indexOfSlice[B >: A](that: Seq[B]): Int
Находит первый индекс, где эта последовательность содержит заданную последовательность в качестве среза.
Примечание: может не завершиться для коллекций бесконечного размера.
- that
последовательность для проверки
- returns
первый индекс
>= 0такой, что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательностиthat, или-1, если такой подпоследовательности не существует.
- Аннотации
- @deprecatedOverriding("Override indexOfSlice(that, from) instead - indexOfSlice(that) calls indexOfSlice(that, 0)", "2.13.0")
def indexOfSlice[B >: A](that: Seq[B], from: Int): Int
Находит первый индекс после или на начальном индексе, где эта последовательность содержит заданную последовательность в качестве среза.
Примечание: может не завершиться для коллекций бесконечного размера.
- that
последовательность для проверки
- from
начальный индекс
- returns
первый индекс
>= fromтакой, что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательностиthat, или-1, если такой подпоследовательности не существует.
def indexWhere(p: (A) => Boolean): Int
Находит индекс первого элемента, удовлетворяющего некоторому предикату.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
индекс
>= 0первого элемента этой последовательности, который удовлетворяет предикатуp, или-1, если такого не существует.
- Аннотации
- @deprecatedOverriding("Override indexWhere(p, from) instead - indexWhere(p) calls indexWhere(p, 0)", "2.13.0")
def indexWhere(p: (A) => Boolean, from: Int): Int
Находит индекс первого элемента, удовлетворяющего некоторому предикату после или на каком-то начальном индексе.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- from
начальный индекс
- returns
индекс
>= fromпервого элемента этой последовательности, который удовлетворяет предикатуp, или-1, если такого не существует.
def indices: immutable.Range
Создаёт диапазон всех индексов этой последовательности.
Примечание: Даже при применении к представлению или ленивой коллекции, элементы всегда будут принудительно вычислены.
- returns
значение от
Rangeдо значения, на единицу меньшего, чем длина этой последовательности.
def init: C
Начальная часть коллекции без последнего элемента.
Примечание: Даже при применении к представлению или ленивой коллекции, элементы всегда будут принудительно вычислены.
- Definition Classes
- IterableOps
def inits: Iterator[C]
Итерируется по начальным частям этой итерируемой коллекции. Первое значение будет этой итерируемой коллекцией, а последнее — пустой итерируемой коллекцией, а промежуточные значения — результаты последовательных применений init.
Примечание: Даже при применении к представлению или ленивой коллекции, элементы всегда будут принудительно вычислены.
- returns
итератор по всем начальным частям этой итерируемой коллекции
- Definition Classes
- IterableOps
List(1,2,3).inits = Iterator(List(1,2,3), List(1,2), List(1), Nil)
def intersect[B >: A](that: Seq[B]): C
Вычисляет пересечение мультимножеств этой последовательности и другой последовательности.
- that
последовательность элементов для пересечения.
- returns
новая последовательность, содержащая все элементы этой последовательности, которые также присутствуют в
that. Если значение элементаxвстречается n раз вthat, то первые n вхожденийxбудут сохранены в результате, но все последующие вхождения будут опущены.
def isDefinedAt(idx: Int): Boolean
Проверяет, содержит ли эта последовательность заданный индекс.
Реализации методов apply и isDefinedAt преобразуют Seq[A] в PartialFunction[Int, A].
- idx
индекс для проверки
- returns
значение
true, если эта последовательность содержит элемент в позицииidx,falseв противном случае.
def isEmpty: Boolean
Проверяет, пуста ли последовательность.
Примечание: Реализации в подклассах, которые не являются многократно проходимыми, должны позаботиться о том, чтобы не использовать элементы при вызове isEmpty.
- returns
значение
true, если последовательность не содержит элементов,falseв противном случае.
- Definition Classes
- SeqOps → IterableOnceOps
final def isInstanceOf[T0]: Boolean
Проверяет, является ли динамический тип объекта-получателя T0.
Обратите внимание, что результат проверки учитывает семантику стирания Scala. Поэтому выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, поскольку аргумент типа стирается во время компиляции, проверить, являются ли содержимое списка указанного типа, невозможно.
- returns
значение
true, если объект-получатель является экземпляром стирания типаT0,falseв противном случае.
- Definition Classes
- Any
def isTraversableAgain: Boolean
Проверяет, может ли эта итерируемая коллекция быть многократно пройдена. Всегда истинно для Iterables и ложно для Iterators, если не переопределено.
- returns
значение
true, если она многократно проходимая,falseв противном случае.
- Definition Classes
- IterableOps → IterableOnceOps
def knownSize: Int
- returns
Количество элементов в этой коллекции, если оно может быть вычислено с небольшой стоимостью, -1 в противном случае. Небольшая стоимость обычно означает: Не требует обхода коллекции.
- Definition Classes
- IterableOnce
def last: A
Выбирает последний элемент.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- returns
Последний элемент этой итерируемой коллекции.
- Definition Classes
- IterableOps
- Exceptions thrown
NoSuchElementExceptionЕсли итерируемая коллекция пуста.
def lastIndexOf[B >: A](elem: B, end: Int = length - 1): Int
Находит индекс последнего вхождения некоторого значения в этой последовательности до или на заданном конечном индексе.
Примечание: не завершится для коллекций бесконечного размера.
- B
тип элемента
elem.- elem
значение элемента для поиска.
- end
конечный индекс.
- returns
индекс
<= endпоследнего элемента этой последовательности, равного (как определено==)elem, или-1, если такого элемента нет.
def lastIndexOfSlice[B >: A](that: Seq[B]): Int
Находит последний индекс, где эта последовательность содержит заданную последовательность в качестве среза.
Примечание: не завершится для последовательностей бесконечного размера.
- that
последовательность для проверки
- returns
последний индекс такой, что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательности
that, или-1, если такой подпоследовательности не существует.
- Annotations
- @deprecatedOverriding("Override lastIndexOfSlice(that, end) instead - lastIndexOfSlice(that) calls lastIndexOfSlice(that, Int.MaxValue)", "2.13.0")
def lastIndexOfSlice[B >: A](that: Seq[B], end: Int): Int
Находит последний индекс до или на заданном конечном индексе, где эта последовательность содержит заданную последовательность в качестве среза.
Примечание: не завершится для последовательностей бесконечного размера.
- that
последовательность для проверки
- end
конечный индекс
- returns
последний индекс
<= endтакой, что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательностиthat, или-1, если такой подпоследовательности не существует.
def lastIndexWhere(p: (A) => Boolean): Int
Находит индекс последнего элемента, удовлетворяющего некоторому предикату.
Примечание: не завершится для последовательностей бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
индекс последнего элемента этой последовательности, который удовлетворяет предикату
p, или-1, если такого не существует.
- Annotations
- @deprecatedOverriding("Override lastIndexWhere(p, end) instead - lastIndexWhere(p) calls lastIndexWhere(p, Int.MaxValue)", "2.13.0")
def lastIndexWhere(p: (A) => Boolean, end: Int): Int
Находит индекс последнего элемента, удовлетворяющего некоторому предикату до или на заданном конечном индексе.
Примечание: не завершится для последовательностей бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
индекс
<= endпоследнего элемента этой последовательности, который удовлетворяет предикатуp, или-1, если такого не существует.
def lastOption: Option[A]
Необязательно выбирает последний элемент.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
последний элемент этой итерируемой коллекции, если она не пуста,
None, если она пуста.
- Definition Classes
- IterableOps
def lengthCompare(that: Iterable[_]): Int
Сравнивает длину этой последовательности с размером другой Iterable.
- that
Iterable, размер которого сравнивается с длиной этой последовательности.- returns
-
Значение
x, гдеx < 0 if this.length < that.size x == 0 if this.length == that.size x > 0 if this.length > that.size
Реализация этого метода не вызывает
lengthилиsizeнапрямую; его время выполнения составляетO(this.length min that.size)вместоO(this.length + that.size). Метод должен быть переопределен, если вычислениеsizeдешево, иknownSizeвозвращает-1.
def lengthCompare(len: Int): Int
Сравнивает длину этой последовательности с тестовым значением.
- len
тестовое значение, которое сравнивается с длиной.
- returns
-
Значение
x, гдеx < 0 if this.length < len x == 0 if this.length == len x > 0 if this.length > len
Реализация этого метода не вызывает
lengthнапрямую; его время выполнения составляетO(length min len)вместоO(length). Метод должен быть переопределен, если вычислениеlengthдешево, иknownSizeвозвращает-1.
- See also
final def lengthIs: SizeCompareOps
Возвращает value class, содержащий операции для сравнения длины этой последовательности с тестовым значением.
Эти операции реализованы с помощью 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
- Annotations
- @inline()
def map[B](f: (A) => B): CC[B]
Создает новую итерируемую коллекцию, применяя функцию ко всем элементам этой итерируемой коллекции.
- B
тип элемента возвращаемой итерируемой коллекции.
- f
функция, которая применяется к каждому элементу.
- returns
новая итерируемая коллекция, полученная в результате применения заданной функции
fк каждому элементу этой итерируемой коллекции и сбора результатов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, к которому он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def max[B >: A](implicit ord: math.Ordering[B]): A
Находит наибольший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
наибольший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def maxBy[B](f: (A) => B)(implicit cmp: math.Ordering[B]): A
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
первый элемент этой коллекции с наибольшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def maxByOption[B](f: (A) => B)(implicit cmp: math.Ordering[B]): Option[A]
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
необязательное значение, содержащее первый элемент этой коллекции с наибольшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
def maxOption[B >: A](implicit ord: math.Ordering[B]): Option[A]
Находит наибольший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
необязательное значение, содержащее наибольший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
def min[B >: A](implicit ord: math.Ordering[B]): A
Находит наименьший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
наименьший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def minBy[B](f: (A) => B)(implicit cmp: math.Ordering[B]): A
Находит первый элемент, который дает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
первый элемент этой коллекции с наименьшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def minByOption[B](f: (A) => B)(implicit cmp: math.Ordering[B]): Option[A]
Находит первый элемент, который даёт наименьшее значение, измеряемое функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
вариантное значение, содержащее первый элемент этого набора с наименьшим значением, измеренным функцией f в соответствии с порядком
cmp.
- Definition Classes
- IterableOnceOps
def minOption[B >: A](implicit ord: math.Ordering[B]): Option[A]
Находит наименьший элемент.
- B
Тип, над которым определён порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
вариантное значение, содержащее наименьший элемент этого набора относительно порядка
ord.
- Definition Classes
- IterableOnceOps
final def mkString: String
Отображает все элементы этого набора в строке.
Делегирует addString, который может быть переопределён.
- returns
строковое представление этого набора. В результирующей строке строковые представления (с учётом метода
toString) всех элементов этого набора следуют друг за другом без разделителя.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
final def mkString(sep: String): String
Отображает все элементы этого набора в строке с использованием разделителя.
Делегирует addString, который может быть переопределён.
- sep
строка-разделитель.
- returns
строковое представление этого набора. В результирующей строке строковые представления (с учётом метода
toString) всех элементов этого набора разделяются строкойsep.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
List(1, 2, 3).mkString("|") = "1|2|3"
final def mkString(start: String, sep: String, end: String): String
Отображает все элементы этого набора в строке с использованием начальной, конечной и разделительной строк.
Делегирует addString, который может быть переопределён.
- start
начальная строка.
- sep
строка-разделитель.
- end
конечная строка.
- returns
строковое представление этого набора. Результирующая строка начинается со строки
startи заканчивается строкойend. Внутри строковые представления (с учётом методаtoString) всех элементов этого набора разделяются строкойsep.
- Definition Classes
- IterableOnceOps
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
def nonEmpty: Boolean
Проверяет, не пуст ли набор.
- returns
trueесли набор содержит хотя бы один элемент,falseв противном случае.
- Definition Classes
- IterableOnceOps
- Annotations
- @deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")
def occCounts[B](sq: Seq[B]): mutable.Map[B, Int]
- Attributes
- protected[scala.collection]
def padTo[B >: A](len: Int, elem: B): CC[B]
Копия этой последовательности с добавленными элементами до достижения заданной длины.
- B
Тип элементов возвращаемой последовательности.
- len
целевая длина
- elem
значение для заполнения
- returns
новая последовательность, состоящая из всех элементов этой последовательности, за которыми следует минимальное количество вхождений
elem, так что полученный набор имеет длину как минимумlen.
def partition(p: (A) => Boolean): (C, C)
Пара из, во-первых, всех элементов, удовлетворяющих предикату p и, во-вторых, всех элементов, которые этого не делают. Интересно, потому что оно разделяет коллекцию на две части.
Предоставленная здесь реализация по умолчанию должна дважды проходить по коллекции. Строгие коллекции имеют переопределенную версию partition в StrictOptimizedIterableOps, которая требует только одного прохода.
- Определяющие классы
- IterableOps
def partitionMap[A1, A2](f: (A) => Either[A1, A2]): (CC[A1], CC[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
def patch[B >: A](from: Int, other: IterableOnce[B], replaced: Int): CC[B]
Создает новую последовательность, в которой фрагмент элементов в этой последовательности заменен другой последовательностью.
Замена по отрицательным индексам аналогична замене, начинающейся с 0. Замена по индексам, равным или большим длины исходной последовательности, добавляет замену в конец. Если заменяется больше значений, чем существует на самом деле, избыток игнорируется.
- B
тип элементов возвращаемой последовательности.
- from
индекс первого заменяемого элемента
- other
замещающая последовательность
- replaced
число элементов для удаления в исходной последовательности
- возвращает
новую последовательность, состоящую из всех элементов этой последовательности, за исключением того, что
replacedэлементов, начиная сfrom, заменены всеми элементамиother.
def permutations: Iterator[C]
Итерирует по различным перестановкам.
Примечание: Даже при применении к представлению или ленивой коллекции оно всегда будет принудительно использовать элементы.
- возвращает
Итератор, который проходит по различным перестановкам этой последовательности.
"abb".permutations = Iterator(abb, bab, bba)
def prepended[B >: A](elem: B): CC[B]
Копия последовательности с добавленным в начало элементом.
Кроме того, исходная последовательность не изменяется, поэтому вам потребуется сохранить результат.
Пример:
scala> val x = List(1) x: List[Int] = List(1) scala> val y = 2 +: x y: List[Int] = List(2, 1) scala> println(x) List(1)
- B
тип элементов возвращаемой последовательности.
- elem
добавляемый в начало элемент
- возвращает
новую последовательность, состоящую из
valueс последующими всеми элементами этой последовательности.
def prependedAll[B >: A](prefix: IterableOnce[B]): CC[B]
Как и :++, возвращает новую коллекцию, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда.
Она отличается от :++ тем, что правый операнд определяет тип результирующей коллекции, а не левый. Мнемоника: двоеточие находится со стороны нового типа коллекции.
- B
тип элементов возвращаемой коллекции.
- prefix
итерируемый объект для добавления в начало.
- возвращает
новую последовательность, которая содержит все элементы
prefixс последующими всеми элементами этой последовательности.
def product[B >: A](implicit num: math.Numeric[B]): B
Перемножает элементы этой коллекции.
- B
результирующий тип оператора
*.- num
неявный параметр, определяющий набор числовых операций, который включает оператор
*, используемый для формирования произведения.- возвращает
произведение всех элементов этой коллекции относительно оператора
*вnum.
- Определяющие классы
- IterableOnceOps
def reduce[B >: A](op: (B, B) => B): B
Сокращает элементы этой коллекции, используя указанный ассоциативный бинарный оператор.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
- B
Параметр типа для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора сокращения
opко всем элементам, если коллекция не пуста.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceLeft[B >: A](op: (B, A) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции, слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, слева направо:op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)где
x1, ..., xn— элементы этой коллекции.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceLeftOption[B >: A](op: (B, A) => B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этой коллекции, слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
необязательное значение, содержащее результат
reduceLeft(op), если эта коллекция не пуста,Noneв противном случае.
- Определяющие классы
- IterableOnceOps
def reduceOption[B >: A](op: (B, B) => B): Option[B]
Сокращает элементы этой коллекции, если таковые имеются, используя указанный ассоциативный бинарный оператор.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
- B
Параметр типа для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Необязательное значение, содержащее результат применения оператора сокращения
opко всем элементам, если коллекция не пуста, иNoneв противном случае.
- Определяющие классы
- IterableOnceOps
def reduceRight[B >: A](op: (A, B) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, справа налево:op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))где
x1, ..., xn— элементы этой коллекции.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceRightOption[B >: A](op: (A, B) => B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этой коллекции, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
необязательное значение, содержащее результат
reduceRight(op), если эта коллекция не пуста,Noneв противном случае.
- Определяющие классы
- IterableOnceOps
def reverse: C
Возвращает новую последовательность с элементами в обратном порядке.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: даже при применении к представлению или ленивой коллекции он всегда будет принудительно обрабатывать элементы.
- returns
Новая последовательность со всеми элементами этой последовательности в обратном порядке.
def reverseIterator: Iterator[A]
Итератор, возвращающий элементы в обратном порядке.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: xs.reverseIterator эквивалентно xs.reverse.iterator, но может быть более эффективным.
- returns
итератор, возвращающий элементы данной последовательности в обратном порядке
def reversed: Iterable[A]
- Attributes
- protected
- Definition Classes
- IterableOnceOps
def sameElements[B >: A](that: IterableOnce[B]): Boolean
def scan[B >: A](z: B)(op: (B, B) => B): CC[B]
Вычисляет префиксное сканирование элементов коллекции.
Примечание: нейтральный элемент z может применяться более одного раза.
- B
тип элементов результирующей коллекции
- z
нейтральный элемент для оператора
op- op
ассоциативный оператор для сканирования
- returns
новая итерируемая коллекция, содержащая префиксное сканирование элементов в этой итерируемой коллекции
- Definition Classes
- IterableOps
def scanLeft[B](z: B)(op: (B, A) => B): CC[B]
Создаёт итерируемую коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def scanRight[B](z: B)(op: (A, B) => B): CC[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Первый элемент коллекции - последний кумулятивный результат.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции не упорядочен.
Примечание: Даже при применении к представлению или ленивой коллекции, элементы всегда будут принудительно вычислены.
Пример:
List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Definition Classes
- IterableOps
def search[B >: A](elem: B, from: Int, to: Int)(implicit ord: Ordering[B]): SearchResult
Поиск в интервале этой отсортированной последовательности заданного элемента. Если эта последовательность является IndexedSeq, используется бинарный поиск. В противном случае используется линейный поиск.
Последовательность должна быть отсортирована по тому же Ordering перед вызовом; в противном случае результаты не определены.
- elem
элемент, который нужно найти.
- from
индекс, с которого начинается поиск.
- to
индекс, следующий за которым заканчивается поиск.
- ord
упорядочение, используемое для сравнения элементов.
- returns
значение
Found, содержащее индекс, соответствующий элементу в последовательности, илиInsertionPoint, где был бы вставлен элемент, если элемент отсутствует в последовательности.
- Note
если
to <= from, пространство поиска пусто, и возвращаетсяInsertionPointвfrom- See also
-
scala.collection.SeqOps, метод
sorted
def search[B >: A](elem: B)(implicit ord: Ordering[B]): SearchResult
Поиск в этом отсортированном последовательности определенного элемента. Если последовательность является IndexedSeq, используется двоичный поиск. В противном случае используется линейный поиск.
Последовательность должна быть отсортирована с тем же Ordering перед вызовом; в противном случае результаты не определены.
- elem
элемент, который нужно найти.
- ord
порядок, который используется для сравнения элементов.
- returns
значение
Found, содержащее индекс, соответствующий элементу в последовательности, илиInsertionPoint, где элемент был бы вставлен, если элемент не находится в последовательности.
- См. также
-
scala.collection.SeqOps, метод
sorted
def segmentLength(p: (A) => Boolean, from: Int): Int
Вычисляет длину самой длинной последовательности, элементы которой удовлетворяют некоторому предикату.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- from
индекс, с которого начинается поиск.
- returns
длина самой длинной последовательности этой последовательности, начиная с индекса
from, в которой каждый элемент последовательности удовлетворяет предикатуp.
final def segmentLength(p: (A) => Boolean): Int
Вычисляет длину самой длинной последовательности, элементы которой удовлетворяют некоторому предикату.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
длина самой длинной последовательности этой последовательности, в которой каждый элемент последовательности удовлетворяет предикату
p.
final def size: Int
Размер этой последовательности.
Примечание: не завершится для коллекций бесконечного размера.
- returns
количество элементов в этой последовательности.
- Definition Classes
- SeqOps → IterableOnceOps
final def sizeCompare(that: Iterable[_]): Int
Сравнивает размер этой последовательности с размером другой Iterable.
- that
Iterable, размер которой сравнивается с размером этой последовательности.- returns
-
Значение
x, гдеx < 0 if this.size < that.size x == 0 if this.size == that.size x > 0 if this.size > that.size
Метод, как он реализован здесь, не вызывает
sizeнапрямую; его время выполнения составляетO(this.size min that.size)вместоO(this.size + that.size). Метод следует переопределить, если вычислениеsizeявляется быстрым, иknownSizeвозвращает-1.
- Definition Classes
- SeqOps → IterableOps
final def sizeCompare(otherSize: Int): Int
Сравнивает размер этой последовательности со значением теста.
- otherSize
значение теста, которое сравнивается с размером.
- returns
-
Значение
x, гдеx < 0 if this.size < otherSize x == 0 if this.size == otherSize x > 0 if this.size > otherSize
Метод, как он реализован здесь, не вызывает
sizeнапрямую; его время выполнения составляетO(size min otherSize)вместоO(size). Метод следует переопределить, если вычислениеsizeявляется быстрым, иknownSizeвозвращает-1.
- Definition Classes
- SeqOps → IterableOps
- См. также
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
- Definition Classes
- IterableOps
- Аннотации
- @inline()
def slice(from: Int, until: Int): C
Выбирает интервал элементов. Возвращаемая итерируемая коллекция состоит из всех элементов x, которые удовлетворяют инварианту:
from <= indexOf(x) < until
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- from
наименьший индекс для включения из этой итерируемой коллекции.
- until
наименьший индекс для ИСКЛЮЧЕНИЯ из этой итерируемой коллекции.
- returns
итерируемая коллекция, содержащая элементы, большие или равные индексу
from, до (но не включая) индексаuntilэтой итерируемой коллекции.
- Definition Classes
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.
def sliding(size: Int, step: Int): Iterator[C]
Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» над ними (в отличие от их разбиения, как в grouped).
- size
количество элементов в группе
- step
расстояние между первыми элементами последовательных групп
- returns
Итератор, генерирующий итерируемые коллекции размером
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечён, если осталось меньшеsizeэлементов для группировки.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
def sliding(size: Int): Iterator[C]
Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» над ними (в отличие от их разбиения, как в grouped). Шаг «скользящего окна» установлен в единицу.
- size
количество элементов в группе
- returns
Итератор, генерирующий итерируемые коллекции размером
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечён, если осталось меньшеsizeэлементов для группировки.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
def sortBy[B](f: (A) => B)(implicit ord: Ordering[B]): C
Сортирует эту последовательность в соответствии с упорядочением, которое получается из преобразования неявно заданного упорядочения с помощью функции преобразования.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно вызывать элементы.
Сортировка устойчивая. То есть элементы, которые равны (как определяется ord.compare ) сохранят тот же порядок в отсортированной последовательности, что и в исходной.
- B
целевой тип преобразования
f, и тип, где определено упорядочениеord.- f
функция преобразования, отображающая элементы в другую область
B.- ord
упорядочение, предполагаемое в области
B.- returns
последовательность, состоящую из элементов этой последовательности, отсортированных в соответствии с порядком, где
x < yеслиord.lt(f(x), f(y)).
- See also
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)
def sortWith(lt: (A, A) => Boolean): C
Сортирует эту последовательность в соответствии с функцией сравнения.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно вызывать элементы.
Сортировка устойчивая. То есть элементы, которые равны (как определяется lt ), сохранят тот же порядок в отсортированной последовательности, что и в исходной.
- lt
функция сравнения, которая проверяет, предшествует ли ее первый аргумент второму аргументу в желаемом порядке.
- returns
последовательность, состоящую из элементов этой последовательности, отсортированных в соответствии с функцией сравнения
lt.
List("Steve", "Tom", "John", "Bob").sortWith(_.compareTo(_) < 0) =
List("Bob", "John", "Steve", "Tom")
def sorted[B >: A](implicit ord: Ordering[B]): C
Сортирует эту последовательность в соответствии с упорядочением.
Сортировка устойчивая. То есть элементы, которые равны (как определяется ord.compare ), сохранят тот же порядок в отсортированной последовательности, что и в исходной.
- ord
упорядочение, которое будет использоваться для сравнения элементов.
- returns
последовательность, состоящую из элементов этой последовательности, отсортированных в соответствии с порядком
ord.
- See also
scala.math.Ordering Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно вызывать элементы.
def span(p: (A) => Boolean): (C, C)
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в соответствии с предикатом.
Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- p
предикат проверки
- returns
пара, состоящая из самого длинного префикса этой итерируемой коллекции, элементы которой удовлетворяют
p, и остальная часть этой итерируемой коллекции.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах тоже.
def splitAt(n: Int): (C, C)
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в заданной позиции.
Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- n
позиция, в которой требуется разделить.
- returns
пара итерируемых коллекций, состоящая из первых
nэлементов этой итерируемой коллекции и других элементов.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах тоже.
def startsWith[B >: A](that: IterableOnce[B], offset: Int = 0): Boolean
Проверяет, содержит ли эта последовательность заданную последовательность в заданном индексе.
Примечание: Если и получающий объект this и аргумент that являются бесконечными последовательностями, этот метод может не завершиться.
- that
последовательность для проверки
- offset
индекс, в котором ищется последовательность.
- возвращает
trueесли последовательностьthatсодержится в этой последовательности по индексуoffset, в противном случаеfalse.
def stepper[S <: Stepper[_]](implicit shape: StepperShape[A, S]): S
Возвращает Stepper для элементов этой коллекции.
Stepper позволяет создавать Java-поток для работы с коллекцией, см. scala.jdk.StreamConverters. Для коллекций, содержащих примитивные значения, Stepper может использоваться как итератор, который не упаковывает элементы.
Неявный параметр StepperShape определяет тип возвращаемого Stepper в соответствии с типом элемента этой коллекции.
-
Для коллекций
Int, Short, Byte или Char, возвращается IntStepper.Для коллекций Double или Float, возвращается DoubleStepper.Для коллекций Long возвращается LongStepper.Для любого другого типа элемента возвращается AnyStepper.
Обратите внимание, что этот метод переопределен в подклассах, а тип возвращаемого значения уточняется до S with EfficientSplit, например, IndexedSeqOps.stepper. Для Stepper, помеченных scala.collection.Stepper.EfficientSplit, преобразователи в scala.jdk.StreamConverters позволяют создавать параллельные потоки, в то время как обычные Stepper могут быть преобразованы только в последовательные потоки.
- Definition Classes
- IterableOnce
def sum[B >: A](implicit num: math.Numeric[B]): B
Суммирует элементы этой коллекции.
- B
тип результата оператора
+.- num
неявный параметр, определяющий набор арифметических операций, включающих оператор
+, который используется для образования суммы.- возвращает
сумма всех элементов этой коллекции по отношению к оператору
+вnum.
- Definition Classes
- IterableOnceOps
def tail: C
Остальная часть коллекции без ее первого элемента.
- Definition Classes
- IterableOps
def tails: Iterator[C]
Итерирует по хвостам этой итерируемой коллекции. Первое значение будет этой итерируемой коллекцией, а последнее — пустой итерируемой коллекцией, а промежуточные значения — результатами последовательных применений tail.
- возвращает
итератор по всем хвостам этой итерируемой коллекции
- Definition Classes
- IterableOps
List(1,2,3).tails = Iterator(List(1,2,3), List(2,3), List(3), Nil)
def take(n: Int): C
Выбирает первые n элементов.
Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не упорядочен.
- n
количество элементов для извлечения из этой итерируемой коллекции.
- возвращает
итерируемую коллекцию, содержащую только первые
nэлементов этой итерируемой коллекции, или же всю итерируемую коллекцию, если она содержит меньше чемnэлементов. Еслиnотрицательно, возвращает пустую итерируемую коллекцию.
- Definition Classes
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора является неопределенным, может измениться и может привести к изменениям в новом итераторе тоже.
def takeRight(n: Int): C
Выбирает последние n элементов.
Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не упорядочен.
- n
количество элементов для извлечения из этой итерируемой коллекции.
- возвращает
итерируемую коллекцию, содержащую только последние
nэлементов этой итерируемой коллекции, или же всю итерируемую коллекцию, если она содержит меньше чемnэлементов. Еслиnотрицательно, возвращает пустую итерируемую коллекцию.
- Definition Classes
- IterableOps
def takeWhile(p: (A) => Boolean): C
Берёт самый длинный префикс элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не является упорядоченным.
- p
Предикат, используемый для проверки элементов.
- returns
самый длинный префикс этой итерируемой коллекции, элементы которого удовлетворяют предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
def tapEach[U](f: (A) => U): C
Применяет функцию со побочным эффектом к каждому элементу в этой коллекции. Строгие коллекции будут применять f к своим элементам немедленно, в то время как ленивые коллекции, такие как представления и LazyLists, будут применять f к каждому элементу только при и если этот элемент будет вычислен, и каждый раз, когда этот элемент вычисляется.
- U
тип возвращаемого значения f
- f
функция, которая применяется к каждому элементу в этой итерируемой коллекции
- returns
Такая же логическая коллекция, как эта
- Definition Classes
- IterableOps → IterableOnceOps
def to[C1](factory: Factory[A, C1]): C1
При заданном фабрике коллекции factory, преобразуйте эту коллекцию в соответствующее представление для текущего типа элементов A. Примеры использования:
xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]
- Definition Classes
- IterableOnceOps
def toArray[B >: A](implicit arg0: ClassTag[B]): Array[B]
Преобразовать коллекцию в массив.
- Definition Classes
- IterableOnceOps
final def toBuffer[B >: A]: Buffer[B]
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
def toIndexedSeq: immutable.IndexedSeq[A]
- Definition Classes
- IterableOnceOps
def toList: immutable.List[A]
- Definition Classes
- IterableOnceOps
def toMap[K, V](implicit ev: <:<[A, (K, V)]): immutable.Map[K, V]
- Definition Classes
- IterableOnceOps
def toSeq: immutable.Seq[A]
- returns
Эта коллекция как
Seq[A]. Это эквивалентноto(Seq), но может быть быстрее.
- Definition Classes
- IterableOnceOps
def toSet[B >: A]: immutable.Set[B]
- Definition Classes
- IterableOnceOps
def toString(): String
Возвращает строковое представление объекта.
По умолчанию представление зависит от платформы.
- returns
строковое представление объекта.
- Definition Classes
- Any
def toVector: immutable.Vector[A]
- Definition Classes
- IterableOnceOps
def transpose[B](implicit asIterable: (A) => Iterable[B]): CC[CC[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.- returns
двумерная итерируемая коллекция итерируемых коллекций, у которой n-я строка — это n-й столбец этой итерируемой коллекции.
- Definition Classes
- IterableOps
- Исключения
IllegalArgumentException, если все коллекции в этой итерируемой коллекции не имеют одинаковый размер.
def unzip[A1, A2](implicit asPair: (A) => (A1, A2)): (CC[A1], CC[A2])
Преобразует эту итерируемую коллекцию пар в две коллекции первой и второй половины каждой пары.
val xs = Iterable(
(1, "one"),
(2, "two"),
(3, "three")).unzip
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three))
- A1
тип первой половины пар элементов
- A2
тип второй половины пар элементов
- asPair
явное преобразование, которое утверждает, что тип элементов этой итерируемой коллекции является парой.
- returns
пара итерируемых коллекций, содержащая первую, соответственно вторую половину каждой пары элементов этой итерируемой коллекции.
- Definition Classes
- IterableOps
def unzip3[A1, A2, A3](implicit asTriple: (A) => (A1, A2, A3)): (CC[A1], CC[A2], CC[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
явное преобразование, которое утверждает, что тип элементов этой итерируемой коллекции является тройкой.
- returns
тройка итерируемых коллекций, содержащая первый, второй, соответственно третий член каждой тройки элементов этой итерируемой коллекции.
- Definition Classes
- IterableOps
def updated[B >: A](index: Int, elem: B): CC[B]
Копия этого набора с одним заменённым элементом.
- B
тип элементов возвращаемого набора.
- index
положение замены
- elem
заменяющий элемент
- returns
новый набор, являющийся копией этого набора с элементом в позиции
indexзаменённым наelem.
- Исключения
IndexOutOfBoundsException, еслиindexне удовлетворяет0 <= index < length. В случае ленивой коллекции это исключение может быть выброшено в более позднее время или вообще не выброшено (если конец коллекции никогда не вычисляется).
def view: SeqView[A]
Представление элементов этой коллекции.
- Definition Classes
- SeqOps → IterableOps
def withFilter(p: (A) => Boolean): WithFilter[A, CC]
Создаёт нестрогий фильтр этой итерируемой коллекции.
Примечание: разница между c filter p и c withFilter p состоит в том, что первый создаёт новую коллекцию, а второй только ограничивает область действия последующих map, flatMap, foreach, и withFilter операций.
Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
объект класса
WithFilter, который поддерживаетmap,flatMap,foreach, иwithFilterопераций. Все эти операции применяются к тем элементам этой итерируемой коллекции, которые удовлетворяют предикатуp.
- Definition Classes
- IterableOps
def zip[B](that: IterableOnce[B]): CC[(A, B)]
Возвращает итерируемую коллекцию, образованную из этой итерируемой коллекции и другой итерируемой коллекции путём объединения соответствующих элементов парами. Если одна из двух коллекций длиннее другой, её оставшиеся элементы игнорируются.
- B
тип второй половины возвращённых пар
- that
Итерируемая коллекция, предоставляющая вторую половину каждой пары результата
- returns
новая итерируемая коллекция, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции и
that. Длина возвращаемой коллекции — это минимальное значение длин этой итерируемой коллекции иthat.
- Definition Classes
- IterableOps
def zipAll[A1 >: A, B](that: Iterable[B], thisElem: A1, thatElem: B): CC[(A1, B)]
Возвращает коллекцию, сформированную из этой и другой итерируемых коллекций, объединяя соответствующие элементы в пары. Если одна из коллекций короче другой, используются заполнители для расширения более короткой коллекции до длины более длинной.
- that
итерируемая коллекция, предоставляющая вторую половину каждой пары результатов
- thisElem
элемент, используемый для заполнения результата, если эта итерируемая коллекция короче
that.- thatElem
элемент, используемый для заполнения результата, если
thatкороче этой итерируемой коллекции.- returns
новая коллекция типа
That, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции иthat. Длина возвращаемой коллекции равна максимальному из длин этой итерируемой коллекции иthat. Если эта итерируемая коллекция корочеthat, значенияthisElemиспользуются для заполнения результата. Еслиthatкороче этой итерируемой коллекции, значенияthatElemиспользуются для заполнения результата.
- Definition Classes
- IterableOps
def zipWithIndex: CC[(A, Int)]
Объединяет эту итерируемую коллекцию с её индексами.
- returns
Новая итерируемая коллекция, содержащая пары, состоящие из всех элементов этой итерируемой коллекции, спаренных с их индексом. Индексы начинаются с
0.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: После вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))
© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.13.0/scala/collection/SeqOps.html
Базовый трайт для операций над Seq
тип элемента коллекции
конструктор типа коллекции (например,
List,Set). Операции, возвращающие коллекцию с другим типом элементаB(например,map) возвращаютCC[B].тип коллекции (например,
List[Int],String,BitSet). Операции, возвращающие коллекцию с тем же типом элемента (например,drop,filter) возвращаютC.