Трейт scala.collection.immutable.LinearSeqOps
Трейт LinearSeqOps[+A, +CC[X] <: LinearSeq[X], +C <: LinearSeq[A] with LinearSeqOps[A, CC, C]] extends SeqOps[A, CC, C] with collection.LinearSeqOps[A, CC, C]
- Источник
- Seq.scala
- Линейные супертипы
- collection.LinearSeqOps[A, CC, C], SeqOps[A, CC, C], collection.SeqOps[A, CC, C], IterableOps[A, CC, C], IterableOnceOps[A, CC, C], IterableOnce[A], Any
- Известные подклассы
- ::, LazyList, LinearSeq, List, Nil, Queue, Cons, Empty, Stream
Абстрактные члены-значения
абстрактный def coll: C
- возвращает
Это коллекция в виде
C.
- Атрибуты
- protected
- Определяющие классы
- IterableOps
абстрактный def fromSpecific(coll: IterableOnce[A]): C
Определяет, как преобразовать заданную Iterable[A] в коллекцию типа C.
Этот процесс может быть выполнен строго или нестрого (т.е. без оценки элементов результирующих коллекций). Другими словами, этот метод определяет модель оценки коллекции.
- Атрибуты
- protected
- Определяющие классы
- IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, смешав в себе IterableFactoryDefaults, который реализует метод с использованием iterableFactory.Как показано аннотацией
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, при условии, что он вызывается сIterable[A]полученной от коллекцииthis(как это происходит в реализации операций, где мы используемView[A]), он безопасен.
абстрактный def getClass(): Class[_ <: AnyRef]
Возвращает представление класса объекта во время выполнения.
- возвращает
объект класса, соответствующий типу получателя во время выполнения.
- Определяющие классы
- Any
абстрактный def iterableFactory: IterableFactory[CC]
Объект-компаньон этой итерируемой коллекции, предоставляющий различные методы фабрики.
- Определяющие классы
- IterableOps
- Примечание
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (в противном случае компилятор выдаст ошибку).
абстрактный def newSpecificBuilder: Builder[A, C]
- возвращает
строгий билдер для того же типа коллекции. Обратите внимание, что в случае ленивых коллекций (например, View или immutable.LazyList), реализация этого метода возможна, но полученный
Builderнарушит ленивость. Вследствие этого, операции предпочтительно реализовывать сfromSpecificвместо этого метода.
- Атрибуты
- protected
- Определяющие классы
- IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, смешав в себе IterableFactoryDefaults , который реализует метод с использованием iterableFactory.Как показано аннотацией
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, если возвращаемый билдер используется только сAзначениями, взятыми от экземпляраthis, он безопасен.
абстрактный def toIterable: collection.Iterable[A]
- возвращает
Эта коллекция в виде
Iterable[A]. Новая коллекция не будет создана, еслиthisуже являетсяIterable[A].
- Определяющие классы
- IterableOps
Члены конкретных значений
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- returns
trueесли !(this == that), иначе false.
- Definition Classes
- Any
final def ##(): Int
Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для чисел он возвращает значение хэша, согласованное с равенством значений: если два экземпляра типов значений сравниваются как true, то ## будет генерировать одинаковое значение хэша для каждого из них. Для null возвращает хэш-код, где null.hashCode выбрасывает NullPointerException.
- returns
значение хэша, согласованное с ==
- Definition Classes
- Any
def +(other: String): String
- Неявный
- Этот член добавлен неявным преобразованием из LinearSeqOps[A, CC, C] вany2stringadd[LinearSeqOps[A, CC, C]] с помощью метода any2stringadd в scala.Predef.
- Definition Classes
- any2stringadd
final def ++[B >: A](suffix: IterableOnce[B]): CC[B]
Псевдоним для concat
- Definition Classes
- IterableOps
- Annotations
- @inline()
final def ++:[B >: A](prefix: IterableOnce[B]): CC[B]
Псевдоним для prependedAll
- Definition Classes
- SeqOps → IterableOps
- Annotations
- @inline()
final def +:[B >: A](elem: B): CC[B]
Псевдоним для prepended.
Обратите внимание, что операторы с окончанием - являются правоассоциативными (см. пример). Мемоническое правило для +: против :+ такое: двоеточие ставится со стороны коллекции.
def ->[B](y: B): (LinearSeqOps[A, CC, C], B)
- Неявный
- Этот член добавлен неявным преобразованием из LinearSeqOps[A, CC, C] вArrowAssoc[LinearSeqOps[A, CC, C]] с помощью метода ArrowAssoc в scala.Predef.
- Definition Classes
- ArrowAssoc
- Annotations
- @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.
- Определяющие классы
- SeqOps
def appendedAll[B >: A](suffix: IterableOnce[B]): CC[B]
Возвращает новую последовательность, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элемента последовательности является наиболее специфическим суперклассом, охватывающим типы элементов двух операндов.
- B
тип элемента возвращаемой коллекции.
- suffix
итерируемый объект для добавления.
- возвращает
новая коллекция типа
CC[B], которая содержит все элементы этой последовательности, за которыми следуют все элементыsuffix.
- Определяющие классы
- 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
- Исключения
ClassCastException, если объект-получатель не является экземпляром стираемого типаT0.
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
значение опционального типа, содержащее результат применения 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
true, если в этой последовательности есть элемент, равный (как определяется==)elem,falseв противном случае.
- Definition Classes
- LinearSeqOps → SeqOps
def containsSlice[B](that: collection.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: collection.Seq[B])(p: (A, B) => Boolean): Boolean
Проверяет, связаны ли каждый элемент этой последовательности и соответствующий элемент другой последовательности с помощью предиката проверки.
- B
тип элементов
that- that
другая последовательность
- p
предикат проверки, который связывает элементы из обеих последовательностей
- returns
trueесли обе последовательности имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтой последовательности иyизthat, иначе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изthat, иначеfalse
- Definition Classes
- IterableOnceOps
def count(p: (A) => Boolean): Int
Подсчитывает количество элементов в коллекции, которые удовлетворяют предикату.
- p
предикат, используемый для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Definition Classes
- IterableOnceOps
def diff[B >: A](that: collection.Seq[B]): C
Вычисляет разность мультисетов между этой последовательностью и другой последовательностью.
- that
последовательность элементов для удаления
- returns
новая последовательность, которая содержит все элементы этой последовательности, за исключением некоторых вхождений элементов, которые также присутствуют в
that. Если значение элементаxвстречается n раз вthat, то первые n вхожденияxне будут включены в результат, но любые последующие вхождения будут.
- Definition Classes
- SeqOps
def distinct: C
Выбирает все элементы этой последовательности, игнорируя дубликаты.
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
- Definition Classes
- SeqOps
def distinctBy[B](f: (A) => B): C
Выбирает все элементы этой последовательности, игнорируя дубликаты, как определено ==, после применения преобразующей функции f.
- B
тип элементов после преобразования
f- f
Преобразующая функция, результат которой используется для определения уникальности каждого элемента
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
- Definition Classes
- SeqOps
def drop(n: Int): C
Выбирает все элементы, кроме первых n.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- n
количество элементов для удаления из этой итерируемой коллекции.
- returns
итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, за исключением первых
nэлементов, или пустая итерируемая коллекция, если эта итерируемая коллекция содержит меньшеnэлементов. Еслиnотрицательное, не удаляйте никаких элементов.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def dropRight(n: Int): C
Выбирает все элементы, кроме последних n.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- n
количество элементов для удаления из этой итерируемой коллекции.
- returns
итерируемая коллекция, состоящая из всех элементов этой итерируемой коллекции, за исключением последних
nэлементов, или пустая итерируемая коллекция, если эта итерируемая коллекция содержит меньшеnэлементов. Еслиnотрицательное, не удаляйте никаких элементов.
- Definition Classes
- IterableOps
def dropWhile(p: (A) => Boolean): C
Удаляет самый длинный префикс элементов, которые удовлетворяют предикату.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- p
Предикат, используемый для проверки элементов.
- returns
самый длинный суффикс этой итерируемой коллекции, первый элемент которого не удовлетворяет предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def empty: C
Пустая итерируемая коллекция того же типа, что и эта итерируемая коллекция
- returns
пустая итерируемая коллекция типа
C.
- Definition Classes
- IterableOps
def endsWith[B >: A](that: collection.Iterable[B]): Boolean
Проверяет, заканчивается ли эта последовательность данной последовательностью.
Примечание: не будет завершаться для коллекций бесконечного размера.
- that
последовательность для проверки
- returns
trueесли эта последовательность имеетthatв качестве суффикса,falseв противном случае.
- Definition Classes
- SeqOps
def ensuring(cond: (LinearSeqOps[A, CC, C]) => Boolean, msg: => Any): LinearSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из LinearSeqOps[A, CC, C] в Ensuring[LinearSeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: (LinearSeqOps[A, CC, C]) => Boolean): LinearSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из LinearSeqOps[A, CC, C] в Ensuring[LinearSeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean, msg: => Any): LinearSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из LinearSeqOps[A, CC, C] в Ensuring[LinearSeqOps[A, CC, C]] с помощью метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean): LinearSeqOps[A, CC, C]
- Неявный
- Этот член добавлен неявным преобразованием из LinearSeqOps[A, CC, C] в Ensuring[LinearSeqOps[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
предикат, используемый для проверки элементов.
- returns
trueесли заданный предикатpудовлетворяется хотя бы одним элементом этой последовательности, в противном случаеfalse
- Definition Classes
- LinearSeqOps → 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 find(p: (A) => Boolean): Option[A]
Находит первый элемент последовательности, удовлетворяющий предикату, если таковой имеется.
Примечание: может не завершиться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
значение типа Option, содержащее первый элемент в последовательности, который удовлетворяет
p, илиNoneесли такового нет.
- Definition Classes
- LinearSeqOps → IterableOnceOps
def findLast(p: (A) => Boolean): Option[A]
Находит последний элемент последовательности, удовлетворяющий предикату, если таковой имеется.
Примечание: не завершится для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
значение типа Option, содержащее последний элемент в последовательности, который удовлетворяет
p, илиNoneесли такового нет.
- Definition Classes
- 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к каждому элементу этой итерируемой коллекции и конкатенации результатов.
- 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, если эта последовательность пуста.
- Определяющие классы
- 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).
- Неявное
- Этот член добавляется неявным преобразованием из LinearSeqOps[A, CC, C] в StringFormat[LinearSeqOps[A, CC, C]] с помощью метода StringFormat в scala.Predef.
- Определяющие классы
- StringFormat
- Аннотации
- @inline()
def groupBy[K](f: (A) => K): 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): 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): 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, за исключением последней, которая будет меньше sizesizeесли элементы не делятся на размер группы без остатка.
- Definition Classes
- IterableOps
- See also
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
значение хэш-кода для этого объекта.
- Definition Classes
- Any
def head: A
Выбирает первый элемент этой итерируемой коллекции.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции.
- Definition Classes
- IterableOps
- Exceptions thrown
NoSuchElementException, если итерируемая коллекция пуста.
def headOption: Option[A]
Возвращает опциональное значение первого элемента.
- returns
первый элемент этой последовательности, если она не пуста,
Noneесли она пуста.
- Definition Classes
- 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: 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, 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: 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(x: Int): Boolean
Проверяет, содержит ли эта последовательность данный индекс.
Реализации методов apply и isDefinedAt преобразуют Seq[A] в PartialFunction[Int, A].
- returns
trueесли эта последовательность содержит элемент в позицииidx,falseв противном случае.
- Definition Classes
- LinearSeqOps → 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
Проверяет, может ли этот итерируемый набор быть многократно итерирован. Всегда истинно для итерируемых наборов и ложно для итераторов, если не переопределено.
- returns
trueесли итерация может быть многократной,falseв противном случае.
- Definition Classes
- IterableOps → IterableOnceOps
def iterator: Iterator[A]
Итератор может быть использован только один раз
- Definition Classes
- LinearSeqOps → IterableOnce
def knownSize: Int
- returns
Количество элементов в этом наборе, если его можно вычислить без затрат, иначе -1. Без затрат обычно означает: не требует обхода набора.
- Definition Classes
- IterableOnce
def last: A
Выбирает последний элемент.
- returns
Последний элемент этой последовательности.
- Definition Classes
- LinearSeqOps → 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, 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: 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.
- Определяющие классы
- 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
Возвращает класс значения, содержащий операции для сравнения длины этой последовательности с тестовым значением.
Эти операции реализованы на основе 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
функция, применяемая к каждому элементу.
- возвращает
новую итерируемую коллекцию, полученную в результате применения данной функции
fк каждому элементу этой итерируемой коллекции и сбора результатов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def max[B >: A](implicit ord: math.Ordering[B]): A
Находит наибольший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- возвращает
наибольший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def maxBy[B](f: (A) => B)(implicit cmp: math.Ordering[B]): A
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Измерительная функция.
- cmp
Порядок, используемый для сравнения элементов.
- возвращает
первый элемент этой коллекции с наибольшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def maxByOption[B](f: (A) => B)(implicit cmp: math.Ordering[B]): Option[A]
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Измерительная функция.
- cmp
Порядок, используемый для сравнения элементов.
- возвращает
необязательное значение, содержащее первый элемент этой коллекции с наибольшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
def maxOption[B >: A](implicit ord: math.Ordering[B]): Option[A]
Находит наибольший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- возвращает
необязательное значение, содержащее наибольший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
def min[B >: A](implicit ord: math.Ordering[B]): A
Находит наименьший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- возвращает
наименьший элемент этой коллекции относительно порядка
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)"
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: collection.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
- 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
- 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
Результат применения оператора свертки
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в противном случае.
- Definition Classes
- IterableOnceOps
def reduceOption[B >: A](op: (B, B) => B): Option[B]
Сводит элементы этой коллекции, если таковые имеются, используя указанный ассоциативный бинарный оператор.
Порядок, в котором выполняются операции над элементами, не указан и может быть недетерминированным.
- B
Типовой параметр для бинарного оператора, надтип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Необязательное значение, содержащее результат применения оператора свертки
opко всем элементам, если коллекция не пуста, и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
- Исключения
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
- SeqOps
def reverseIterator: Iterator[A]
Итератор, возвращающий элементы в обратном порядке.
Примечание: не будет завершаться для наборов бесконечного размера.
Примечание: xs.reverseIterator эквивалентно xs.reverse.iterator, но может быть более эффективным.
- returns
итератор, возвращающий элементы этого набора в обратном порядке
- Definition Classes
- SeqOps
def reversed: collection.Iterable[A]
- Attributes
- protected
- Definition Classes
- IterableOnceOps
def sameElements[B >: A](that: IterableOnce[B]): Boolean
Являются ли элементы этого набора такими же (и в таком же порядке), как и элементы that?
- Definition Classes
- 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
- 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
- Note
если
to <= from, область поиска пуста, и возвращаетсяInsertionPointвfrom- See also
-
scala.collection.SeqOps, метод
sorted
def search[B >: A](elem: B)(implicit ord: Ordering[B]): SearchResult
Поиск этого отсортированного последовательности заданного элемента. Если последовательность является IndexedSeq, используется двоичный поиск. В противном случае используется линейный поиск.
Последовательность должна быть отсортирована с использованием того же Ordering перед вызовом; в противном случае результаты не определены.
- elem
элемент для поиска.
- ord
упорядочение, используемое для сравнения элементов.
- returns
значение
Found, содержащее индекс, соответствующий элементу в последовательности, илиInsertionPoint, где элемент был бы вставлен, если элемент отсутствует в последовательности.
- Definition Classes
- SeqOps
- See also
-
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: collection.Iterable[_]): Int
Сравнивает размер этой последовательности с размером другой Iterable.
- that
the
Iterableразмер которой сравнивается с размером этой последовательности.- returns
-
Значение
xгдеx < 0 if this.size < that.size x == 0 if this.size == that.size x > 0 if this.size > that.size
Реализация этого метода не вызывает
sizeнапрямую; его время выполнения составляетO(this.size min that.size)вместоO(this.size + that.size). Метод следует переопределять, если вычислениеsizeявляется быстрым, иknownSizeвозвращает-1.
- Definition Classes
- SeqOps → IterableOps
final def sizeCompare(otherSize: Int): Int
Сравнивает размер этой последовательности со значением-эталоном.
- otherSize
значение-эталон, которое сравнивается с размером.
- returns
-
Значение
xгдеx < 0 if this.size < otherSize x == 0 if this.size == otherSize x > 0 if this.size > otherSize
Реализация этого метода не вызывает
sizeнапрямую; его время выполнения составляетO(size min otherSize)вместоO(size). Метод следует переопределять, если вычислениеsizeявляется быстрым, иknownSizeвозвращает-1.
- Definition Classes
- SeqOps → IterableOps
- См. также
final def sizeIs: SizeCompareOps
Возвращает объект-значение, содержащий операции для сравнения размера этой итерируемой коллекции со значением-эталоном.
Эти операции реализованы через sizeCompare(Int), и позволяют использовать следующие более читаемые конструкции:
this.sizeIs < size // this.sizeCompare(size) < 0 this.sizeIs <= size // this.sizeCompare(size) <= 0 this.sizeIs == size // this.sizeCompare(size) == 0 this.sizeIs != size // this.sizeCompare(size) != 0 this.sizeIs >= size // this.sizeCompare(size) >= 0 this.sizeIs > size // this.sizeCompare(size) > 0
- Definition Classes
- IterableOps
- Аннотации
- @inline()
def slice(from: Int, until: Int): C
Выбирает интервал элементов. Полученная итерируемая коллекция состоит из всех элементов x которые удовлетворяют условию:
from <= indexOf(x) < until
Примечание: результаты могут отличаться при разных запусках, если тип базовой коллекции не упорядочен.
- from
наименьший индекс для включения из этой итерируемой коллекции.
- until
наименьший индекс для исключения из этой итерируемой коллекции.
- returns
итерируемая коллекция, содержащая элементы, начиная с индекса
fromи до (но не включая) индексаuntilэтой итерируемой коллекции.
- Definition Classes
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода следует отказаться от использованного итератора и использовать только возвращённый итератор. Использование старого итератора неопределённо, может быть изменено, и может привести к изменениям в новом итераторе также.
def sliding(size: Int, step: Int): Iterator[C]
Группирует элементы в блоки фиксированного размера, перемещая «скользящее окно» над ними (в отличие от разбиения, как в grouped.)
- size
количество элементов в группе
- step
расстояние между первыми элементами последовательных групп
- returns
Итератор, генерирующий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным), который будет усечен, если оставшихся элементов для группировки меньшеsize.
- Definition Classes
- IterableOps
- См. также
scala.collection.Iterator, метод
sliding
def sliding(size: Int): Iterator[C]
Группирует элементы в блоки фиксированного размера, перемещая «скользящее окно» над ними (в отличие от разбиения, как в grouped). Шаг «скользящего окна» установлен в единицу.
- size
количество элементов в группе
- returns
Итератор, генерирующий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным), который будет усечен, если оставшихся элементов для группировки меньшеsize.
- Definition Classes
- IterableOps
- См. также
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
- См. также
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
Сортирует эту последовательность в соответствии с Ordering.
Сортировка стабильна. То есть элементы, которые равны (как определено функцией ord.compare), появляются в отсортированной последовательности в том же порядке, что и в исходной.
- ord
упорядочение, используемое для сравнения элементов.
- returns
последовательность, состоящая из элементов этой последовательности, отсортированных в соответствии с порядком
ord.
- Definition Classes
- SeqOps
- См. также
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
- Примечание
Переиспользование: После вызова этого метода, следует отбросить итератор, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новых итераторах также.
def splitAt(n: Int): (C, C)
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в заданной позиции.
Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).
Примечание: может возвращать разные результаты при разных запусках, если тип подлежащей коллекции не упорядочен.
- n
позиция разделения.
- returns
пара итерируемых коллекций, состоящая из первых
nэлементов этой итерируемой коллекции, и других элементов.
- Definition Classes
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода, следует отбросить итератор, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора неопределено, может быть изменено и может привести к изменениям в новых итераторах также.
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. Для Steppers, помеченных scala.collection.Stepper.EfficientSplit, конвертеры в scala.jdk.StreamConverters позволяют создавать параллельные потоки, тогда как обычные Steppers могут быть преобразованы только в последовательные потоки.
- Definition Classes
- IterableOnce
def sum[B >: A](implicit num: math.Numeric[B]): B
Суммирует элементы этой коллекции.
- B
тип результата оператора
+.- num
неявный параметр, определяющий набор арифметических операций, включающий оператор
+, используемый для вычисления суммы.- returns
сумма всех элементов этой коллекции относительно оператора
+вnum.
- Definition Classes
- IterableOnceOps
def tail: C
Остаток коллекции без первого элемента.
- Definition Classes
- IterableOps
def tails: Iterator[C]
Итерирует по хвостам этой последовательности. Первое значение будет этой последовательностью, а последнее — пустой последовательностью, промежуточные значения — результаты последовательных применений tail.
- returns
итератор по всем хвостам этой последовательности
- Definition Classes
- 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
- Примечание
Переиспользование: После вызова этого метода нужно выбросить итератор, на котором он был вызван, и использовать только тот итератор, который был возвращен. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def takeRight(n: Int): C
Выбирает последние n элементов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- n
количество элементов, которые нужно взять из этой итерируемой коллекции.
- returns
итерируемая коллекция, содержащая только последние
nэлементов этой итерируемой коллекции, или же вся итерируемая коллекция, если в ней меньшеnэлементов. Еслиnотрицательно, возвращается пустая итерируемая коллекция.
- Definition Classes
- IterableOps
def takeWhile(p: (A) => Boolean): C
Берет самую длинную префиксную часть элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- p
Предикат для проверки элементов.
- returns
самый длинный префикс этой итерируемой коллекции, элементы которой удовлетворяют предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
def tapEach[U](f: (A) => U): C
Применяет функцию с побочным эффектом к каждому элементу в этом наборе. Строгие наборы применят f к своим элементам немедленно, в то время как ленивые наборы, такие как представления и LazyLists, будут применять f к каждому элементу только тогда, когда этот элемент оценивается, и каждый раз, когда этот элемент оценивается.
- U
тип возвращаемого значения f
- f
функция для применения к каждому элементу в этом итерируемом наборе
- возвращает
То же логическое множество, что и это
- Определяющие классы
- IterableOps → IterableOnceOps
def to[C1](factory: Factory[A, C1]): C1
Используя фабрику наборов factory, преобразовать этот набор в соответствующее представление для текущего типа элемента A. Примеры использования:
xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]
- Определяющие классы
- IterableOnceOps
def toArray[B >: A](implicit arg0: ClassTag[B]): Array[B]
Преобразовать набор в массив.
- Определяющие классы
- IterableOnceOps
final def toBuffer[B >: A]: Buffer[B]
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
def toIndexedSeq: IndexedSeq[A]
- Определяющие классы
- IterableOnceOps
def toList: List[A]
- Определяющие классы
- IterableOnceOps
def toMap[K, V](implicit ev: <:<[A, (K, V)]): Map[K, V]
- Определяющие классы
- IterableOnceOps
def toSeq: Seq[A]
- возвращает
Этот набор как
Seq[A]. Это эквивалентноto(Seq), но может быть быстрее.
- Определяющие классы
- IterableOnceOps
def toSet[B >: A]: Set[B]
- Определяющие классы
- IterableOnceOps
def toString(): String
Возвращает строковое представление объекта.
По умолчанию представление зависит от платформы.
- возвращает
строковое представление объекта.
- Определяющие классы
- Any
def toVector: 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.- returns
двумерное итерируемое множество итерируемых множеств, в котором n-я строка содержит n-й столбец этого итерируемого множества.
- Definition Classes
- IterableOps
- Исключения
IllegalArgumentException, если все множества в этом итерируемом множестве не имеют одинаковый размер.
def unzip[A1, A2](implicit asPair: (A) => (A1, A2)): (CC[A1], CC[A2])
Преобразует это итерируемое множество пар в два множества первой и второй половины каждой пары.
val xs = Iterable(
(1, "one"),
(2, "two"),
(3, "three")).unzip
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three))
- A1
тип первой половины пар элементов
- A2
тип второй половины пар элементов
- asPair
явное преобразование, которое утверждает, что тип элементов этого итерируемого множества является парой.
- returns
пара итерируемых множеств, содержащая первую и соответственно вторую половину каждой пары элементов этого итерируемого множества.
- Definition Classes
- IterableOps
def unzip3[A1, A2, A3](implicit asTriple: (A) => (A1, A2, A3)): (CC[A1], CC[A2], CC[A3])
Преобразует это итерируемое множество троек в три множества первого, второго и третьего элемента каждой тройки.
val xs = Iterable(
(1, "one", '1'),
(2, "two", '2'),
(3, "three", '3')).unzip3
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three),
// Iterable(1, 2, 3))
- A1
тип первого члена троек элементов
- A2
тип второго члена троек элементов
- A3
тип третьего члена троек элементов
- asTriple
явное преобразование, которое утверждает, что тип элементов этого итерируемого множества является тройкой.
- returns
тройку итерируемых множеств, содержащую первый, второй, соответственно третий член каждой тройки элементов этого итерируемого множества.
- Definition Classes
- IterableOps
def updated[B >: A](index: Int, elem: B): CC[B]
Копия этого последовательности с одним замененным элементом.
- B
тип элементов возвращаемой последовательности.
- index
позиция замены
- elem
элемент замены
- returns
новая последовательность, являющаяся копией этой последовательности с элементом в позиции
indexзамененным наelem.
- Definition Classes
- SeqOps
- Исключения
IndexOutOfBoundsException, еслиindexне удовлетворяет0 <= index < length. В случае ленивого множества это исключение может быть выброшено позже или вообще не выброшено (если конец множества никогда не оценивается).
def view: SeqView[A]
Представление элементов этого множества.
- Definition Classes
- SeqOps → IterableOps
def withFilter(p: (A) => Boolean): WithFilter[A, CC]
Создает нестрогий фильтр этого итерируемого множества.
Примечание: Разница между c filter p и c withFilter p заключается в том, что первый создает новое множество, а второй только ограничивает область действия последующих map, flatMap, foreach, и withFilter операций.
Примечание: Может возвращать разные результаты при разных запусках, если тип базового множества не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
объект класса
WithFilter, который поддерживаетmap,flatMap,foreach, иwithFilterоперации. Все эти операции применяются к тем элементам этого итерируемого множества, которые удовлетворяют предикатуp.
- Definition Classes
- IterableOps
def zip[B](that: IterableOnce[B]): CC[(A, B)]
Возвращает итерируемую коллекцию, сформированную из этой итерируемой коллекции и другой итерируемой коллекции путём объединения соответствующих элементов попарно. Если одна из двух коллекций длиннее другой, её оставшиеся элементы игнорируются.
- B
тип второй половины возвращаемых пар
- that
Итерируемый объект, предоставляющий вторую половину каждой пары результата
- returns
новая итерируемая коллекция, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции и
that. Длина возвращаемой коллекции равна минимальному из длин этой итерируемой коллекции иthat.
- Definition Classes
- IterableOps
def zipAll[A1 >: A, B](that: 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.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода нужно удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределённо, может быть изменено и может привести к изменениям в новом итераторе также.
List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))
© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.13.0/scala/collection/immutable/LinearSeqOps.html