Траит scala.collection.StrictOptimizedLinearSeqOps
траит StrictOptimizedLinearSeqOps[+A, +CC[X] <: LinearSeq[X], +C <: LinearSeq[A] with StrictOptimizedLinearSeqOps[A, CC, C]] extends LinearSeqOps[A, CC, C] with StrictOptimizedSeqOps[A, CC, C]
- Источник
- LinearSeq.scala
- Линейные супертипы
- StrictOptimizedSeqOps[A, CC, C], StrictOptimizedIterableOps[A, CC, C], LinearSeqOps[A, CC, C], SeqOps[A, CC, C], IterableOps[A, CC, C], IterableOnceOps[A, CC, C], IterableOnce[A], Any
- Известные подклассы
- ::, List, Nil, Queue
Члены-значения абстрактного типа
абстрактный метод coll: C
- возвращает
Это коллекцию в виде
C.
- Атрибуты
- защищенное
- Определяющие классы
- IterableOps
абстрактный метод fromSpecific(coll: IterableOnce[A]): C
Определяет, как преобразовать заданную Iterable[A] в коллекцию типа C.
Этот процесс может быть выполнен строго или нестрого (т. е. без оценки элементов результирующих коллекций). Другими словами, этот метод определяет модель оценки коллекции.
- Атрибуты
- защищенное
- Определяющие классы
- IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (иначе компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, добавив трейт IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, если он вызывается сIterable[A], полученным отthisколлекции (как это происходит при реализации операций, где мы используемView[A]), это безопасно.
абстрактный метод getClass(): Class[_ <: AnyRef]
Возвращает представление класса объекта во время выполнения.
- возвращает
объект класса, соответствующий типу получателя во время выполнения.
- Определяющие классы
- Any
абстрактный метод iterableFactory: IterableFactory[CC]
Объект-компаньон этой коллекции iterable, предоставляющий различные методы фабрики.
- Определяющие классы
- IterableOps
- Примечание
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (иначе компилятор выдаст ошибку).
абстрактный метод newSpecificBuilder: Builder[A, C]
- возвращает
строгий билдер для того же типа коллекции. Обратите внимание, что в случае ленивых коллекций (например, View или immutable.LazyList) реализовать этот метод возможно, но результирующая
Builderнарушит леность. Следовательно, операции предпочтительнее реализовывать с помощьюfromSpecificвместо этого метода.
- Атрибуты
- защищенное
- Определяющие классы
- IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (иначе компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, добавив трейт IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, если возвращаемый билдер содержит только значенияA, взятые из экземпляраthis, это безопасно.
абстрактный метод toIterable: Iterable[A]
- возвращает
Эту коллекцию в виде
Iterable[A]. Новая коллекция не будет создана, еслиthisуже являетсяIterable[A].
- Определяющие классы
- IterableOps
Конкретные члены значения
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- returns
trueесли !(this == that), иначе false.
- Определяющие классы
- Any
final def ##(): Int
Эквивалентно x.hashCode за исключением boxed числовых типов и null. Для чисел, он возвращает хеш-значение, которое согласуется с равенством значений: если два экземпляра типа значения сравниваются как true, то ## будет генерировать одно и то же хеш-значение для каждого из них. Для null возвращает хеш-код, где null.hashCode вызывает NullPointerException.
- returns
хеш-значение, согласованное с ==
- Определяющие классы
- Any
def +(other: String): String
- Неявное
- Этот член добавляется неявным преобразованием из StrictOptimizedLinearSeqOps[A, CC, C] вany2stringadd[StrictOptimizedLinearSeqOps[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): (StrictOptimizedLinearSeqOps[A, CC, C], B)
- Неявное
- Этот член добавляется неявным преобразованием из StrictOptimizedLinearSeqOps[A, CC, C] вArrowAssoc[StrictOptimizedLinearSeqOps[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в противном случае.
- Определяющие классы
- 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
строковый билдер, к которому добавляются элементы.
- возвращает
строковый билдер
bк которому были добавлены элементы.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @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
разделительная строка.
- возвращает
строковый билдер
bк которому были добавлены элементы.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @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
конечная строка.
- возвращает
строковый билдер
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.
- Определяющие классы
- StrictOptimizedSeqOps → SeqOps
def appendedAll[B >: A](suffix: IterableOnce[B]): CC[B]
Возвращает новую последовательность, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элемента последовательности является наиболее специфическим суперклассом, охватывающим типы элементов двух операндов.
- B
тип элемента возвращаемой коллекции.
- suffix
итерируемый объект для добавления.
- возвращает
новая коллекция типа
CC[B], которая содержит все элементы этой последовательности, за которыми следуют все элементыsuffix.
- Определяющие классы
- StrictOptimizedSeqOps → SeqOps
def apply(n: Int): A
Получение элемента по указанному индексу. Эта операция предоставляется для удобства в Seq. Не следует предполагать, что она эффективна, если у вас нет IndexedSeq.
- Definition Classes
- LinearSeqOps → SeqOps
- Annotations
- @throws(scala.this.throws.<init>$default$1[IndexOutOfBoundsException])
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
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.
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
- Annotations
- @inline()
def contains[A1 >: A](elem: A1): Boolean
Проверяет, содержит ли эта последовательность заданное значение в качестве элемента.
Примечание: может не завершаться для коллекций бесконечного размера.
- elem
элемент для проверки.
- returns
truetrue, если в этой последовательности есть элемент, равный (определяется==)elem,falseв противном случае.
- Definition Classes
- LinearSeqOps → SeqOps
def containsSlice[B](that: Seq[B]): Boolean
Проверяет, содержит ли эта последовательность заданную последовательность в качестве слайса.
Примечание: может не завершиться для коллекций бесконечного размера.
- that
последовательность для проверки
- returns
trueесли эта последовательность содержит слайс с теми же элементами, что иthat, в противном случаеfalse.
- Definition Classes
- SeqOps
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другой последовательности, в противном случаеfalse.
- Definition Classes
- SeqOps
def corresponds[B](that: IterableOnce[B])(p: (A, B) => Boolean): Boolean
Проверяет, соответствуют ли каждый элемент итератора этой коллекции соответствующему элементу другой коллекции, удовлетворяя условию предиката.
- B
тип элементов
that- that
другая коллекция
- p
условие предиката, которое связывает элементы из обеих коллекций
- returns
trueесли обе коллекции имеют одинаковую длину иp(x, y)равноtrueдля всех соответствующих элементовxэтого итератора иyдругой коллекции, в противном случае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не будут входить в результат, но любые последующие вхождения будут.
- Definition Classes
- StrictOptimizedSeqOps → SeqOps
def distinct: C
Выбирает все элементы этой последовательности, игнорируя дубликаты.
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
- Definition Classes
- SeqOps
def distinctBy[B](f: (A) => B): C
Выбирает все элементы этой последовательности, игнорируя дубликаты, как определено ==, после применения функции преобразования f.
- B
тип элементов после преобразования
f- f
Функция преобразования, результат которой используется для определения уникальности каждого элемента
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
- Definition Classes
- StrictOptimizedSeqOps → SeqOps
def drop(n: Int): C
Выбирает все элементы, кроме первых n.
- n
количество элементов, которые нужно удалить из этой последовательности.
- returns
последовательность, состоящая из всех элементов этой последовательности, за исключением первых
nэлементов, или пустая последовательность, если эта последовательность содержит меньше чемnэлементов. Еслиnотрицательное, не удалять элементы.
- Definition Classes
- StrictOptimizedLinearSeqOps → IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def dropRight(n: Int): C
Остальная часть коллекции без её n последних элементов. Для линейных, неизменяемых коллекций это должно предотвращать создание копии.
Примечание: даже при применении к представлению или ленивой коллекции это всегда будет принуждать элементы.
- n
количество элементов, которые нужно удалить из этой итерируемой коллекции.
- returns
итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, за исключением последних
nэлементов, или пустая итерируемая коллекция, если эта итерируемая коллекция содержит меньше чемnэлементов. Еслиnотрицательное, не удалять элементы.
- Definition Classes
- StrictOptimizedIterableOps → IterableOps
def dropWhile(p: (A) => Boolean): C
Удаляет самый длинный префикс элементов, которые удовлетворяют предикату.
- p
Предикат, используемый для проверки элементов.
- returns
самый длинный суффикс этой последовательности, первый элемент которого не удовлетворяет предикату
p.
- Definition Classes
- StrictOptimizedLinearSeqOps → IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def empty: C
Пустая итерируемая коллекция того же типа, что и эта итерируемая коллекция
- returns
пустая итерируемая коллекция типа
C.
- Definition Classes
- IterableOps
def endsWith[B >: A](that: Iterable[B]): Boolean
Проверяет, заканчивается ли эта последовательность данной последовательностью.
Примечание: не завершится для бесконечно больших коллекций.
- that
последовательность для проверки
- returns
trueесли эта последовательность имеетthatв качестве суффикса,falseв противном случае.
- Definition Classes
- SeqOps
def ensuring(cond: (StrictOptimizedLinearSeqOps[A, CC, C]) => Boolean, msg: => Any): StrictOptimizedLinearSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из StrictOptimizedLinearSeqOps[A, CC, C] в Ensuring[StrictOptimizedLinearSeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: (StrictOptimizedLinearSeqOps[A, CC, C]) => Boolean): StrictOptimizedLinearSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из StrictOptimizedLinearSeqOps[A, CC, C] в Ensuring[StrictOptimizedLinearSeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean, msg: => Any): StrictOptimizedLinearSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из StrictOptimizedLinearSeqOps[A, CC, C] в Ensuring[StrictOptimizedLinearSeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean): StrictOptimizedLinearSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из StrictOptimizedLinearSeqOps[A, CC, C] в Ensuring[StrictOptimizedLinearSeqOps[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
- Классы определений
- LinearSeqOps → IterableOnceOps
def filter(pred: (A) => Boolean): C
Выбирает все элементы этой итерируемой коллекции, которые удовлетворяют предикату.
- возвращает
новый итератор, состоящий из всех элементов этой итерируемой коллекции, которые удовлетворяют заданному предикату
p. Порядок элементов сохраняется.
- Классы определений
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
def filterImpl(pred: (A) => Boolean, isFlipped: Boolean): C
- Атрибуты
- protected[scala.collection]
- Классы определений
- StrictOptimizedIterableOps
def filterNot(pred: (A) => Boolean): C
Выбирает все элементы этой итерируемой коллекции, которые не удовлетворяют предикату.
- pred
предикат, используемый для проверки элементов.
- возвращает
новая итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, которые не удовлетворяют заданному предикату
pred. Порядок элементов может не сохраняться.
- Классы определений
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
def find(p: (A) => Boolean): Option[A]
Находит первый элемент последовательности, удовлетворяющий предикату, если таковой имеется.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- возвращает
значение типа option, содержащее первый элемент в последовательности, который удовлетворяет
p, илиNoneесли таковой не существует.
- Классы определений
- LinearSeqOps → IterableOnceOps
def findLast(p: (A) => Boolean): Option[A]
Находит последний элемент последовательности, удовлетворяющий предикату, если таковой имеется.
Примечание: не будет завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- возвращает
значение типа option, содержащее последний элемент в последовательности, который удовлетворяет
p, илиNoneесли таковой не существует.
- Классы определений
- LinearSeqOps → 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к каждому элементу этой итерируемой коллекции и конкатенации результатов.
- Определяющие классы
- StrictOptimizedIterableOps → IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был применен, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def flatten[B](implicit toIterableOnce: (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
тип элементов каждой обходимой коллекции.
- returns
новая итерируемая коллекция, полученная путем конкатенации всех итерируемых коллекций элементов.
- Определяющие классы
- StrictOptimizedIterableOps → 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, если эта последовательность пуста.
- Определяющие классы
- LinearSeqOps → 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.
- Определяющие классы
- LinearSeqOps → IterableOnceOps
def foreach[U](f: (A) => U): Unit
Применить f к каждому элементу для его побочных эффектов. Примечание: параметр [U] необходим для помощи выводу типов scalac.
- Определяющие классы
- LinearSeqOps → IterableOnceOps
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной строкой format. Строки форматирования такие же, как для String.format (@see java.lang.String.format).
- Неявное
- Этот член добавляется неявным преобразованием из StrictOptimizedLinearSeqOps[A, CC, C] в StringFormat[StrictOptimizedLinearSeqOps[A, CC, C]] с помощью метода StringFormat в scala.Predef.
- Определяющие классы
- StringFormat
- Аннотации
- @inline()
def groupBy[K](f: (A) => K): immutable.Map[K, C]
Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с некоторой функцией дискриминатора.
Примечание: даже при применении к представлению или ленивой коллекции это всегда будет принудительно использовать элементы.
- K
тип ключей, возвращаемых функцией дискриминатора.
- f
функция дискриминатора.
- возвращает
-
Карту из ключей в итерируемые коллекции, так что выполняется следующее инвариантное условие:
(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
количество элементов в группе
- возвращает
Итератор, создающий итерируемые коллекции размером
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, если она пуста.
- Определяющие классы
- LinearSeqOps → 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: 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: Seq[B], from: Int): Int
Находит первый индекс после или на начальном индексе, где эта последовательность содержит заданную последовательность как срез.
Примечание: может не завершиться для коллекций бесконечного размера.
- that
последовательность для проверки
- from
начальный индекс
- returns
первый индекс
>= fromтакой, что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательностиthat, или-1, если такой подпоследовательности не существует.
- Определяющие классы
- SeqOps
def indexWhere(p: (A) => Boolean, from: Int): Int
Находит индекс первого элемента, удовлетворяющего некоторому предикату после или на каком-либо начальном индексе.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- from
начальный индекс
- returns
индекс
>= fromпервого элемента этой последовательности, который удовлетворяет предикатуp, или-1, если такого не существует.
- Определяющие классы
- LinearSeqOps → 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 indices: immutable.Range
Создает диапазон всех индексов этой последовательности.
Примечание: Даже при применении к представлению или ленивой коллекции он всегда будет принудительно получать элементы.
- returns
значение
Rangeот0до значения на единицу меньше длины этой последовательности.
- Определяющие классы
- SeqOps
def init: C
Начальная часть коллекции без её последнего элемента.
Примечание: Даже при применении к представлению или ленивой коллекции он всегда будет принудительно получать элементы.
- Определяющие классы
- IterableOps
def inits: Iterator[C]
Перебирает начальные части этой итерируемой коллекции. Первое значение будет этой итерируемой коллекцией, а последнее — пустой итерируемой коллекцией, а промежуточные значения — результатами последовательного применения init.
Примечание: Даже при применении к представлению или ленивой коллекции он всегда будет принудительно получать элементы.
- returns
итератор по всем начальным частям этой итерируемой коллекции
- Определяющие классы
- 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будут сохранены в результате, но любые последующие вхождения будут опущены.
- Определяющие классы
- StrictOptimizedSeqOps → SeqOps
def isDefinedAt(x: Int): Boolean
Проверяет, содержит ли эта последовательность заданный индекс.
Реализации методов apply и isDefinedAt превращают Seq[A] в PartialFunction[Int, A].
- returns
trueесли эта последовательность содержит элемент в позицииidx,falseв противном случае.
- Определяющие классы
- LinearSeqOps → SeqOps
def isEmpty: Boolean
Проверяет, пуста ли последовательность.
Примечание: Реализации в подклассах, которые не являются многократно проходимыми, должны позаботиться о том, чтобы не потреблять никаких элементов, когда вызывается isEmpty.
- returns
trueесли последовательность не содержит элементов,falseв противном случае.
- Определяющие классы
- SeqOps → IterableOnceOps
final def isInstanceOf[T0]: Boolean
Проверяет, является ли динамический тип объекта-получателя T0.
Обратите внимание, что результат теста соответствует семантике стирания Scala. Поэтому выражение 1.isInstanceOf[String] вернет false, а выражение List(1).isInstanceOf[List[String]] вернет true. Во втором примере, поскольку тип аргумента стирается в процессе компиляции, невозможно проверить, содержится ли в списке указанный тип.
- returns
trueесли объект-получатель является экземпляром стирания типаT0;falseв противном случае.
- Определяющие классы
- Any
def isTraversableAgain: Boolean
Проверяет, может ли эта итерируемая коллекция быть многократно пройдена. Всегда true для Iterable и false для Iterator, если не переопределено.
- returns
trueесли она многократно проходима,falseв противном случае.
- Определяющие классы
- IterableOps → IterableOnceOps
def iterator: Iterator[A]
Итератор может использоваться только один раз
- Определяющие классы
- StrictOptimizedLinearSeqOps → LinearSeqOps → IterableOnce
def knownSize: Int
- returns
Количество элементов в этой коллекции, если его можно легко вычислить, -1 в противном случае. «Легко» обычно означает: не требуется обход коллекции.
- Определяющие классы
- IterableOnce
def last: A
Выбирает последний элемент.
- returns
Последний элемент этой последовательности.
- Определяющие классы
- LinearSeqOps → IterableOps
- Выбрасываемые исключения
NoSuchElementExceptionЕсли последовательность пуста.
def lastIndexOf[B >: A](elem: B, end: Int = length - 1): Int
Находит индекс последнего вхождения некоторого значения в этой последовательности до или на заданном конечном индексе.
Примечание: не завершится для коллекций бесконечного размера.
- B
тип элемента
elem.- elem
значение элемента для поиска.
- end
конечный индекс.
- returns
индекс
<= endпоследнего элемента этой последовательности, который равен (как определено==)elem, или-1, если такового не существует.
- Определяющие классы
- SeqOps
def lastIndexOfSlice[B >: A](that: 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: Seq[B], end: Int): Int
Находит последний индекс до или на заданном конечном индексе, где эта последовательность содержит заданную последовательность как срез.
Примечание: не завершится для коллекций бесконечного размера.
- that
последовательность для проверки
- end
конечный индекс
- returns
последний индекс
<= endтакой, что элементы этой последовательности, начиная с этого индекса, совпадают с элементами последовательностиthat, или-1если такой подпоследовательности не существует.
- Определяющие классы
- SeqOps
def lastIndexWhere(p: (A) => Boolean, end: Int): Int
Находит индекс последнего элемента, удовлетворяющего некоторому предикату, до или на заданном конечном индексе.
Примечание: не завершится для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
индекс
<= endпоследнего элемента этой последовательности, который удовлетворяет предикатуp, или-1, если такового не существует.
- Определяющие классы
- LinearSeqOps → 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 lastOption: Option[A]
Необязательно выбирает последний элемент.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- returns
последний элемент этой итерируемой коллекции, если она не пуста,
None, если она пуста.
- Определяющие классы
- IterableOps
def length: Int
Длина (число элементов) последовательности. size является псевдонимом для length в Seq коллекциях.
- Определяющие классы
- LinearSeqOps → SeqOps
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.
- Определяющие классы
- LinearSeqOps → SeqOps
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.
- Определяющие классы
- LinearSeqOps → SeqOps
- См. также
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
def map[B](f: (A) => B): CC[B]
Создает новую итерируемую коллекцию, применяя функцию ко всем элементам этой итерируемой коллекции.
- B
тип элемента возвращаемой итерируемой коллекции.
- f
функция, применяемая к каждому элементу.
- returns
новая итерируемая коллекция, полученная в результате применения заданной функции
fк каждому элементу этой итерируемой коллекции и сбора результатов.
- Определяющие классы
- StrictOptimizedIterableOps → 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.
- Определяющие классы
- IterableOnceOps
def minOption[B >: A](implicit ord: math.Ordering[B]): Option[A]
Находит наименьший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
опциональное значение, содержащее наименьший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
final def mkString: String
Отображает все элементы этой коллекции в строке.
Делегирует addString, который может быть переопределен.
- returns
строковое представление этой коллекции. В результирующей строке строковые представления (относительно метода
toString) всех элементов этой коллекции следуют друг за другом без каких-либо разделительных строк.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
final def mkString(sep: String): String
Отображает все элементы этой коллекции в строке, используя разделительную строку.
Делегирует addString, который может быть переопределен.
- sep
разделительная строка.
- returns
строковое представление этой коллекции. В результирующей строке строковые представления (относительно метода
toString) всех элементов этой коллекции разделены строкойsep.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @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]
- Definition Classes
- SeqOps
def padTo[B >: A](len: Int, elem: B): CC[B]
Копия этой последовательности с добавленными элементами значения до достижения заданной целевой длины.
- B
тип элемента возвращаемой последовательности.
- len
целевая длина.
- elem
значение заполнения.
- returns
новая последовательность, состоящая из всех элементов этой последовательности, за которыми следуют минимальное количество вхождений
elemтаким образом, чтобы полученная коллекция имела длину как минимумlen.
- Definition Classes
- StrictOptimizedSeqOps → SeqOps
def partition(p: (A) => Boolean): (C, C)
Пара, содержащая во-первых, все элементы, удовлетворяющие предикату p, и, во-вторых, все элементы, которые не удовлетворяют. Интересно, потому что разделяет коллекцию на две части.
Представленная здесь реализация по умолчанию требует два прохода по коллекции. Строгие коллекции имеют переопределённую версию partition в StrictOptimizedIterableOps, которая требует только одного прохода.
- Definition Classes
- 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
- returns
пара итерируемых коллекций: первая — из значений, возвращенных
fи заключённых в scala.util.Left, а вторая — из значений, заключённых в scala.util.Right.
- Definition Classes
- StrictOptimizedIterableOps → 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
- StrictOptimizedSeqOps → SeqOps
def prependedAll[B >: A](prefix: IterableOnce[B]): CC[B]
Так же как и :++, возвращает новую коллекцию, содержащую элементы из левого операнда, после которых следуют элементы из правого операнда.
Отличается от :++ тем, что правый операнд определяет тип результирующей коллекции, а не левый. Мнемоника: двоеточие находится со стороны нового типа коллекции.
- B
тип элементов возвращаемой коллекции.
- prefix
итерируемый объект для добавления в начало.
- returns
новая последовательность, содержащая все элементы
prefix, за которыми следуют все элементы этой последовательности.
- Definition Classes
- StrictOptimizedSeqOps → 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
опциональное значение, содержащее результат
reduceLeft(op)если эта коллекция не пуста,Noneв противном случае.
- Определяющие классы
- IterableOnceOps
def reduceOption[B >: A](op: (B, B) => B): Option[B]
Сводит элементы этой коллекции, если таковые имеются, используя указанный ассоциативный бинарный оператор.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
- B
Параметр типа для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Опциональное значение, содержащее результат применения оператора reduce
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
Новая последовательность со всеми элементами этой последовательности в обратном порядке.
- Определяющие классы
- SeqOps
def reverseIterator: Iterator[A]
Итератор, возвращающий элементы в обратном порядке.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: xs.reverseIterator то же самое, что и xs.reverse.iterator, но может быть более эффективным.
- returns
итератор, возвращающий элементы этой последовательности в обратном порядке
- Определяющие классы
- SeqOps
def reversed: Iterable[A]
- Атрибуты
- protected
- Определяющие классы
- IterableOnceOps
def sameElements[B >: A](that: IterableOnce[B]): Boolean
Являются ли элементы этой коллекции такими же (и в том же порядке), как и у that?
- Определяющие классы
- LinearSeqOps → 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
коллекция с промежуточными результатами
- Definition Classes
- StrictOptimizedIterableOps → 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
коллекция с промежуточными результатами
- 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, где элемент был бы вставлен, если элемент не в последовательности.
- Definition Classes
- SeqOps
- Примечание
если
to <= from, пространство поиска пусто, и возвращаетсяInsertionPointвfrom- См. также
-
scala.collection.SeqOps, метод
sorted
def search[B >: A](elem: B)(implicit ord: Ordering[B]): SearchResult
Поиск в этой отсортированной последовательности определённого элемента. Если последовательность является IndexedSeq, используется двоичный поиск. В противном случае используется линейный поиск.
Последовательность должна быть отсортирована с использованием того же Ordering перед вызовом; в противном случае результаты не определены.
- elem
элемент, который нужно найти.
- ord
упорядочение, которое используется для сравнения элементов.
- returns
значение
Found, содержащее индекс, соответствующий элементу в последовательности, илиInsertionPoint, где элемент был бы вставлен, если элемент не в последовательности.
- Definition Classes
- SeqOps
- См. также
-
scala.collection.SeqOps, метод
sorted
def segmentLength(p: (A) => Boolean, from: Int): Int
Вычисляет длину самого длинного сегмента, элементы которого удовлетворяют заданному предикату.
Примечание: может не завершиться для коллекций бесконечной длины.
- p
предикат для проверки элементов.
- from
индекс, с которого начинается поиск.
- returns
длина самого длинного сегмента этой последовательности, начинающегося с индекса
from, в котором каждый элемент удовлетворяет предикатуp.
- Definition Classes
- LinearSeqOps → SeqOps
final def segmentLength(p: (A) => Boolean): Int
Вычисляет длину самого длинного сегмента, элементы которого удовлетворяют заданному предикату.
Примечание: может не завершиться для коллекций бесконечной длины.
- p
предикат для проверки элементов.
- returns
длина самого длинного сегмента этой последовательности, в котором каждый элемент удовлетворяет предикату
p.
- Definition Classes
- SeqOps
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
- See also
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
- Annotations
- @inline()
def slice(from: Int, until: Int): C
Выбирает интервал элементов. Возвращаемая итерируемая коллекция состоит из всех элементов x, которые удовлетворяют инварианту:
from <= indexOf(x) < until
Примечание: может возвращать разные результаты для разных запусков, если тип лежащей в основе коллекции не упорядочен.
- from
наименьший индекс для включения из этой итерируемой коллекции.
- until
наименьший индекс для исключения из этой итерируемой коллекции.
- returns
итерируемая коллекция, содержащая элементы, начиная с индекса
from, и до (но не включая) индексаuntilэтой итерируемой коллекции.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода итератор, на котором он был вызван, следует утилизировать, и использовать только возвращённый итератор. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новом итераторе тоже.
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)).
- 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 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
Сортирует эту последовательность в соответствии с упорядочением.
Сортировка стабильна. То есть элементы, которые равны (как определяется 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
- StrictOptimizedIterableOps → 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
Возвращает 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
final def strictOptimizedCollect[B, C2](b: Builder[B, C2], pf: PartialFunction[A, B]): C2
- B
Тип элементов результирующей коллекции (например,
String)- C2
Тип результирующей коллекции (например,
List[String])- b
Библиотека для построения результирующей коллекции
- pf
Частичная функция преобразования элементов
- returns
Результирующая коллекция
- Attributes
- protected[this]
- Definition Classes
- StrictOptimizedIterableOps
- Annotations
- @inline()
final def strictOptimizedConcat[B >: A, C2](that: IterableOnce[B], b: Builder[B, C2]): C2
- B
Тип элементов результирующих коллекций (например,
Int)- C2
Тип результирующей коллекции (например,
List[Int])- that
Элементы для конкатенации с этой коллекцией
- b
Библиотека для построения результирующей коллекции
- returns
Результирующая коллекция
- Attributes
- protected[this]
- Definition Classes
- StrictOptimizedIterableOps
- Annotations
- @inline()
final def strictOptimizedFlatMap[B, C2](b: Builder[B, C2], f: (A) => IterableOnce[B]): C2
- B
Тип элементов результирующего набора (например,
String)- C2
Тип результирующего набора (например,
List[String])- b
Билдэр для создания результирующего набора
- f
Функция преобразования элемента
- returns
Результирующий набор
- Атрибуты
- protected[this]
- Определяющие классы
- StrictOptimizedIterableOps
- Аннотации
- @inline()
final def strictOptimizedFlatten[B, C2](b: Builder[B, C2])(implicit toIterableOnce: (A) => IterableOnce[B]): C2
- B
Тип элементов результирующего набора (например,
Int)- C2
Тип результирующего набора (например,
List[Int])- b
Билдэр для создания результирующего набора
- toIterableOnce
Доказательство, что
Aможет рассматриваться какIterableOnce[B]- returns
Результирующий набор
- Атрибуты
- protected[this]
- Определяющие классы
- StrictOptimizedIterableOps
- Аннотации
- @inline()
final def strictOptimizedMap[B, C2](b: Builder[B, C2], f: (A) => B): C2
- B
Тип элементов результирующего набора (например,
String)- C2
Тип результирующего набора (например,
List[String])- b
Билдэр для создания результирующего набора
- f
Функция преобразования элемента
- returns
Результирующий набор
- Атрибуты
- protected[this]
- Определяющие классы
- StrictOptimizedIterableOps
- Аннотации
- @inline()
final def strictOptimizedZip[B, C2](that: IterableOnce[B], b: Builder[(A, B), C2]): C2
- B
Тип элементов второго набора (например,
String)- C2
Тип результирующего набора (например,
List[(Int, String)])- that
Набор для объединения с этим набором
- b
Билдэр для создания результирующего набора
- returns
Результирующий набор
- Атрибуты
- protected[this]
- Определяющие классы
- StrictOptimizedIterableOps
- Аннотации
- @inline()
def sum[B >: A](implicit num: math.Numeric[B]): B
Суммирует элементы этого набора.
- B
тип результата операции
+.- num
неявный параметр, определяющий набор арифметических операций, включающий операцию
+для вычисления суммы.- returns
сумма всех элементов этого набора относительно операции
+вnum.
- Определяющие классы
- IterableOnceOps
def tail: C
Остальная часть набора без первого элемента.
- Определяющие классы
- IterableOps
def tails: Iterator[C]
Перебирает хвосты этой последовательности. Первое значение — это сама последовательность, последнее — пустая последовательность, промежуточные значения — результаты последовательных применений tail.
- returns
итератор по всем хвостам этой последовательности
- Определяющие классы
- LinearSeqOps → 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
- IterableOps → IterableOnceOps
- Note
Повторное использование: После вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def takeRight(n: Int): C
Коллекция, содержащая последние n элементов этой коллекции.
Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычислены.
- n
количество элементов, которые нужно взять из этого итерируемого набора.
- returns
итерируемый набор, содержащий только последние
nэлементы этого итерируемого набора, или же весь итерируемый набор, если в нём меньшеnэлементов. Еслиnотрицательно, возвращает пустой итерируемый набор.
- Definition Classes
- StrictOptimizedIterableOps → 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
- StrictOptimizedIterableOps → 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
- Exceptions thrown
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
- StrictOptimizedIterableOps → 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
- StrictOptimizedIterableOps → IterableOps
def updated[B >: A](index: Int, elem: B): CC[B]
Копия этого последовательности с одним заменённым элементом.
- B
тип элементов возвращаемой последовательности.
- index
позиция замены
- elem
заменяемый элемент
- returns
новая последовательность, которая является копией этой последовательности с элементом в позиции
indexзаменённым наelem.
- Definition Classes
- SeqOps
- Exceptions thrown
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
- StrictOptimizedIterableOps → 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
- StrictOptimizedIterableOps → 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/StrictOptimizedLinearSeqOps.html