Трейт scala.collection.mutable.IndexedSeqOps
trait IndexedSeqOps[A, +CC[_], +C <: AnyRef] extends collection.IndexedSeqOps[A, CC, C] with SeqOps[A, CC, C]
- Source
- IndexedSeq.scala
- Линейные супертипы
- SeqOps[A, CC, C], Cloneable[C], java.lang.Cloneable, collection.IndexedSeqOps[A, CC, C], collection.SeqOps[A, CC, C], IterableOps[A, CC, C], IterableOnceOps[A, CC, C], IterableOnce[A], AnyRef, Any
- Известные подклассы
- ArrayBuffer, ArrayDeque, ArraySeq, ofBoolean, ofByte, ofChar, ofDouble, ofFloat, ofInt, ofLong, ofRef, ofShort, ofUnit, IndexedBuffer, IndexedSeq, Queue, Stack, StringBuilder
Члены со значениями абстракции
abstract def apply(i: Int): A
Получение элемента по указанному индексу. Эта операция предоставляется для удобства в Seq. Не следует полагать, что она будет эффективной, если у вас нет IndexedSeq.
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 iterableFactory: IterableFactory[CC]
Объект-компаньон этой итерируемой коллекции, предоставляющий различные методы фабрики.
- Определяющие классы
- IterableOps
- Примечание
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (в противном случае компилятор выдаст ошибку).
abstract def length: Int
Длина (количество элементов) последовательности. size является псевдонимом для length в коллекциях Seq.
- Определяющие классы
- SeqOps
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: collection.Iterable[A]
- возвращает
Эта коллекция как
Iterable[A]. Новая коллекция не будет создана, еслиthisуже являетсяIterable[A].
- Определяющие классы
- IterableOps
abstract def update(idx: Int, elem: A): Unit
Заменяет элемент по заданному индексу новым значением.
- idx
индекс элемента для замены.
- elem
новое значение.
- Определяющие классы
- SeqOps
- Аннотации
- @throws(scala.this.throws.<init>$default$1[IndexOutOfBoundsException])
- Исключения
IndexOutOfBoundsException, если индекс недействителен.
Члены-значения конкретного типа
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- возвращает
trueесли !(this == that), в противном случае false.
- Определяющие классы
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для числовых типов он возвращает хеш-значение, соответствующее равенству значений: если два экземпляра типа значения сравниваются как true, то ## будет генерировать одинаковое хеш-значение для каждого из них. Для null возвращает хеш-код, где null.hashCode вызывает NullPointerException.
- возвращает
хеш-значение, согласованное с ==
- Определяющие классы
- AnyRef → Any
def +(other: String): String
- Неявный
- Этот член добавлен неявным преобразованием из IndexedSeqOps[A, CC, C] к any2stringadd[IndexedSeqOps[A, CC, C]] выполняемого методом any2stringadd в scala.Predef.
- Определяющие классы
- any2stringadd
final def ++[B >: A](suffix: IterableOnce[B]): CC[B]
Псевдоним для concat
- Определяющие классы
- IterableOps
- Аннотации
- @inline()
final def ++:[B >: A](prefix: IterableOnce[B]): CC[B]
Псевдоним для prependedAll
- Определяющие классы
- SeqOps → IterableOps
- Аннотации
- @inline()
final def +:[B >: A](elem: B): CC[B]
Псевдоним для prepended.
Обратите внимание, что операторы, оканчивающиеся на двоеточие, являются правоассоциативными (см. пример). Мнемоника для +: по сравнению с :+: двоеточие идет со стороны коллекции.
def ->[B](y: B): (IndexedSeqOps[A, CC, C], B)
- Неявный
- Этот член добавлен неявным преобразованием из IndexedSeqOps[A, CC, C] к ArrowAssoc[IndexedSeqOps[A, CC, C]] выполняемого методом ArrowAssoc в scala.Predef.
- Определяющие классы
- ArrowAssoc
- Аннотации
- @inline()
final def :+[B >: A](elem: B): CC[B]
final def :++[B >: A](suffix: IterableOnce[B]): CC[B]
final def ==(arg0: Any): Boolean
Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- возвращает
trueесли принимаемый объект эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- AnyRef → Any
final def addString(b: StringBuilder): StringBuilder
Добавляет все элементы этой коллекции в строковый конструктор. Записанный текст состоит из строковых представлений (относительно метода toString) всех элементов этой коллекции без каких-либо разделительных строк.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> val h = a.addString(b) h: StringBuilder = 1234
- b
строковый конструктор, к которому добавляются элементы.
- возвращает
строковый конструктор
bк которому были добавлены элементы.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
final def addString(b: StringBuilder, sep: String): StringBuilder
Добавляет все элементы этой коллекции в строковый конструктор, используя разделительную строку. Записанный текст состоит из строковых представлений (относительно метода toString) всех элементов этой коллекции, разделенных строкой sep.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> a.addString(b, ", ") res0: StringBuilder = 1, 2, 3, 4
- b
строковый конструктор, к которому добавляются элементы.
- sep
разделительная строка.
- возвращает
строковый конструктор
bк которому были добавлены элементы.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
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
строковый конструктор, к которому добавляются элементы.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- возвращает
строковый конструктор
bк которому были добавлены элементы.
- Определяющие классы
- 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
добавляемый элемент
- возвращает
новая последовательность, состоящая из всех элементов этой последовательности, за которыми следует
value.
- Определяющие классы
- SeqOps
def appendedAll[B >: A](suffix: IterableOnce[B]): CC[B]
Возвращает новую последовательность, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элемента последовательности является наиболее специфическим суперклассом, охватывающим типы элементов двух операндов.
- B
тип элемента возвращаемой коллекции.
- suffix
итерируемый объект для добавления.
- возвращает
новая коллекция типа
CC[B], которая содержит все элементы этой последовательности, за которыми следуют все элементыsuffix.
- Определяющие классы
- SeqOps
final def asInstanceOf[T0]: T0
Преобразовать объект-получатель в объект типа T0.
Обратите внимание, что успех приведения типов во время выполнения зависит от семантики стирания Scala. Поэтому выражение 1.asInstanceOf[String] выбросит ClassCastException во время выполнения, а выражение List(1).asInstanceOf[List[String]] — нет. В последнем примере из-за стирания аргумента типа во время компиляции невозможно проверить, содержат ли элементы списка требуемый тип.
- returns
объект-получатель.
- Definition Classes
- Any
- Исключения
ClassCastExceptionесли объект-получатель не является экземпляром стёртого типаT0.
def clone(): C
Создать копию объекта-получателя.
Реализация метода clone по умолчанию зависит от платформы.
- returns
копия объекта-получателя.
def collect[B](pf: PartialFunction[A, B]): CC[B]
Создаёт новую итерируемую коллекцию, применяя частичную функцию ко всем элементам этой итерируемой коллекции, для которых функция определена.
- B
тип элементов возвращаемой итерируемой коллекции.
- pf
частичная функция, которая фильтрует и отображает итерируемую коллекцию.
- returns
новая итерируемая коллекция, полученная путём применения данной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Definition Classes
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def collectFirst[B](pf: PartialFunction[A, B]): Option[B]
Находит первый элемент коллекции, для которого заданная частичная функция определена, и применяет частичную функцию к нему.
Примечание: может не завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только тип основной коллекции не упорядочен.
- pf
частичная функция
- returns
значение Option, содержащее применённую 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 элементов этой последовательности.
- Definition Classes
- SeqOps
"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
- Аннотации
- @inline()
def contains[A1 >: A](elem: A1): Boolean
Проверяет, содержит ли эта последовательность данное значение в качестве элемента.
Примечание: может не завершаться для коллекций бесконечного размера.
- elem
элемент для проверки.
- returns
trueесли у этой последовательности есть элемент, равный (как определяется==)elem,falseв противном случае.
- Definition Classes
- SeqOps
def containsSlice[B](that: collection.Seq[B]): Boolean
Проверяет, содержит ли эта последовательность заданную последовательность в качестве среза.
Примечание: может не завершиться для бесконечно больших коллекций.
- that
последовательность для проверки
- returns
trueесли эта последовательность содержит срез с теми же элементами, что иthat, иначеfalse.
- Определяющие классы
- SeqOps
def copyToArray[B >: A](xs: Array[B], start: Int, len: Int): Int
Копирует элементы в массив, возвращая количество записанных элементов.
Заполняет данный массив xs начиная с индекса start не более чем len элементами этой коллекции.
Копирование прекратится, как только будут скопированы все элементы этой коллекции, или будет достигнут конец массива, или будет скопировано len элементов.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- len
максимальное количество элементов для копирования.
- returns
количество элементов, записанных в массив
- Определяющие классы
- IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, на котором он был вызван. Его использование не определено и может измениться. Примечание: не будет завершаться для бесконечно больших коллекций.
def copyToArray[B >: A](xs: Array[B], start: Int): Int
Копирует элементы в массив, возвращая количество записанных элементов.
Заполняет данный массив xs начиная с индекса start значениями этой коллекции.
Копирование прекратится, как только будут скопированы все элементы этой коллекции, или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- returns
количество элементов, записанных в массив Примечание: не будет завершаться для бесконечно больших коллекций.
- Определяющие классы
- IterableOnceOps
def copyToArray[B >: A](xs: Array[B]): Int
Копирует элементы в массив, возвращая количество записанных элементов.
Заполняет данный массив xs начиная с индекса start значениями этой коллекции.
Копирование прекратится, как только будут скопированы все элементы этой коллекции, или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- returns
количество элементов, записанных в массив Примечание: не будет завершаться для бесконечно больших коллекций.
- Определяющие классы
- IterableOnceOps
def corresponds[B](that: collection.Seq[B])(p: (A, B) => Boolean): Boolean
Проверяет, соотносится ли каждый элемент этой последовательности с соответствующим элементом другой последовательности, удовлетворяя тестовому предикату.
- B
тип элементов
that- that
другая последовательность
- p
тестовый предикат, который соотносит элементы из обеих последовательностей
- returns
trueесли обе последовательности имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтой последовательности иythat, иначеfalse.
- Определяющие классы
- SeqOps
def corresponds[B](that: IterableOnce[B])(p: (A, B) => Boolean): Boolean
Проверяет, соотносится ли каждый элемент итератора этой коллекции с соответствующим элементом другой коллекции, удовлетворяя тестовому предикату.
- B
тип элементов
that- that
другая коллекция
- p
тестовый предикат, который соотносит элементы из обеих коллекций
- returns
trueесли обе коллекции имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтого итератора иythat, иначеfalse
- Определяющие классы
- IterableOnceOps
def count(p: (A) => Boolean): Int
Подсчитывает количество элементов в коллекции, которые удовлетворяют предикату.
- p
предикат, используемый для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Определяющие классы
- IterableOnceOps
def diff[B >: A](that: collection.Seq[B]): C
Вычисляет разность мультимножеств между этой последовательностью и другой последовательностью.
- that
последовательность элементов для удаления
- returns
новая последовательность, которая содержит все элементы этой последовательности, за исключением некоторых вхождений элементов, которые также встречаются в
that. Если значение элементаxвстречается n раз вthat, то первые n вхожденийxне будут частью результата, но любые последующие вхождения будут.
- Определяющие классы
- SeqOps
def distinct: C
Выбирает все элементы этой последовательности, игнорируя дубликаты.
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
- Определяющие классы
- SeqOps
def distinctBy[B](f: (A) => B): C
Выбирает все элементы этой последовательности, игнорируя дубликаты, определяемые == после применения преобразующей функции f.
- B
тип элементов после преобразования
f- f
Преобразующая функция, результат которой используется для определения уникальности каждого элемента
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
- Определяющие классы
- SeqOps
def drop(n: Int): C
Выбирает все элементы, кроме первых n.
- n
число элементов для удаления из этой последовательности.
- returns
последовательность, состоящая из всех элементов этой последовательности, за исключением первых
nэлементов, или пустая последовательность, если эта последовательность содержит меньшеnэлементов. Еслиnотрицательно, не удалять элементы.
- Определяющие классы
- IndexedSeqOps → IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям нового итератора.
def dropRight(n: Int): C
Выбирает все элементы, кроме последних n.
- n
число элементов для удаления из этой последовательности.
- returns
последовательность, состоящая из всех элементов этой последовательности, за исключением последних
nэлементов, или пустая последовательность, если эта последовательность содержит меньшеnэлементов. Еслиnотрицательно, не удалять элементы.
- Определяющие классы
- IndexedSeqOps → IterableOps
def dropWhile(p: (A) => Boolean): C
Удаляет самый длинный префикс элементов, которые удовлетворяют предикату.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- p
Предикат, используемый для проверки элементов.
- returns
самый длинный суффикс этой итерируемой коллекции, первый элемент которого не удовлетворяет предикату
p.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям нового итератора.
def empty: C
Пустая итерируемая коллекция того же типа, что и эта итерируемая коллекция
- returns
пустая итерируемая коллекция типа
C.
- Определяющие классы
- IterableOps
def endsWith[B >: A](that: collection.Iterable[B]): Boolean
Проверяет, заканчивается ли эта последовательность заданной последовательностью.
Примечание: не завершается для бесконечно больших коллекций.
- that
последовательность для проверки
- returns
true, если эта последовательность имеетthatв качестве суффикса,falseв противном случае.
- Определяющие классы
- SeqOps
def ensuring(cond: (IndexedSeqOps[A, CC, C]) => Boolean, msg: => Any): IndexedSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из IndexedSeqOps[A, CC, C] вEnsuring[IndexedSeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: (IndexedSeqOps[A, CC, C]) => Boolean): IndexedSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из IndexedSeqOps[A, CC, C] вEnsuring[IndexedSeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean, msg: => Any): IndexedSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из IndexedSeqOps[A, CC, C] вEnsuring[IndexedSeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean): IndexedSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из IndexedSeqOps[A, CC, C] вEnsuring[IndexedSeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности на непустых экземплярах AnyRef, и имеет три дополнительных свойства:
-
Он согласован: для любых непустых экземпляров
x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false.Для любого непустого экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращает false.
null.eq(null) возвращает true. При переопределении методов equals или hashCode важно обеспечить, чтобы их поведение соответствовало ссылке на равенство. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2). и должны хешироваться к одному значению (o1.hashCode == o2.hashCode).
- возвращает
trueесли аргумент является ссылкой на объект-получатель;falseв противном случае.
- Определяющие классы
- AnyRef
def equals(arg0: AnyRef): Boolean
Метод равенства для ссылочных типов. Реализация по умолчанию делегирует eq.
См. также equals в scala.Any.
- возвращает
trueесли объект-получатель эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- AnyRef → Any
def exists(p: (A) => Boolean): Boolean
Проверяет, выполняется ли предикат хотя бы для одного элемента этого набора.
Примечание: может не завершиться для наборов бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
trueесли заданный предикатpвыполняется хотя бы для одного элемента этого набора, в противном случаеfalse
- Definition Classes
- IterableOnceOps
def filter(pred: (A) => Boolean): C
Выбирает все элементы этого итерируемого набора, которые удовлетворяют предикату.
- returns
новый итератор, содержащий все элементы этого итерируемого набора, которые удовлетворяют заданному предикату
p. Порядок элементов сохраняется.
- Definition Classes
- IterableOps → IterableOnceOps
def filterNot(pred: (A) => Boolean): C
Выбирает все элементы этого итерируемого набора, которые не удовлетворяют предикату.
- pred
предикат, используемый для проверки элементов.
- returns
новый итерируемый набор, состоящий из всех элементов этого итерируемого набора, которые не удовлетворяют заданному предикату
pred. Порядок элементов может быть не сохранён.
- Definition Classes
- IterableOps → IterableOnceOps
def finalize(): Unit
Вызывается сборщиком мусора для объекта-получателя, когда больше нет ссылок на объект.
Подробности о том, когда и как вызывается метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями, зависят от платформы.
def find(p: (A) => Boolean): Option[A]
Находит первый элемент набора, удовлетворяющий предикату, если такой существует.
Примечание: может не завершиться для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только тип базового набора не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
значение типа Option, содержащее первый элемент в наборе, который удовлетворяет
p, илиNoneесли такой не существует.
- Definition Classes
- IterableOnceOps
def findLast(p: (A) => Boolean): Option[A]
Находит последний элемент последовательности, удовлетворяющий предикату, если такой существует.
Примечание: не завершится для последовательностей бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
значение типа Option, содержащее последний элемент в последовательности, который удовлетворяет
p, илиNoneесли такой не существует.
- Definition Classes
- SeqOps
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к каждому элементу этого итерируемого набора и конкатенации результатов.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода вы должны отбросить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределено, может меняться и может привести к изменениям в новом итераторе.
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
новый итерируемый набор, полученный путём конкатенации всех итерируемых наборов элементов.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода вы должны отбросить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределено, может меняться и может привести к изменениям в новом итераторе.
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).
- Неявный
- Этот член добавляется неявным преобразованием из IndexedSeqOps[A, CC, C] в StringFormat[IndexedSeqOps[A, CC, C]] с помощью метода StringFormat в scala.Predef.
- Определяющие классы
- StringFormat
- Аннотации
- @inline()
final def getClass(): Class[_ <: AnyRef]
Возвращает представление класса времени выполнения объекта.
- returns
объект класса, соответствующий типу времени выполнения получателя.
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.
- Definition Classes
- 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
функция преобразования элементов
- Definition Classes
- 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)(_ + _)
Примечание: Даже при применении к представлению или ленивой коллекции это всегда будет приводить к принудительной обработке элементов.
- Definition Classes
- IterableOps
def grouped(size: Int): Iterator[C]
Разделяет элементы на итерируемые коллекции фиксированного размера.
- size
число элементов в группе
- returns
Итератор, создающий итерируемые коллекции размером
size, за исключением последней, которая будет меньше размераsize, если элементы не делятся нацело.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
grouped
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- returns
значение хэш-кода для этого объекта.
def head: A
Выбирает первый элемент этой итерируемой коллекции.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции.
- Definition Classes
- IterableOps
- Exceptions thrown
NoSuchElementExceptionесли итерируемая коллекция пуста.
def headOption: Option[A]
Необязательно выбирает первый элемент.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции, если она не пуста,
None, если она пуста.
- Definition Classes
- IterableOps
def indexOf[B >: A](elem: B): Int
Находит индекс первого вхождения некоторого значения в этой последовательности.
- B
тип элемента
elem.- elem
значение элемента, который нужно найти.
- returns
индекс
>= 0первого элемента этой последовательности, который равен (как определено==)elem, или-1, если такого не существует.
- Определяющие классы
- SeqOps
- Аннотации
- @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, если такого не существует.
- Определяющие классы
- SeqOps
def indexOfSlice[B >: A](that: collection.Seq[B]): Int
Находит первый индекс, где эта последовательность содержит заданную последовательность в качестве среза.
Примечание: может не завершиться для коллекций бесконечного размера.
- that
последовательность для проверки
- returns
первый индекс
>= 0такой, что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательностиthat, или-1, если такой подпоследовательности не существует.
- Определяющие классы
- SeqOps
- Аннотации
- @deprecatedOverriding("Override indexOfSlice(that, from) instead - indexOfSlice(that) calls indexOfSlice(that, 0)", "2.13.0")
def indexOfSlice[B >: A](that: collection.Seq[B], from: Int): Int
Находит первый индекс после или на заданном начальном индексе, где эта последовательность содержит заданную последовательность в качестве среза.
Примечание: может не завершиться для коллекций бесконечного размера.
- that
последовательность для проверки
- from
начальный индекс
- returns
первый индекс
>= fromтакой, что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательностиthat, или-1, если такой подпоследовательности не существует.
- Определяющие классы
- SeqOps
def indexWhere(p: (A) => Boolean): Int
Находит индекс первого элемента, удовлетворяющего некоторому предикату.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
индекс
>= 0первого элемента этой последовательности, который удовлетворяет предикатуp, или-1, если такого не существует.
- Определяющие классы
- SeqOps
- Аннотации
- @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, если такого не существует.
- Определяющие классы
- SeqOps
def indices: immutable.Range
Возвращает диапазон всех индексов этой последовательности.
Примечание: Даже при применении к представлению или ленивой коллекции это всегда будет приводить к вычислению элементов.
- returns
значение
Rangeот0до значения на единицу меньше длины этой последовательности.
- Определяющие классы
- SeqOps
def init: C
Начальная часть коллекции без её последнего элемента.
Примечание: Даже при применении к представлению или ленивой коллекции это всегда будет приводить к вычислению элементов.
- Определяющие классы
- 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: collection.Seq[B]): C
Вычисляет пересечение мультимножеств между этой последовательностью и другой последовательностью.
- that
последовательность элементов для пересечения.
- returns
новая последовательность, которая содержит все элементы этой последовательности, которые также появляются в
that. Если значение элементаxпоявляется n раз вthat, то первые n появленийxбудут сохранены в результате, но любые последующие появления будут пропущены.
- Definition Classes
- SeqOps
def isDefinedAt(idx: Int): Boolean
Проверяет, содержит ли эта последовательность данный индекс.
Реализации методов apply и isDefinedAt преобразуют Seq[A] в PartialFunction[Int, A].
- idx
индекс для проверки
- returns
trueесли эта последовательность содержит элемент в позицииidx,falseв противном случае.
- Definition Classes
- SeqOps
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
Проверка, можно ли многократно перебирать этот итерируемый набор. Всегда true для наборов и false для итераторов, если не переопределено.
- returns
trueесли набор можно многократно перебирать,falseв противном случае.
- Definition Classes
- IterableOps → IterableOnceOps
def iterator: Iterator[A]
Итератор может быть использован только один раз
- Definition Classes
- IndexedSeqOps → IterableOnce
def knownSize: Int
- returns
Количество элементов в этой последовательности, если оно может быть вычислено с низкой сложностью, иначе -1. Низкая сложность обычно означает: не требует обхода коллекции.
- Definition Classes
- IndexedSeqOps → IterableOnce
def last: A
Выбирает последний элемент.
- returns
Последний элемент этой последовательности.
- Definition Classes
- IndexedSeqOps → IterableOps
- Exceptions thrown
NoSuchElementExceptionЕсли последовательность пуста.
def lastIndexOf[B >: A](elem: B, end: Int = length - 1): Int
Находит индекс последнего появления некоторого значения в этой последовательности перед или в заданном конечном индексе.
Примечание: не завершится для последовательностей бесконечного размера.
- B
тип элемента
elem.- elem
значение элемента, для которого нужно выполнить поиск.
- end
конечный индекс.
- returns
индекс
<= endпоследнего элемента этой последовательности, который равен (как определяется==)elem, или-1, если такого элемента нет.
- Definition Classes
- SeqOps
def lastIndexOfSlice[B >: A](that: collection.Seq[B]): Int
Находит последний индекс, где эта последовательность содержит данную последовательность как срез.
Примечание: не завершится для бесконечно больших коллекций.
- that
последовательность для проверки
- returns
последний индекс, такой что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательности
that, или-1, если такой подпоследовательности не существует.
- Определяющие классы
- SeqOps
- Аннотации
- @deprecatedOverriding("Override lastIndexOfSlice(that, end) instead - lastIndexOfSlice(that) calls lastIndexOfSlice(that, Int.MaxValue)", "2.13.0")
def lastIndexOfSlice[B >: A](that: collection.Seq[B], end: Int): Int
Находит последний индекс до или на заданном конечном индексе, где эта последовательность содержит данную последовательность как срез.
Примечание: не завершится для бесконечно больших коллекций.
- that
последовательность для проверки
- end
конечный индекс
- returns
последний индекс
<= endтакой, что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательностиthat, или-1, если такой подпоследовательности не существует.
- Определяющие классы
- SeqOps
def lastIndexWhere(p: (A) => Boolean): Int
Находит индекс последнего элемента, удовлетворяющего некоторому предикату.
Примечание: не завершится для бесконечно больших коллекций.
- p
предикат, используемый для проверки элементов.
- returns
индекс последнего элемента этой последовательности, который удовлетворяет предикату
p, или-1, если такового не существует.
- Определяющие классы
- SeqOps
- Аннотации
- @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, если такового не существует.
- Определяющие классы
- SeqOps
def lastOption: Option[A]
Необязательно выбирает последний элемент.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
последний элемент этой итерируемой коллекции, если она не пуста,
None, если она пуста.
- Определяющие классы
- IterableOps
final def lengthCompare(that: collection.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.
- Определяющие классы
- IndexedSeqOps → SeqOps
final 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.
- Определяющие классы
- IndexedSeqOps → SeqOps
- См. также
final def lengthIs: SizeCompareOps
Возвращает класс значения, содержащий операции для сравнения длины этой последовательности с тестовым значением.
Эти операции реализованы с использованием lengthCompare(Int), и позволяют использовать следующие более читаемые варианты:
this.lengthIs < len // this.lengthCompare(len) < 0 this.lengthIs <= len // this.lengthCompare(len) <= 0 this.lengthIs == len // this.lengthCompare(len) == 0 this.lengthIs != len // this.lengthCompare(len) != 0 this.lengthIs >= len // this.lengthCompare(len) >= 0 this.lengthIs > len // this.lengthCompare(len) > 0
def map[B](f: (A) => B): CC[B]
Создает новую последовательность, применяя функцию ко всем элементам этой последовательности.
- B
тип элементов возвращаемой последовательности.
- f
функция, применяемая к каждому элементу.
- returns
новая последовательность, полученная в результате применения данной функции
fк каждому элементу этой последовательности и сбора результатов.
- Определяющие классы
- IndexedSeqOps → IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, к которому он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def mapInPlace(f: (A) => A): IndexedSeqOps.this.type
Модифицирует эту изменяемую последовательность, применяя функцию ко всем элементам этой изменяемой последовательности.
- f
функция, применяемая к каждому элементу.
- returns
эта изменяемая последовательность, модифицированная путем замены всех элементов результатом применения данной функции
fк каждому элементу этой изменяемой последовательности.
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.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationException, если этот набор пуст.
def minByOption[B](f: (A) => B)(implicit cmp: math.Ordering[B]): Option[A]
Находит первый элемент, который даёт наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, который используется для сравнения элементов.
- returns
Значение типа Option, содержащее первый элемент из этого набора с наименьшим значением, измеренным функцией f относительно порядка
cmp.
- Definition Classes
- IterableOnceOps
def minOption[B >: A](implicit ord: math.Ordering[B]): Option[A]
Находит наименьший элемент.
- B
Тип, для которого определён порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
Значение типа Option, содержащее наименьший элемент из этого набора относительно порядка
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)"
final def ne(arg0: AnyRef): Boolean
Эквивалентно !(this eq that).
- returns
trueесли аргумент не является ссылкой на объект-получатель;falseв противном случае.
- Definition Classes
- AnyRef
def nonEmpty: Boolean
Проверяет, не пуста ли коллекция.
- returns
trueесли коллекция содержит хотя бы один элемент,falseв противном случае.
- Definition Classes
- IterableOnceOps
- Annotations
- @deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")
final def notify(): Unit
Разбуживает единственную нить, ожидающую монитора объекта-получателя.
- Definition Classes
- AnyRef
- Annotations
- @native()
- Примечание
не указано SLS как член AnyRef
final def notifyAll(): Unit
Разбуживает все нити, ожидающие монитора объекта-получателя.
- Definition Classes
- AnyRef
- Annotations
- @native()
- Примечание
не указано SLS как член AnyRef
def occCounts[B](sq: collection.Seq[B]): Map[B, Int]
- Attributes
- protected[scala.collection]
- Definition Classes
- SeqOps
def padTo[B >: A](len: Int, elem: B): CC[B]
Копия этого набора с добавленным значением элемента до достижения заданной целевой длины.
- B
тип элемента возвращаемого набора.
- len
целевая длина
- elem
значение заполнения
- returns
новый набор, состоящий из всех элементов этого набора, за которым следует минимальное количество вхождений
elem, чтобы полученная коллекция имела длину как минимумlen.
- Definition Classes
- SeqOps
def partition(p: (A) => Boolean): (C, C)
Пара, во-первых, всех элементов, удовлетворяющих предикату p, и, во-вторых, всех элементов, которые не удовлетворяют. Интересно, потому что это разделяет коллекцию на две части.
Поставленная здесь реализация по умолчанию должна пройти по коллекции дважды. Строгие коллекции имеют переопределённую версию partition в StrictOptimizedIterableOps, которая требует только одного прохода.
- Definition Classes
- 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
- returns
пара итерируемых коллекций: первая состоит из тех значений, которые возвращались
fи были заключены в scala.util.Left, а вторая — из тех, которые были заключены в scala.util.Right.
- Definition Classes
- IterableOps
def patch[B >: A](from: Int, other: IterableOnce[B], replaced: Int): CC[B]
Создаёт новый набор, где фрагмент элементов в этом наборе заменяется другим набором.
Замена по отрицательным индексам эквивалентна замене, начинающейся с 0. Замена по индексам, равным или превышающим длину исходного набора, добавляет замену в конец. Если заменяется больше значений, чем фактически существует, избыточное количество игнорируется.
- B
тип элемента возвращаемого набора.
- from
индекс первого заменяемого элемента
- other
набор замены
- replaced
количество элементов для удаления в исходном наборе
- returns
новый набор, состоящий из всех элементов этого набора, за исключением того, что
replacedэлементы, начиная сfrom, заменяются всеми элементамиother.
- Definition Classes
- SeqOps
def permutations: Iterator[C]
Итерирует по различным перестановкам.
Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно извлекать элементы.
- returns
Итератор, который проходит по различным перестановкам этой последовательности.
- Definition Classes
- SeqOps
"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
элемент, добавляемый в начало
- returns
новая последовательность, состоящая из
valueи всех элементов этой последовательности.
- Definition Classes
- IndexedSeqOps → SeqOps
def prependedAll[B >: A](prefix: IterableOnce[B]): CC[B]
Как и :++, возвращает новую коллекцию, содержащую элементы левого операнда, за которыми следуют элементы правого операнда.
Отличается от :++ тем, что правый операнд определяет тип результирующей коллекции, а не левый. Мнемоника: знак ДВОЕТОЧИЯ находится со стороны нового типа КОЛлекции.
- B
тип элементов возвращаемой коллекции.
- prefix
итерируемый объект, добавляемый в начало.
- returns
новая последовательность, содержащая все элементы
prefix, за которыми следуют все элементы этой последовательности.
- Definition Classes
- SeqOps
def product[B >: A](implicit num: math.Numeric[B]): B
Перемножает элементы этой коллекции.
- B
тип результата оператора
*.- num
явный параметр, определяющий набор числовых операций, который включает оператор
*, используемый для вычисления произведения.- returns
произведение всех элементов этой коллекции относительно оператора
*вnum.
- Definition Classes
- IterableOnceOps
def reduce[B >: A](op: (B, B) => B): B
Сводит элементы этой коллекции, используя указанный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
- B
параметр типа для бинарного оператора, являющийся супертипом
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора reduce
opмежду всеми элементами, если коллекция не пуста.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
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являются элементами этой коллекции.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationExceptionесли эта коллекция пустая.
def reduceLeftOption[B >: A](op: (B, A) => B): Option[B]
При необходимости применяет бинарный оператор ко всем элементам этой коллекции слева направо.
Примечание: не завершит работу для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение Option, содержащее результат
reduceLeft(op), если эта коллекция не пуста,Noneв противном случае.
- Definition Classes
- IterableOnceOps
def reduceOption[B >: A](op: (B, B) => B): Option[B]
Сводит элементы этой коллекции, если таковые имеются, с помощью указанного ассоциативного бинарного оператора.
Порядок выполнения операций над элементами не определён и может быть недетерминированным.
- B
Параметр типа для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Значение типа Option, содержащее результат применения оператора reduce к всем элементам коллекции, если коллекция непуста, и
Noneв противном случае.
- Definition Classes
- 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являются элементами этой коллекции.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationException, если эта коллекция пуста.
def reduceRightOption[B >: A](op: (A, B) => B): Option[B]
При необходимости применяет бинарный оператор ко всем элементам этой коллекции, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции не упорядочен или оператор не ассоциативен и не коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение типа Option, содержащее результат
reduceRight(op), если эта коллекция не пуста,Noneв противном случае.
- Definition Classes
- IterableOnceOps
def reverse: C
Возвращает новую последовательность с элементами в обратном порядке.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычислены.
- returns
Новая последовательность со всеми элементами этой последовательности в обратном порядке.
- Definition Classes
- IndexedSeqOps → SeqOps
def reverseIterator: Iterator[A]
Итератор, возвращающий элементы в обратном порядке.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: xs.reverseIterator эквивалентно xs.reverse.iterator, но может быть более эффективным.
- returns
итератор, возвращающий элементы этой последовательности в обратном порядке
- Definition Classes
- IndexedSeqOps → SeqOps
def reversed: collection.Iterable[A]
- Attributes
- protected
- Definition Classes
- IndexedSeqOps → IterableOnceOps
def sameElements[B >: A](that: IterableOnce[B]): Boolean
Являются ли элементы этой коллекции такими же (и в том же порядке), что и элементы that?
- Definition Classes
- SeqOps
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
коллекция с промежуточными результатами
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был применен, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
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
коллекция с промежуточными результатами
- Определяющие классы
- IterableOps
def search[B >: A](elem: B, from: Int, to: Int)(implicit ord: math.Ordering[B]): SearchResult
Поиск в интервале в этой отсортированной последовательности для конкретного элемента. Если эта последовательность является IndexedSeq, используется бинарный поиск. В противном случае используется линейный поиск.
Последовательность должна быть отсортирована с тем же Ordering перед вызовом; в противном случае результаты не определены.
- elem
элемент для поиска.
- from
индекс, с которого начинается поиск.
- to
индекс, следующий за тем, где заканчивается поиск.
- ord
упорядочение, которое будет использоваться для сравнения элементов.
- returns
значение
Found, содержащее индекс, соответствующий элементу в последовательности, илиInsertionPoint, где элемент будет вставлен, если элемент отсутствует в последовательности.
- Определяющие классы
- IndexedSeqOps → SeqOps
- Примечание
если
to <= from, область поиска пуста, и возвращаетсяInsertionPointвfrom- См. также
-
scala.collection.SeqOps, метод
sorted
def search[B >: A](elem: B)(implicit ord: math.Ordering[B]): SearchResult
Поиск в этой отсортированной последовательности для конкретного элемента. Если последовательность является IndexedSeq, используется бинарный поиск. В противном случае используется линейный поиск.
Последовательность должна быть отсортирована с тем же Ordering перед вызовом; в противном случае результаты не определены.
- elem
элемент для поиска.
- ord
упорядочение, которое будет использоваться для сравнения элементов.
- returns
значение
Found, содержащее индекс, соответствующий элементу в последовательности, илиInsertionPoint, где элемент будет вставлен, если элемент отсутствует в последовательности.
- Определяющие классы
- IndexedSeqOps → SeqOps
- См. также
-
scala.collection.SeqOps, метод
sorted
def segmentLength(p: (A) => Boolean, from: Int): Int
Вычисляет длину самого длинного сегмента, элементы которого удовлетворяют некоторому предикату.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- from
индекс, с которого начинается поиск.
- returns
длина самого длинного сегмента этой последовательности, начиная с индекса
from, такого, что каждый элемент сегмента удовлетворяет предикатуp.
- Определяющие классы
- SeqOps
final def segmentLength(p: (A) => Boolean): Int
Вычисляет длину самой длинной последовательности элементов, удовлетворяющих некоторому предикату.
Примечание: может не завершаться для коллекций бесконечной размерности.
- p
предикат, используемый для проверки элементов.
- возвращает
длину самой длинной последовательности элементов в этой последовательности, где каждый элемент удовлетворяет предикату
p.
- Definition Classes
- SeqOps
final def size: Int
Размер этой последовательности.
Примечание: не завершится для коллекций бесконечной размерности.
- возвращает
количество элементов в этой последовательности.
- Definition Classes
- SeqOps → IterableOnceOps
final def sizeCompare(that: collection.Iterable[_]): Int
Сравнивает размер этой последовательности с размером другой Iterable.
- that
последовательность
Iterable, размер которой сравнивается с размером этой последовательности.- возвращает
-
Значение
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
значение для сравнения с размером.
- возвращает
-
Значение
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
наименьший индекс для исключения из этой последовательности.
- возвращает
последовательность, содержащую элементы, большие или равные индексу
from, и до (но не включая) индексаuntilэтой последовательности.
- Definition Classes
- IndexedSeqOps → IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода следует отказаться от итератора, на котором был вызван метод, и использовать только возвращённый итератор. Использование старого итератора неопределено, может измениться и может привести к изменениям в новом итераторе.
def sliding(size: Int, step: Int): Iterator[C]
Группирует элементы в блоки фиксированного размера, пропуская "скользящее окно" над ними (в отличие от разделения их, как в grouped.)
- size
количество элементов в группе
- step
расстояние между первыми элементами последовательных групп
- возвращает
Итератор, генерирующий итерируемые коллекции размером
size, за исключением последнего элемента (который может быть единственным), который будет обрезан, если останется меньшеsizeэлементов для группирования.
- Definition Classes
- IterableOps
- См. также
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
Сортирует эту последовательность в соответствии с Ordering, который получается в результате преобразования неявно заданного Ordering с помощью функции преобразования.
Примечание: не будет завершаться для бесконечно больших коллекций.
Примечание: Даже при применении к представлению или ленивой коллекции он всегда будет принудительно обрабатывать элементы.
Сортировка стабильна. То есть элементы, которые равны (как определено ord.compare), появляются в отсортированной последовательности в том же порядке, что и в исходной.
- B
целевой тип преобразования
f, и тип, где определен порядокord.- f
функция преобразования, отображающая элементы в другую область
B.- ord
порядок, предполагаемый в области
B.- returns
последовательность, состоящая из элементов этой последовательности, отсортированных в соответствии с порядком, где
x < y, еслиord.lt(f(x), f(y)).
- Definition Classes
- SeqOps
- 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 sortInPlace[B >: A]()(implicit ord: Ordering[B]): IndexedSeqOps.this.type
Сортирует эту изменяемую последовательность на месте в соответствии с Ordering.
- ord
порядок, который будет использоваться для сравнения элементов.
- returns
измененная входная изменяемая последовательность, отсортированная в соответствии с порядком
ord.
- See also
def sortInPlaceBy[B](f: (A) => B)(implicit ord: Ordering[B]): IndexedSeqOps.this.type
Сортирует эту изменяемую последовательность на месте в соответствии с Ordering, который получается в результате преобразования неявно заданного Ordering с помощью функции преобразования.
- See also
def sortInPlaceWith(lt: (A, A) => Boolean): IndexedSeqOps.this.type
Сортирует эту изменяемую последовательность на месте в соответствии с функцией сравнения.
- See also
def sortWith(lt: (A, A) => Boolean): C
Сортирует эту последовательность в соответствии с функцией сравнения.
Примечание: не будет завершаться для бесконечно больших коллекций.
Примечание: Даже при применении к представлению или ленивой коллекции он всегда будет принудительно обрабатывать элементы.
Сортировка стабильна. То есть элементы, которые равны (как определено lt), появляются в отсортированной последовательности в том же порядке, что и в исходной.
- lt
функция сравнения, которая проверяет, предшествует ли ее первый аргумент второму аргументу в нужном порядке.
- returns
последовательность, состоящая из элементов этой последовательности, отсортированных в соответствии с функцией сравнения
lt.
- Definition Classes
- SeqOps
List("Steve", "Tom", "John", "Bob").sortWith(_.compareTo(_) < 0) =
List("Bob", "John", "Steve", "Tom")
def sorted[B >: A](implicit ord: Ordering[B]): C
Сортирует эту последовательность в соответствии с Ordering.
Сортировка стабильна. То есть элементы, которые равны (как определено ord.compare), появляются в отсортированной последовательности в том же порядке, что и в исходной.
- ord
порядок, который будет использоваться для сравнения элементов.
- returns
последовательность, состоящая из элементов этой последовательности, отсортированных в соответствии с порядком
ord.
- Definition Classes
- SeqOps
- 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
индекс, где ищется последовательность.
- returns
true, если последовательностьthatсодержится в этой последовательности по индексуoffset, в противном случаеfalse.
- Definition Classes
- SeqOps
def stepper[S <: Stepper[_]](implicit shape: StepperShape[A, S]): S with EfficientSplit
Возвращает 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
- IndexedSeqOps → IterableOnce
def sum[B >: A](implicit num: math.Numeric[B]): B
Суммирует элементы этой коллекции.
- B
тип результата оператора
+.- num
неявный параметр, определяющий набор арифметических операций, который включает оператор
+для использования при формировании суммы.- returns
сумма всех элементов этой коллекции относительно оператора
+вnum.
- Definition Classes
- IterableOnceOps
final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
def tail: C
Остаток коллекции без её первого элемента.
- Definition Classes
- IterableOps
def tails: Iterator[C]
Итерируется по хвостам этого итерируемого набора. Первое значение будет этим итерируемым набором, а последнее — пустым итерируемым набором, а промежуточные значения — результатами последовательного применения tail.
- returns
итератор по всем хвостам этого итерируемого набора
- 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
количество элементов для взятия из этой последовательности.
- returns
последовательность, содержащую только первые
nэлементов этой последовательности, или же всю последовательность, если она содержит менееnэлементов. Еслиnотрицательно, возвращает пустую последовательность.
- Definition Classes
- IndexedSeqOps → IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def takeRight(n: Int): C
Выбирает последние n элементов.
- n
количество элементов для взятия из этой последовательности.
- returns
последовательность, содержащую только последние
nэлементов этой последовательности, или же всю последовательность, если она содержит менееnэлементов. Еслиnотрицательно, возвращает пустую последовательность.
- Definition Classes
- IndexedSeqOps → IterableOps
def takeWhile(p: (A) => Boolean): C
Берет самую длинную префиксную последовательность элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- p
Предикат для проверки элементов.
- returns
самую длинную префиксную последовательность из элементов этого итерируемого набора, все из которых удовлетворяют предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
def tapEach[U](f: (A) => U): C
Применяет функцию со побочным эффектом к каждому элементу в этом наборе. Строгие коллекции будут применять f к своим элементам немедленно, в то время как ленивые коллекции, такие как Views и 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]
- Определения классов
- IterableOnceOps
def toSeq: immutable.Seq[A]
- возвращает
Этот набор как
Seq[A]. Это эквивалентноto(Seq), но может быть быстрее.
- Определения классов
- IterableOnceOps
def toSet[B >: A]: immutable.Set[B]
- Определения классов
- IterableOnceOps
def toString(): String
Создает строковое представление этого объекта. По умолчанию представление зависит от платформы. На платформе Java это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.
- возвращает
строковое представление объекта.
- Определения классов
- AnyRef → Any
def toVector: immutable.Vector[A]
- Определения классов
- IterableOnceOps
def transpose[B](implicit asIterable: (A) => collection.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.- возвращает
двумерный итерируемый набор итерируемых наборов, в котором n-я строка — это n-й столбец этого итерируемого набора.
- Определения классов
- 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
явное преобразование, которое утверждает, что тип элемента этого итерируемого набора является парой.
- возвращает
пара итерируемых наборов, содержащих первую, соответственно, вторую половину каждой пары элементов этого итерируемого набора.
- Определения классов
- 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
явное преобразование, которое утверждает, что тип элемента этого итерируемого набора является тройкой.
- возвращает
тройку итерируемых наборов, содержащих первый, второй, соответственно, третий член каждой тройки элементов этого итерируемого набора.
- Определения классов
- IterableOps
def updated[B >: A](index: Int, elem: B): CC[B]
Копия этой последовательности с одним заменённым элементом.
- B
тип элемента возвращаемой последовательности.
- index
позиция замены
- elem
элемент замены
- returns
новая последовательность, являющаяся копией этой последовательности с элементом в позиции
indexзаменённым наelem.
- Definition Classes
- SeqOps
- Исключения
IndexOutOfBoundsException, еслиindexне удовлетворяет условию0 <= index < length. В случае ленивой коллекции это исключение может быть выброшено в более позднее время или вообще не выброшено (если конец коллекции никогда не оценивается).
def view: IndexedSeqView[A]
Представление элементов этой коллекции.
- Definition Classes
- IndexedSeqOps → SeqOps → IterableOps
final def wait(): Unit
- Definition Classes
- AnyRef
- Аннотации
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Аннотации
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long): Unit
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: collection.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.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
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/mutable/IndexedSeqOps.html