Трейт scala.collection.mutable.IndexedSeq
Компаньон объект IndexedSeq
трейт IndexedSeq[T] extends Seq[T] with collection.IndexedSeq[T] with IndexedSeqOps[T, IndexedSeq, IndexedSeq[T]] with IterableFactoryDefaults[T, IndexedSeq]
- Источник
- IndexedSeq.scala
- Линейные супертипы
- IndexedSeqOps[T, IndexedSeq, IndexedSeq[T]], collection.IndexedSeq[T], collection.IndexedSeqOps[T, [_]IndexedSeq[_], IndexedSeq[T]], Seq[T], SeqOps[T, [_]IndexedSeq[_], IndexedSeq[T]], Cloneable[IndexedSeq[T]], java.lang.Cloneable, collection.Seq[T], Equals, collection.SeqOps[T, [_]IndexedSeq[_], IndexedSeq[T]], PartialFunction[Int, T], (Int) => T, Iterable[T], collection.Iterable[T], IterableFactoryDefaults[T, [x]IndexedSeq[x]], IterableOps[T, [_]IndexedSeq[_], IndexedSeq[T]], IterableOnceOps[T, [_]IndexedSeq[
- _], IndexedSeq[T]], IterableOnce[T], AnyRef, Any
- Известные подклассы
- ArrayBuffer, ArrayDeque, ArraySeq, ofBoolean, ofByte, ofChar, ofDouble, ofFloat, ofInt, ofLong, ofRef, ofShort, ofUnit, IndexedBuffer, Очередь, Стек, StringBuilder
Члены с абстрактными значениями
abstract def apply(i: Int): T
Получение элемента по указанному индексу. Эта операция предоставляется для удобства в Seq. Не следует предполагать ее эффективность, если у вас нет IndexedSeq.
abstract def length: Int
Длина (количество элементов) последовательности. size является псевдонимом для length в коллекциях Seq.
- Definition Classes
- SeqOps
abstract def update(idx: Int, elem: T): Unit
Заменяет элемент по заданному индексу новым значением.
- idx
индекс элемента для замены.
- elem
новое значение.
- Definition Classes
- SeqOps
- Annotations
- @throws(scala.this.throws.<init>$default$1[IndexOutOfBoundsException])
- Exceptions thrown
IndexOutOfBoundsException, если индекс некорректен.
Члены-значения конкретного типа
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- returns
trueесли !(this == that), иначе false.
- Definition Classes
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode, за исключением упакованных числовых типов и null. Для числовых типов возвращает хеш-значение, соответствующее равенству значений: если две экземпляры типа значения сравниваются как true, то ## вернёт одинаковое хеш-значение для каждой из них. Для null возвращает хеш-код, где null.hashCode вызывает NullPointerException.
- returns
хеш-значение, соответствующее ==
- Definition Classes
- AnyRef → Any
def +(other: String): String
- Неявный
- Этот член добавляется неявным преобразованием из IndexedSeq[T] вany2stringadd[IndexedSeq[T]] выполняемым методом any2stringadd в scala.Predef.
- Definition Classes
- any2stringadd
final def ++[B >: T](suffix: IterableOnce[B]): IndexedSeq[B]
Псевдоним для concat
- Definition Classes
- IterableOps
- Annotations
- @inline()
final def ++:[B >: T](prefix: IterableOnce[B]): IndexedSeq[B]
Псевдоним для prependedAll
- Классы определений
- SeqOps → IterableOps
- Аннотации
- @inline()
final def +:[B >: T](elem: B): IndexedSeq[B]
Псевдоним для prepended.
Обратите внимание, что операторы с окончанием :- являются правоассоциативными (см. пример). Мнемоника для +: по сравнению с :+: двоеточие ставится со стороны коллекции.
def ->[B](y: B): (IndexedSeq[T], B)
- Неявный
- Этот член добавляется с помощью неявного преобразования из IndexedSeq[T] в ArrowAssoc[IndexedSeq[T]] выполняемого методом ArrowAssoc в scala.Predef.Это преобразование будет выполняться только в том случае, если T является подклассом Option[Nothing] (T <: Option[Nothing]).
- Классы определений
- ArrowAssoc
- Аннотации
- @inline()
final def :+[B >: T](elem: B): IndexedSeq[B]
final def :++[B >: T](suffix: IterableOnce[B]): IndexedSeq[B]
final def ==(arg0: Any): Boolean
Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- returns
true, если объект-получатель эквивалентен аргументу;falseв противном случае.
- Definition Classes
- AnyRef → Any
final def addString(b: StringBuilder): StringBuilder
Добавляет все элементы этой коллекции в строковый буфер. Записанный текст состоит из строковых представлений (в соответствии с методом toString) всех элементов этой коллекции без разделительной строки.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> val h = a.addString(b) h: StringBuilder = 1234
- b
строковый буфер, в который добавляются элементы.
- returns
строковый буфер
b, в который были добавлены элементы.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
final def addString(b: StringBuilder, sep: String): StringBuilder
Добавляет все элементы этой коллекции в строковый буфер с использованием разделительной строки. Записанный текст состоит из строковых представлений (в соответствии с методом toString) всех элементов этой коллекции, разделенных строкой sep.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> a.addString(b, ", ") res0: StringBuilder = 1, 2, 3, 4
- b
строковый буфер, в который добавляются элементы.
- sep
разделительная строка.
- returns
строковый буфер
b, в который были добавлены элементы.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
def addString(b: StringBuilder, start: String, sep: String, end: String): StringBuilder
Добавляет все элементы этого набора в строку-построитель с использованием начальной, конечной и разделительных строк. Текст начинается со строки start и заканчивается строкой end. Внутри, строковые представления (согласно методу toString) всех элементов этого набора разделяются строкой sep.
Пример:
scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)
scala> val b = new StringBuilder()
b: StringBuilder =
scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
- b
строка-построитель, в которую добавляются элементы.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
строка-построитель
b, в которую были добавлены элементы.
- Definition Classes
- IterableOnceOps
def andThen[C](k: PartialFunction[T, C]): PartialFunction[Int, C]
Компонует эту частичную функцию с другой частичной функцией, которая применяется к результатам этой частичной функции.
Обратите внимание, что вызов isDefinedAt для полученной частичной функции может применить первую частичную функцию и выполнить её побочный эффект. Настоятельно рекомендуется использовать applyOrElse вместо isDefinedAt / apply для повышения эффективности.
- C
тип результата функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения этой частичной функции, суженной другой частичной функцией, которая отображает аргументы
xвk(this(x)).
- Definition Classes
- PartialFunction
def andThen[C](k: (T) => C): PartialFunction[Int, C]
Объединяет эту частичную функцию с функцией преобразования, которая применяется к результатам этой частичной функции.
Если тип функции в ходе выполнения - это PartialFunction, то используется другой метод andThen (обратите внимание на его предосторожности).
- C
тип результата функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения этой частичной функции, возможно суженной указанной функцией, которая отображает аргументы
xвk(this(x)).
- Definition Classes
- PartialFunction → Function1
def appended[B >: T](elem: B): IndexedSeq[B]
Копия этой последовательности с добавленным элементом.
Примечание: не завершится для коллекций бесконечного размера.
Пример:
scala> val a = List(1) a: List[Int] = List(1) scala> val b = a :+ 2 b: List[Int] = List(1, 2) scala> println(a) List(1)
- B
тип элементов возвращаемой последовательности.
- elem
добавляемый элемент
- returns
новая последовательность, состоящая из всех элементов этой последовательности, после которых идёт
value.
- Definition Classes
- SeqOps
def appendedAll[B >: T](suffix: IterableOnce[B]): IndexedSeq[B]
Возвращает новую последовательность, содержащую элементы левого операнда, за которыми следуют элементы правого операнда. Тип элемента последовательности — это наиболее специфический суперкласс, охватывающий типы элементов двух операндов.
- B
тип элемента возвращаемой коллекции.
- suffix
перечисляемый для добавления.
- returns
новая коллекция типа
CC[B], содержащая все элементы этой последовательности, за которыми следуют все элементыsuffix.
- Definition Classes
- SeqOps
def applyOrElse[A1 <: Int, B1 >: T](x: A1, default: (A1) => B1): B1
Применяет эту частичную функцию к заданному аргументу, если он содержится в области определения функции. Применяет функцию по умолчанию, если эта частичная функция не определена.
Обратите внимание, что выражение pf.applyOrElse(x, default) эквивалентно
if(pf isDefinedAt x) pf(x) else default(x)
за исключением того, что метод applyOrElse может быть реализован более эффективно. Для всех частичных функций-литералов компилятор генерирует реализацию applyOrElse, которая избегает двойной оценки соответствия шаблонов и условий. Это делает applyOrElse основой для эффективной реализации во многих операциях и сценариях, таких как:
-
соединение частичных функций в цепочки
orElse/andThen не приводит к чрезмерной оценке apply/isDefinedAt
lift и unlift не оценивают исходные функции дважды при каждом вызове
runWith позволяет эффективно комбинировать частичные функции в стиле императива с условными действиями Для нелитеральных классов частичных функций с ненулевым методом isDefinedAt рекомендуется переопределить метод applyOrElse с пользовательской реализацией, которая избегает двойной оценки isDefinedAt. Это может привести к лучшей производительности и более предсказуемому поведению в отношении побочных эффектов.
- x
аргумент функции
- default
функция по умолчанию
- returns
результат применения этой функции или функции по умолчанию.
- Definition Classes
- PartialFunction
- Since
2.10
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 canEqual(that: Any): Boolean
Метод, вызываемый из методов равенства, чтобы пользовательские подклассы могли отказываться от равенства с другими коллекциями того же типа.
- that
Объект, с которым должна быть сравнена эта последовательность
- returns
true, если эта последовательность может быть равнаthat,falseв противном случае. Проверка учитывает только типы объектов во время выполнения, но игнорирует их элементы.
def charAt(index: Int): Char
- Неявный
- Этот член добавлен неявным преобразованием из IndexedSeq[T] в SeqCharSequence, выполненным методом SeqCharSequence в scala.Predef.Это преобразование произойдёт только если T является подклассом Char (T <: Char).
- Определяющие классы
- SeqCharSequence → CharSequence
def chars(): IntStream
- Неявный
- Этот член добавлен неявным преобразованием из IndexedSeq[T] в SeqCharSequence, выполненным методом SeqCharSequence в scala.Predef.Это преобразование произойдёт только если T является подклассом Char (T <: Char).
- Определяющие классы
- CharSequence
def className: String
Определяет префикс представления этого объекта.
Рекомендуется возвращать имя конкретного типа коллекции, но не подклассы реализации. Например, для ListMap этот метод должен возвращать "ListMap", а не "Map" (супертип) или "Node" (подкласс реализации).
По умолчанию реализация возвращает "Iterable". Она переопределена для основных типов коллекций "Seq", "IndexedSeq", "LinearSeq", "Buffer", "Set", "Map", "SortedSet", "SortedMap" и "View".
- возвращает
строковое представление, которое начинается с результата
toString, применённого к этой коллекции. По умолчанию префикс строки — простое имя класса коллекции.
- Атрибуты
- protected[this]
- Определяющие классы
- Iterable
def clone(): IndexedSeq[T]
Создаёт копию объекта-получателя.
По умолчанию реализация метода clone зависит от платформы.
- возвращает
копию объекта-получателя.
def codePoints(): IntStream
- Неявное
- Этот член добавлен неявным преобразованием из IndexedSeq[T] в SeqCharSequence, выполненным методом SeqCharSequence в scala.Predef. Это преобразование произойдёт только если T является подклассом Char (T <: Char).
- Классы определения
- CharSequence
final def coll: IndexedSeq.this.type
- возвращает
Это коллекция в виде
C.
- Атрибуты
- protected
- Классы определения
- Iterable → IterableOps
def collect[B](pf: PartialFunction[T, B]): IndexedSeq[B]
Создаёт новую итерируемую коллекцию, применяя частичную функцию ко всем элементам этой итерируемой коллекции, для которых функция определена.
- B
тип элементов возвращаемой итерируемой коллекции.
- pf
частичная функция, которая фильтрует и отображает итерируемую коллекцию.
- возвращает
новая итерируемая коллекция, полученная путём применения данной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Классы определения
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: После вызова этого метода нужно отказаться от итератора, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def collectFirst[B](pf: PartialFunction[T, B]): Option[B]
Находит первый элемент коллекции, для которого заданная частичная функция определена, и применяет частичную функцию к нему.
Примечание: может не завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- pf
частичная функция
- возвращает
значение типа Option, содержащее результат применения pf к первому значению, для которого она определена, или
None, если такового не существует.
- Классы определения
- IterableOnceOps
Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)
def combinations(n: Int): Iterator[IndexedSeq[T]]
Итерирует по сочетаниям. _Сочетание_ длины n — это подпоследовательность исходной последовательности, с элементами, взятыми в порядке следования. Таким образом, "xy" и "yy" являются сочетаниями длины 2 последовательности "xyy", но "yx" нет. Если существует более одного способа сгенерировать одну и ту же подпоследовательность, будет возвращена только одна.
Например, "xyyy" имеет три различных способа сгенерировать "xy" в зависимости от того, какой первый, второй или третий "y" выбран. Однако, так как все они идентичны, будет выбран только один. Какой из трех будет выбран, является деталью реализации, которая не определена.
Примечание: даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычислены.
- returns
Итератор, который проходит по возможным сочетаниям из n элементов этой последовательности.
- Definition Classes
- SeqOps
"abbbc".combinations(2) = Iterator(ab, ac, bb, bc)
def compose[R](k: PartialFunction[R, Int]): PartialFunction[R, T]
Компонует другую частичную функцию k с этой частичной функцией, так что эта частичная функция применяется к результатам работы k.
Обратите внимание, что вызов isDefinedAt на результирующей частичной функции может применить первую частичную функцию и выполнить её побочные эффекты. Сильно рекомендуется использовать applyOrElse вместо isDefinedAt / apply для повышения эффективности.
- R
тип параметра функции преобразования.
- k
функция преобразования
- returns
частичная функция с областью определения другой частичной функции, суженной этой частичной функцией, которая отображает аргументы
xвthis(k(x)).
- Definition Classes
- PartialFunction
def compose[A](g: (A) => Int): (A) => T
Объединяет две инстанции Function1 в новую Function1, при этом данная функция применяется последней.
- A
тип, к которому может быть применена функция
g- g
функция A => T1
- returns
новая функция
f, такая чтоf(x) == apply(g(x))
- Definition Classes
- Function1
- Annotations
- @unspecialized()
final def concat[B >: T](suffix: IterableOnce[B]): IndexedSeq[B]
Возвращает новую последовательность, содержащую элементы левого операнда, за которыми следуют элементы правого операнда. Тип элементов последовательности — это наиболее специфический суперкласс, охватывающий типы элементов двух операндов.
- B
тип элементов возвращаемой коллекции.
- suffix
объект для добавления.
- returns
новая последовательность, содержащая все элементы этой последовательности, за которыми следуют все элементы
suffix.
- Definition Classes
- SeqOps → IterableOps
- Annotations
- @inline()
def contains[A1 >: T](elem: A1): Boolean
Проверяет, содержит ли эта последовательность заданное значение в качестве элемента.
Примечание: для бесконечных коллекций может не завершиться.
- elem
элемент для проверки.
- returns
true, если в этой последовательности есть элемент, равный (как определяется==)elem,falseв противном случае.
- Definition Classes
- SeqOps
def containsSlice[B](that: collection.Seq[B]): Boolean
Проверяет, содержит ли эта последовательность заданную последовательность в качестве среза.
Примечание: для бесконечных коллекций может не завершиться.
- that
последовательность для проверки
- returns
true, если эта последовательность содержит срез с теми же элементами, что иthat, в противном случаеfalse.
- Definition Classes
- SeqOps
def copyToArray[B >: T](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 >: T](xs: Array[B], start: Int): Int
Копирование элементов в массив, возвращая количество скопированных элементов.
Заполняет заданный массив xs, начиная с индекса start, значениями из этой коллекции.
Копирование прекратится, как только будут скопированы все элементы из этой коллекции, или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- returns
количество элементов, записанных в массив. Примечание: не завершит работу для коллекций бесконечного размера.
- Definition Classes
- IterableOnceOps
def copyToArray[B >: T](xs: Array[B]): Int
Копирование элементов в массив, возвращая количество скопированных элементов.
Заполняет заданный массив xs, начиная с индекса start, значениями из этой коллекции.
Копирование прекратится, как только будут скопированы все элементы из этой коллекции, или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- returns
количество элементов, записанных в массив. Примечание: не завершит работу для коллекций бесконечного размера.
- Definition Classes
- IterableOnceOps
def corresponds[B](that: collection.Seq[B])(p: (T, 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: (T, B) => Boolean): Boolean
Проверяет, соответствует ли каждый элемент итератора этого набора соответствующему элементу другого набора, удовлетворяя предикату теста.
- B
тип элементов
that- that
другой набор
- p
предикат теста, который связывает элементы из обоих наборов
- returns
true, если оба набора имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтого итератора иyнабораthat, в противном случаеfalse
- Definition Classes
- IterableOnceOps
def count(p: (T) => Boolean): Int
Подсчитывает количество элементов в наборе, которые удовлетворяют предикату.
- p
предикат, используемый для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Definition Classes
- IterableOnceOps
def diff[B >: T](that: collection.Seq[B]): IndexedSeq[T]
Вычисляет разность множеств (с учётом кратности) между этой последовательностью и другой последовательностью.
- that
последовательность элементов, которые нужно удалить
- returns
новая последовательность, содержащая все элементы этой последовательности, за исключением некоторых вхождений элементов, которые также появляются в
that. Если значение элементаxпоявляется n раз вthat, то первые n вхожденийxне будут частью результата, но любые последующие вхождения будут.
- Definition Classes
- SeqOps
def distinct: IndexedSeq[T]
Выбирает все элементы этой последовательности, игнорируя дубликаты.
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
- Definition Classes
- SeqOps
def distinctBy[B](f: (T) => B): IndexedSeq[T]
Выбирает все элементы этой последовательности, игнорируя дубликаты, как определено по == после применения преобразующей функции f.
- B
тип элементов после преобразования с помощью
f- f
преобразующая функция, результат которой используется для определения уникальности каждого элемента
- returns
новая последовательность, состоящая из всех элементов этой последовательности без дубликатов.
- Definition Classes
- SeqOps
def drop(n: Int): IndexedSeq[T]
Выбирает все элементы, кроме первых n.
- n
количество элементов, которые нужно выбросить из этой последовательности.
- returns
последовательность, состоящая из всех элементов этой последовательности, кроме первых
nэлементов, или пустая последовательность, если в этой последовательности меньше чемnэлементов. Еслиnотрицательное, не удалять элементы.
- Definition Classes
- IndexedSeqOps → IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода необходимо отказаться от итератора, на котором он был вызван, и использовать только тот итератор, который был возвращен. Использование старого итератора является неопределённым, может измениться и может привести к изменениям в новом итераторе.
def dropRight(n: Int): IndexedSeq[T]
Выбирает все элементы, кроме последних n.
- n
количество элементов, которые нужно удалить из этой последовательности.
- возвращает
последовательность, состоящую из всех элементов этой последовательности, кроме последних
nэлементов, или пустую последовательность, если в этой последовательности меньше чемnэлементов. Еслиnотрицательное, не удалять элементы.
- Определяющие классы
- IndexedSeqOps → IterableOps
def dropWhile(p: (T) => Boolean): IndexedSeq[T]
Удаляет самое длинное префиксное подмножество элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты при разных запусках, если только тип базовой коллекции не является упорядоченным.
- p
Предикат, используемый для проверки элементов.
- возвращает
самое длинное суффиксное подмножество этой коллекции итераций, первый элемент которого не удовлетворяет предикату
p.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределённо, может измениться и может привести к изменениям в новом итераторе.
def elementWise: ElementWiseExtractor[Int, T]
Возвращает объект-экстрактор с методом unapplySeq, который извлекает каждый элемент данных последовательности.
- Определяющие классы
- PartialFunction
val firstChar: String => Option[Char] = _.headOption
Seq("foo", "bar", "baz") match {
case firstChar.unlift.elementWise(c0, c1, c2) =>
println(s"$c0, $c1, $c2") // Output: f, b, b
}
def empty: IndexedSeq[T]
Пустая последовательность того же типа, что и эта последовательность
- возвращает
пустую последовательность типа
C.
- Определяющие классы
- IterableFactoryDefaults → IterableOps
def endsWith[B >: T](that: collection.Iterable[B]): Boolean
Проверяет, заканчивается ли эта последовательность заданной последовательностью.
Примечание: не завершится для коллекций бесконечного размера.
- that
последовательность для проверки
- returns
true, если эта последовательность имеетthatв качестве суффикса,falseв противном случае.
- Definition Classes
- SeqOps
def ensuring(cond: (IndexedSeq[T]) => Boolean, msg: => Any): IndexedSeq[T]
- Неявное
- Этот член добавлен с помощью неявного преобразования из IndexedSeq[T] в Ensuring[IndexedSeq[T]] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (IndexedSeq[T]) => Boolean): IndexedSeq[T]
- Неявное
- Этот член добавлен с помощью неявного преобразования из IndexedSeq[T] в Ensuring[IndexedSeq[T]] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: => Any): IndexedSeq[T]
- Неявный
- Этот член добавлен неявным преобразованием из IndexedSeq[T] в Ensuring[IndexedSeq[T]], выполненным методом Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean): IndexedSeq[T]
- Неявный
- Этот член добавлен неявным преобразованием из IndexedSeq[T] в Ensuring[IndexedSeq[T]], выполненным методом Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности на непустых экземплярах AnyRef и имеет три дополнительных свойства:
-
Он согласован: для любых непустых экземпляров
x и y типа AnyRef многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false. Для любого непустого экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращают false.
null.eq(null) возвращает true.При переопределении методов equals или hashCode важно гарантировать, что их поведение соответствует равенству ссылок. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и должны иметь одинаковое значение хеша (o1.hashCode == o2.hashCode).
- возвращает
true, если аргумент является ссылкой на объект-получатель;falseв противном случае.
- Определяющие классы
- AnyRef
def equals(o: Any): Boolean
def exists(p: (T) => Boolean): Boolean
Проверяет, выполняется ли предикат для хотя бы одного элемента в этом наборе.
Примечание: может не завершиться для бесконечных наборов.
- p
предикат, используемый для проверки элементов.
- returns
true, если заданный предикатpвыполняется хотя бы для одного элемента в этом наборе, в противном случаеfalse
- Definition Classes
- IterableOnceOps
def filter(pred: (T) => Boolean): IndexedSeq[T]
Выбирает все элементы из этого итерируемого набора, удовлетворяющие предикату.
- returns
новый итератор, содержащий все элементы из этого итерируемого набора, удовлетворяющие заданному предикату
p. Порядок элементов сохраняется.
- Definition Classes
- IterableOps → IterableOnceOps
def filterNot(pred: (T) => Boolean): IndexedSeq[T]
Выбирает все элементы из этого итерируемого набора, которые не удовлетворяют предикату.
- pred
предикат, используемый для проверки элементов.
- returns
новый итерируемый набор, содержащий все элементы из этого итерируемого набора, которые не удовлетворяют заданному предикату
pred. Их порядок может не сохраняться.
- Definition Classes
- IterableOps → IterableOnceOps
def finalize(): Unit
Вызывается сборщиком мусора для объекта-получателя, когда к объекту больше нет ссылок.
Детали того, когда и будет ли вызываться метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями зависят от платформы.
def find(p: (T) => Boolean): Option[T]
Находит первый элемент в коллекции, удовлетворяющий предикату, если таковой имеется.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если только тип основной коллекции не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
значение типа option, содержащее первый элемент в коллекции, удовлетворяющий
p, илиNone, если такового нет.
- Definition Classes
- IterableOnceOps
def findLast(p: (T) => Boolean): Option[T]
Находит последний элемент в последовательности, удовлетворяющий предикату, если таковой имеется.
Примечание: не завершится для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
значение типа option, содержащее последний элемент в последовательности, удовлетворяющий
p, илиNone, если такового нет.
- Definition Classes
- SeqOps
def flatMap[B](f: (T) => IterableOnce[B]): IndexedSeq[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: (T) => IterableOnce[B]): IndexedSeq[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 >: T](z: A1)(op: (A1, A1) => A1): A1
Складывает элементы этой коллекции, используя указанный ассоциативный бинарный оператор. Реализация по умолчанию в IterableOnce эквивалентна foldLeft, но может быть переопределена для более эффективных порядков обхода.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
Примечание: не будет завершаться для коллекций бесконечного размера.
- A1
параметр типа для бинарного оператора, супертип
A.- z
нейтральный элемент для операции сложения; может быть добавлен к результату произвольное количество раз и не должен изменять результат (например,
Nilдля конкатенации списков, 0 для сложения или 1 для умножения).- op
бинарный оператор, который должен быть ассоциативным.
- returns
результат применения оператора сложения
opмежду всеми элементами иzилиz, если эта коллекция пуста.
- Definition Classes
- IterableOnceOps
def foldLeft[B](z: B)(op: (B, T) => B): B
Применяет бинарный оператор к начальному значению и всем элементам этого набора, слева направо.
Примечание: не завершится для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого набора, слева направо, с начальным значениемzслева:op(...op(z, x_1), x_2, ..., x_n)
где
x1, ..., xn— элементы этого набора. Возвращаетz, если этот набор пуст.
- Definition Classes
- IterableOnceOps
def foldRight[B](z: B)(op: (T, B) => B): B
Применяет бинарный оператор ко всем элементам этого набора и начальному значению, справа налево.
Примечание: не завершится для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого набора, справа налево, с начальным значениемzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xn— элементы этого набора. Возвращаетz, если этот набор пуст.
- Definition Classes
- IterableOnceOps
def forall(p: (T) => Boolean): Boolean
Проверяет, выполняется ли предикат для всех элементов этого набора.
Примечание: может не завершиться для наборов бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
true, если этот набор пуст или заданный предикатpвыполняется для всех элементов этого набора; в противном случае —false.
- Definition Classes
- IterableOnceOps
def foreach[U](f: (T) => U): Unit
Применяет f к каждому элементу для получения побочных эффектов. Примечание: параметр [U] необходим для помощи в выводе типов scalac.
- Definition Classes
- IterableOnceOps
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной строкой format. Формат строк такой же, как и для String.format (@see java.lang.String.format).
- Неявный
- Этот член добавляется неявным преобразованием из IndexedSeq[T] вStringFormat[IndexedSeq[T]] посредством метода StringFormat в scala.Predef.
- Определяющие классы
- StringFormat
- Аннотации
- @inline()
def fromSpecific(coll: IterableOnce[T]): IndexedSeq[T]
Определяет, как преобразовать заданный Iterable[A] в коллекцию типа C.
Этот процесс может выполняться строго или нестрого (т.е. без вычисления элементов результирующих коллекций). Другими словами, этот метод определяет модель вычисления коллекции.
- Атрибуты
- protected
- Определяющие классы
- IterableFactoryDefaults → IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, добавив в миксин IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, до тех пор, пока оно вызывается сIterable[A], полученным изthisколлекции (как это происходит при реализации операций, где мы используемView[A]), оно безопасно.
final def getClass(): Class[_ <: AnyRef]
def groupBy[K](f: (T) => K): immutable.Map[K, IndexedSeq[T]]
Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с некоторой функцией дискриминации.
Примечание: даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.
- 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: (T) => K)(f: (T) => B): immutable.Map[K, IndexedSeq[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: (T) => K)(f: (T) => 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[IndexedSeq[T]]
Разделяет элементы в итерируемых коллекциях фиксированного размера.
- size
количество элементов в группе
- возвращает
Итератор, производящий итерируемые коллекции размером
size, за исключением последнего, который будет меньше sizesize, если элементы не делятся равномерно.
- Определяющие классы
- IterableOps
- См. также
scala.collection.Iterator, метод
grouped
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- возвращает
значение хэш-кода для этого объекта.
def head: T
Выбирает первый элемент этой итерируемой коллекции.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- возвращает
первый элемент этой итерируемой коллекции.
- Определяющие классы
- IterableOps
- Исключения
NoSuchElementException, если итерируемая коллекция пустая.
def headOption: Option[T]
Выбирает первый элемент, если он есть.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- возвращает
первый элемент этой итерируемой коллекции, если она не пустая,
None, если она пустая.
- Определяющие классы
- IterableOps
def indexOf[B >: T](elem: B): Int
Находит индекс первого вхождения некоторого значения в этой последовательности.
- B
тип элемента
elem.- elem
значение элемента, для поиска.
- returns
индекс
>= 0первого элемента этой последовательности, который равен (как определено==) элементуelem, или-1, если такого элемента нет.
- Definition Classes
- SeqOps
- Annotations
- @deprecatedOverriding("Override indexOf(elem, from) вместо этого - indexOf(elem) вызывает indexOf(elem, 0)", "2.13.0")
def indexOf[B >: T](elem: B, from: Int): Int
Находит индекс первого вхождения некоторого значения в этой последовательности после или на заданном стартовом индексе.
- B
тип элемента
elem.- elem
значение элемента, для поиска.
- from
стартовый индекс
- returns
индекс
>= fromпервого элемента этой последовательности, который равен (как определено==) элементуelem, или-1, если такого элемента нет.
- Definition Classes
- SeqOps
def indexOfSlice[B >: T](that: collection.Seq[B]): Int
Находит первый индекс, где эта последовательность содержит заданную последовательность как срез.
Примечание: может не завершаться для коллекций бесконечного размера.
- that
последовательность, для проверки.
- returns
первый индекс
>= 0, такой, что элементы этой последовательности, начиная с этого индекса, соответствуют элементам последовательностиthat, или-1, если такой подпоследовательности не существует.
- Definition Classes
- SeqOps
- Annotations
- @deprecatedOverriding("Override indexOfSlice(that, from) вместо этого - indexOfSlice(that) вызывает indexOfSlice(that, 0)", "2.13.0")
def indexOfSlice[B >: T](that: collection.Seq[B], from: Int): Int
Находит первый индекс после или на стартовом индексе, где эта последовательность содержит заданную последовательность как срез.
Примечание: может не завершаться для коллекций бесконечного размера.
- that
последовательность для проверки
- from
стартовый индекс
- returns
первый индекс
>= from, такой, что элементы этой последовательности, начиная с этого индекса, соответствуют элементам последовательностиthat, или-1, если такая подпоследовательность не существует.
- Definition Classes
- SeqOps
def indexWhere(p: (T) => Boolean): Int
Находит индекс первого элемента, удовлетворяющего некоторому предикату.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
индекс
>= 0первого элемента этой последовательности, удовлетворяющего предикатуp, или-1, если такой элемент отсутствует.
- Definition Classes
- SeqOps
- Annotations
- @deprecatedOverriding("Override indexWhere(p, from) instead - indexWhere(p) calls indexWhere(p, 0)", "2.13.0")
def indexWhere(p: (T) => Boolean, from: Int): Int
Находит индекс первого элемента, удовлетворяющего некоторому предикату после или на определенном стартовом индексе.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- from
стартовый индекс
- returns
индекс
>= fromпервого элемента этой последовательности, удовлетворяющего предикатуp, или-1, если такой элемент отсутствует.
- Definition Classes
- SeqOps
def indices: immutable.Range
Создает диапазон всех индексов этой последовательности.
Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно вычислять элементы.
- returns
значение
Rangeот0до значения, на единицу меньшего, чем длина этой последовательности.
- Definition Classes
- SeqOps
def init: IndexedSeq[T]
Начальная часть коллекции без ее последнего элемента.
Примечание: даже при применении к представлению или ленивой коллекции она всегда будет принудительно вычислять элементы.
- Definition Classes
- IterableOps
def inits: Iterator[IndexedSeq[T]]
Итерирует по начальным частям этого итерируемого набора. Первое значение будет этим итерируемым набором, а последнее — пустым итерируемым набором, а промежуточные значения — результаты последовательных применений init.
Примечание: Даже при применении к представлению или ленивому набору он всегда заставляет элементы.
- returns
итератор по всем начальным частям этого итерируемого набора
- Definition Classes
- IterableOps
List(1,2,3).inits = Iterator(List(1,2,3), List(1,2), List(1), Nil)
def intersect[B >: T](that: collection.Seq[B]): IndexedSeq[T]
Вычисляет пересечение мультимножеств между этим массивом и другим массивом.
- that
массив элементов для пересечения.
- returns
новый массив, содержащий все элементы этого массива, которые также присутствуют в
that. Если значение элементаxвстречается n раз вthat, то первые n вхожденийxбудут сохранены в результате, но любые последующие вхождения будут пропущены.
- Definition Classes
- SeqOps
def isDefinedAt(idx: Int): Boolean
Проверяет, содержит ли этот массив данный индекс.
Реализации методов apply и isDefinedAt преобразуют Seq[A] в PartialFunction[Int, A].
- idx
индекс для проверки
- returns
true, если этот массив содержит элемент в позицииidx,falseв противном случае.
- Definition Classes
- SeqOps
def isEmpty: Boolean
Проверяет, пуст ли массив.
Примечание: Реализации в подклассах, которые не являются многократно проходимыми, должны позаботиться о том, чтобы не потреблять никаких элементов при вызове isEmpty.
- returns
true, если массив не содержит элементов,falseв противном случае.
- Definition Classes
- SeqOps → IterableOnceOps
final def isInstanceOf[T0]: Boolean
Проверка динамического типа объекта-приёмника, является ли он T0.
Обратите внимание, что результат проверки зависит от стирания типов Scala. Таким образом, выражение 1.isInstanceOf[String] вернёт false, в то время как выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, поскольку тип аргумента стирается во время компиляции, невозможно проверить, являются ли элементы списка указанного типа.
- returns
true, если объект-приёмник является экземпляром стираемого типаT0;falseв противном случае.
- Definition Classes
- Any
def isTraversableAgain: Boolean
Проверка, может ли этот итерируемый набор быть многократно пройден. Всегда истинно для итерируемых наборов и ложно для итераторов, если не переопределено.
- returns
true, если он может быть многократно пройден,falseв противном случае.
- Definition Classes
- IterableOps → IterableOnceOps
def iterableFactory: SeqFactory[IndexedSeq]
Компаньон-объект этой изменяемой последовательности, предоставляющий различные методы создания.
- Definition Classes
- IndexedSeq → IndexedSeq → Seq → Seq → Iterable → Iterable → IterableOps
- Note
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (в противном случае компилятор выдаст ошибку).
def iterator: Iterator[T]
Итератор может быть использован только один раз
- Definition Classes
- IndexedSeqOps → IterableOnce
def knownSize: Int
- returns
Количество элементов в этой последовательности, если его можно вычислить без существенных затрат, -1 в противном случае. Без существенных затрат обычно означает: без необходимости обхода коллекции.
- Definition Classes
- IndexedSeqOps → IterableOnce
def last: T
Выбирает последний элемент.
- returns
Последний элемент этой последовательности.
- Definition Classes
- IndexedSeqOps → IterableOps
- Exceptions thrown
NoSuchElementExceptionЕсли последовательность пустая.
def lastIndexOf[B >: T](elem: B, end: Int = length - 1): Int
Находит индекс последнего вхождения значения в этой последовательности до или в заданном индексе конца.
Примечание: не будет завершаться для коллекций бесконечного размера.
- B
тип элемента
elem.- elem
значение искомого элемента.
- end
индекс конца.
- returns
индекс
<= endпоследнего элемента этой последовательности, который равен (как определяется==)elem, или-1, если такового нет.
- Definition Classes
- SeqOps
def lastIndexOfSlice[B >: T](that: collection.Seq[B]): Int
Находит последний индекс, где эта последовательность содержит заданную последовательность как срез.
Примечание: не будет завершаться для коллекций бесконечного размера.
- that
искомая последовательность
- returns
последний индекс, такой что элементы этой последовательности, начинающиеся с этого индекса, соответствуют элементам последовательности
that, или-1, если такой подпоследовательности не существует.
- Definition Classes
- SeqOps
- Annotations
- @deprecatedOverriding("Override lastIndexOfSlice(that, end) instead - lastIndexOfSlice(that) calls lastIndexOfSlice(that, Int.MaxValue)", "2.13.0")
def lastIndexOfSlice[B >: T](that: collection.Seq[B], end: Int): Int
Находит последний индекс перед или на заданном конечном индексе, где эта последовательность содержит заданную последовательность как срез.
Примечание: не будет завершаться для коллекций бесконечного размера.
- that
последовательность для проверки
- end
конечный индекс
- returns
последний индекс
<= end, такой что элементы этой последовательности, начинающиеся с этого индекса, соответствуют элементам последовательностиthat, или-1, если такая подпоследовательность не существует.
- Definition Classes
- SeqOps
def lastIndexWhere(p: (T) => Boolean): Int
Находит индекс последнего элемента, удовлетворяющего некоторому предикату.
Примечание: не будет завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
индекс последнего элемента этой последовательности, удовлетворяющего предикату
p, или-1, если такого элемента нет.
- Definition Classes
- SeqOps
- Annotations
- @deprecatedOverriding("Override lastIndexWhere(p, end) instead - lastIndexWhere(p) calls lastIndexWhere(p, Int.MaxValue)", "2.13.0")
def lastIndexWhere(p: (T) => Boolean, end: Int): Int
Находит индекс последнего элемента, удовлетворяющего некоторому предикату до или на заданном конечном индексе.
Примечание: не будет завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- returns
индекс
<= endпоследнего элемента этой последовательности, удовлетворяющего предикатуp, или-1, если такого элемента нет.
- Definition Classes
- SeqOps
def lastOption: Option[T]
Возвращает последний элемент, если он существует.
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции не упорядочен.
- returns
последний элемент этой коллекции, если она непустая,
None, если она пуста.
- Definition Classes
- IterableOps
def lazyZip[B](that: collection.Iterable[B]): LazyZip2[T, B, IndexedSeq.this.type]
Аналогично zip, за исключением того, что элементы в каждом наборе не потребляются до тех пор, пока на возвращаемом декораторе LazyZip2 не будет вызвано строгое действие.
Вызовы lazyZip могут быть объединены для поддержки более высокой арности (до 4) без затрат на построение и деконструирование промежуточных кортежей.
val xs = List(1, 2, 3) val res = (xs lazyZip xs lazyZip xs lazyZip xs).map((a, b, c, d) => a + b + c + d) // res == List(4, 8, 12)
- B
тип второго элемента в каждой возможной паре
- that
итерируемый объект, предоставляющий второй элемент каждой возможной пары
- returns
декоратор
LazyZip2, который позволяет выполнять строгие операции над лениво вычисляемыми парами или объединять вызовыlazyZip. Также поддерживается неявное преобразование вIterable[(A, B)].
- Definition Classes
- Iterable
final def lengthCompare(that: collection.Iterable[_]): Int
Сравнивает длину этой последовательности с размером другого Iterable.
- that
Iterable, размер которого сравнивается с длиной этой последовательности.- returns
-
Значение
x, гдеx < 0 if this.length < that.size x == 0 if this.length == that.size x > 0 if this.length > that.size
Метод, как он реализован здесь, не вызывает напрямую
lengthилиsize; его время выполнения составляетO(this.length min that.size)вместоO(this.length + that.size). Метод следует переопределить, если вычислениеsizeявляется дешёвым, иknownSizeвозвращает-1.
- Definition Classes
- IndexedSeqOps → SeqOps
final def lengthCompare(len: Int): Int
Сравнивает длину этой последовательности со значением-тестом.
- len
значение-тест, которое сравнивается с длиной.
- returns
-
Значение
x, гдеx < 0 if this.length < len x == 0 if this.length == len x > 0 if this.length > len
Метод, как он реализован здесь, не вызывает напрямую
length; его время выполнения составляетO(length min len)вместоO(length). Метод следует переопределить, если вычислениеlengthявляется дешёвым, иknownSizeвозвращает-1.
- Definition Classes
- IndexedSeqOps → SeqOps
- См. также
final def lengthIs: SizeCompareOps
Возвращает значение класса, содержащего операции сравнения длины этой последовательности со значением-тестом.
Эти операции реализованы с помощью lengthCompare(Int) и позволяют использовать более читаемый синтаксис:
this.lengthIs < len // this.lengthCompare(len) < 0 this.lengthIs <= len // this.lengthCompare(len) <= 0 this.lengthIs == len // this.lengthCompare(len) == 0 this.lengthIs != len // this.lengthCompare(len) != 0 this.lengthIs >= len // this.lengthCompare(len) >= 0 this.lengthIs > len // this.lengthCompare(len) > 0
def lift: (Int) => Option[T]
Преобразует эту частичную функцию в обычную функцию, возвращающую результат.
- returns
функция, которая принимает аргумент
xи возвращаетSome(this(x)), еслиthisопределена дляx, иNoneв противном случае.
- Definition Classes
- PartialFunction
- See also
Function.unlift
def map[B](f: (T) => B): IndexedSeq[B]
Создаёт новую последовательность, применяя функцию ко всем элементам этой последовательности.
- B
тип элементов возвращаемой последовательности.
- f
функция, применяемая к каждому элементу.
- returns
новая последовательность, полученная путём применения заданной функции
fк каждому элементу этой последовательности и сбора результатов.
- Definition Classes
- IndexedSeqOps → IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода нужно отказаться от итератора, на котором он был вызван, и использовать только тот итератор, который был возвращён. Использование старого итератора является неопределённым, может быть изменено и может привести к изменениям в новом итераторе.
def mapInPlace(f: (T) => T): IndexedSeq.this.type
Изменяет эту изменяемую последовательность, применяя функцию ко всем элементам этой изменяемой последовательности.
- f
функция, применяемая к каждому элементу.
- returns
эта изменяемая последовательность, изменённая путём замены всех элементов результатом применения заданной функции
fк каждому элементу этой изменяемой последовательности.
- Definition Classes
- IndexedSeqOps
def max[B >: T](implicit ord: math.Ordering[B]): T
Находит наибольший элемент.
- B
Тип, по которому определено упорядочение.
- ord
Упорядочение, используемое для сравнения элементов.
- returns
наибольший элемент этого набора относительно упорядочения
ord.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationException, если этот набор пуст.
def maxBy[B](f: (T) => B)(implicit cmp: math.Ordering[B]): T
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Упорядочение, используемое для сравнения элементов.
- returns
первый элемент этого набора с наибольшим значением, измеренным функцией f, относительно упорядочения
cmp.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationException, если этот набор пуст.
def maxByOption[B](f: (T) => B)(implicit cmp: math.Ordering[B]): Option[T]
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Упорядочение, используемое для сравнения элементов.
- returns
опциональный результат, содержащий первый элемент этого набора с наибольшим значением, измеренным функцией f, относительно упорядочения
cmp.
- Definition Classes
- IterableOnceOps
def maxOption[B >: T](implicit ord: math.Ordering[B]): Option[T]
Находит наибольший элемент.
- B
Тип, по которому определяется порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
значение типа Option, содержащее наибольший элемент этого набора относительно порядка
ord.
- Definition Classes
- IterableOnceOps
def min[B >: T](implicit ord: math.Ordering[B]): T
Находит наименьший элемент.
- B
Тип, по которому определяется порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
наименьший элемент этого набора относительно порядка
ord.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationException, если этот набор пуст.
def minBy[B](f: (T) => B)(implicit cmp: math.Ordering[B]): T
Находит первый элемент, который дает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
первый элемент этого набора с наименьшим значением, измеренным функцией f, относительно порядка
cmp.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationException, если этот набор пуст.
def minByOption[B](f: (T) => B)(implicit cmp: math.Ordering[B]): Option[T]
Находит первый элемент, который даёт наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
значение типа Option, содержащее первый элемент этого набора с наименьшим значением, измеренным функцией f относительно порядка
cmp.
- Definition Classes
- IterableOnceOps
def minOption[B >: T](implicit ord: math.Ordering[B]): Option[T]
Находит наименьший элемент.
- 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
Отображает все элементы этого набора в строке, используя строки start, end и разделитель.
Делегирует вызов к addString, который можно переопределить.
- start
строка начала.
- sep
строка-разделитель.
- end
строка конца.
- returns
строковое представление этого набора. Результирующая строка начинается со строки
startи заканчивается строкойend. Внутри, строковые представления (относительно методаtoString) всех элементов этого набора разделены строкойsep.
- Definition Classes
- IterableOnceOps
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
final def ne(arg0: AnyRef): Boolean
Эквивалентно !(this eq that).
- returns
true, если аргумент не является ссылкой на объект-получатель;falseв противном случае.
- Definition Classes
- AnyRef
def newSpecificBuilder: Builder[T, IndexedSeq[T]]
- returns
строгий билдер для того же типа коллекции. Обратите внимание, что в случае ленивых коллекций (например, View или immutable.LazyList), реализация этого метода возможна, но полученный
Builderнарушит ленивость. Вследствие этого операции предпочтительнее реализовывать с помощьюfromSpecificвместо этого метода.
- Attributes
- protected
- Definition Classes
- IterableFactoryDefaults → IterableOps
- Note
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, смешав в себе трайт IterableFactoryDefaults, который реализует метод с использованием iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, до тех пор, пока возвращаемый билдер заполняется только значениямиA, взятыми из экземпляраthis, он безопасен.
def nonEmpty: Boolean
Проверяет, не является ли коллекция пустой.
- возвращает
true, если коллекция содержит хотя бы один элемент,falseв противном случае.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @deprecatedOverriding("nonEmpty определено как !isEmpty; переопределите isEmpty вместо этого", "2.13.0")
final def notify(): Unit
Разбуждает единственную нить, которая ожидает монитор объекта-получателя.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS в качестве члена AnyRef
final def notifyAll(): Unit
Разбуждает все нити, которые ожидают монитор объекта-получателя.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS в качестве члена AnyRef
def occCounts[B](sq: collection.Seq[B]): Map[B, Int]
- Атрибуты
- protected[scala.collection]
- Определяющие классы
- SeqOps
def orElse[A1 <: Int, B1 >: T](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]
Компонует эту частичную функцию с резервной частичной функцией, которая применяется в тех случаях, когда эта частичная функция не определена.
- A1
тип аргумента резервной функции
- B1
тип результата резервной функции
- that
резервная функция
- возвращает
частичная функция, область определения которой является объединением областей определения этой частичной функции и
that. Результирующая частичная функция принимаетxкthis(x), гдеthisопределена, и кthat(x), где она не определена.
- Определяющие классы
- PartialFunction
def padTo[B >: T](len: Int, elem: B): IndexedSeq[B]
Копия этого набора с добавленными элементами до тех пор, пока не будет достигнута заданная целевая длина.
- B
Тип элементов возвращаемого набора.
- len
Целевая длина
- elem
Значение для дополнения
- returns
Новый набор, состоящий из всех элементов этого набора, после которого следует минимальное количество вхождений
elem, так что полученный набор имеет длину как минимумlen.
- Definition Classes
- SeqOps
def partition(p: (T) => Boolean): (IndexedSeq[T], IndexedSeq[T])
Пара, во-первых, всех элементов, которые удовлетворяют предикату p, и, во-вторых, всех элементов, которые не удовлетворяют ему. Интересно тем, что разбивает коллекцию на две части.
Представленная здесь реализация по умолчанию требует два прохода по коллекции. Строгие коллекции имеют переопределенный метод partition в StrictOptimizedIterableOps, что требует только одного прохода.
- Definition Classes
- IterableOps
def partitionMap[A1, A2](f: (T) => Either[A1, A2]): (IndexedSeq[A1], IndexedSeq[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 >: T](from: Int, other: IterableOnce[B], replaced: Int): IndexedSeq[B]
Создаёт новый набор, где фрагмент элементов в этом наборе заменяется другим набором.
Замена по отрицательным индексам эквивалентна замене, начинающейся с 0. Замена по индексам, равным или большим длины исходного набора, добавляет вставка в конец. Если заменяемых элементов больше, чем фактически существует, избыток игнорируется.
- B
тип элементов возвращаемого набора.
- from
индекс первого заменяемого элемента
- other
набор замены
- replaced
количество элементов для удаления в исходном наборе
- returns
новый набор, состоящий из всех элементов этого набора, за исключением того, что
replacedэлементы, начиная сfrom, заменяются всеми элементамиother.
- Definition Classes
- SeqOps
def permutations: Iterator[IndexedSeq[T]]
Итерируется по различным перестановкам.
Примечание: даже при применении к представлению или ленивому набору элементы всегда будут принудительно вычисляться.
- returns
Итератор, который проходит по различным перестановкам этого набора.
- Definition Classes
- SeqOps
"abb".permutations = Iterator(abb, bab, bba)
def prepended[B >: T](elem: B): IndexedSeq[B]
Копия последовательности с добавленным элементом в начало.
Также исходная последовательность не изменяется, поэтому вам нужно будет сохранить результат.
Пример:
scala> val x = List(1) x: List[Int] = List(1) scala> val y = 2 +: x y: List[Int] = List(2, 1) scala> println(x) List(1)
- B
тип элемента возвращаемой последовательности.
- elem
элемент, добавляемый в начало
- returns
новая последовательность, состоящая из
value, за которой следуют все элементы этой последовательности.
- Definition Classes
- IndexedSeqOps → SeqOps
def prependedAll[B >: T](prefix: IterableOnce[B]): IndexedSeq[B]
Как и в случае с :++, возвращает новую коллекцию, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда.
Она отличается от :++ тем, что правый операнд определяет тип результирующей коллекции, а не левый. Мемоника: двоеточие находится со стороны нового типа коллекции.
- B
тип элемента возвращаемой коллекции.
- prefix
итерируемый объект для добавления в начало.
- returns
новая последовательность, содержащая все элементы
prefix, за которыми следуют все элементы этой последовательности.
- Definition Classes
- SeqOps
def product[B >: T](implicit num: math.Numeric[B]): B
Умножает элементы этой коллекции.
- B
тип результата операции
*.- num
явный параметр, определяющий набор числовых операций, который включает операцию
*, используемую для формирования произведения.- returns
произведение всех элементов этой коллекции относительно операции
*вnum.
- Definition Classes
- IterableOnceOps
def reduce[B >: T](op: (B, B) => B): B
Уменьшает элементы этого набора, используя указанный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
- B
Параметр типа для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Результат применения оператора reduce
opмежду всеми элементами, если набор не пуст.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationException, если этот набор пуст.
def reduceLeft[B >: T](op: (B, T) => B): B
Применяет бинарный оператор ко всем элементам этого набора слева направо.
Примечание: не будет завершаться для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого набора слева направо:op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)где
x1, ..., xn— элементы этого набора.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationExceptionесли этот набор пуст.
def reduceLeftOption[B >: T](op: (B, T) => B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого набора слева направо.
Примечание: не будет завершаться для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение option, содержащее результат
reduceLeft(op), если этот набор не пуст,Noneв противном случае.
- Definition Classes
- IterableOnceOps
def reduceOption[B >: T](op: (B, B) => B): Option[B]
Сводит элементы этой коллекции, если таковые имеются, используя указанный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
- B
Параметр типа для бинарного оператора, являющийся супертипом
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Значение в виде опционального значения, содержащее результат применения оператора reduce
opк всем элементам, если коллекция не пустая, иNoneв противном случае.
- Definition Classes
- IterableOnceOps
def reduceRight[B >: T](op: (T, B) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции, двигаясь справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если тип коллекции, лежащей в основе, не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, двигаясь справа налево:op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))где
x1, ..., xn- элементы этой коллекции.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationException, если эта коллекция пуста.
def reduceRightOption[B >: T](op: (T, B) => B): Option[B]
Возможно применит бинарный оператор ко всем элементам этой коллекции, двигаясь справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если тип коллекции, лежащей в основе, не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
опциональное значение, содержащее результат
reduceRight(op), если эта коллекция не пуста,Noneв противном случае.
- Definition Classes
- IterableOnceOps
def reverse: IndexedSeq[T]
Возвращает новую последовательность с элементами в обратном порядке.
Примечание: не завершит работу для коллекций бесконечного размера.
Примечание: даже при применении к представлению или ленивой коллекции, она всегда будет принудительно создавать элементы.
- returns
Новая последовательность со всеми элементами этой последовательности в обратном порядке.
- Definition Classes
- IndexedSeqOps → SeqOps
def reverseIterator: Iterator[T]
Итератор, возвращающий элементы в обратном порядке.
Примечание: не завершит работу для коллекций бесконечного размера.
Примечание: xs.reverseIterator эквивалентно xs.reverse.iterator, но может быть более эффективным.
- returns
итератор, возвращающий элементы этой последовательности в обратном порядке
- Definition Classes
- IndexedSeqOps → SeqOps
def reversed: collection.Iterable[T]
- Attributes
- protected
- Definition Classes
- IndexedSeqOps → IterableOnceOps
def runWith[U](action: (T) => U): (Int) => Boolean
Компонует эту частичную функцию с функцией действия, которая применяется к результатам этой частичной функции. Функция действия вызывается только для своих побочных эффектов; её результат игнорируется.
Обратите внимание, что выражение pf.runWith(action)(x) эквивалентно
if(pf isDefinedAt x) { action(pf(x)); true } else false
за исключением того, что runWith реализована с помощью applyOrElse и, следовательно, потенциально более эффективна. Использование runWith позволяет избежать двойной оценки совпадений шаблонов и условий для литералов частичных функций.
- action
функция действия
- returns
функция, которая отображает аргументы
xвisDefinedAt(x). Результирующая функция выполняетaction(this(x)), гдеthisопределена.
- Definition Classes
- PartialFunction
- Since
2.10
- See also
applyOrElse.
def sameElements[B >: T](that: IterableOnce[B]): Boolean
Являются ли элементы этой коллекции одинаковыми (и в том же порядке), что и элементы that?
- Классы определения
- SeqOps
def scan[B >: T](z: B)(op: (B, B) => B): IndexedSeq[B]
Вычисляет префиксное сканирование элементов коллекции.
Примечание: Нейтральный элемент z может применяться более одного раза.
- B
тип элементов результирующей коллекции
- z
нейтральный элемент для оператора
op- op
ассоциативный оператор для сканирования
- возвращает
новая итерируемая коллекция, содержащая префиксное сканирование элементов в этой итерируемой коллекции
- Классы определения
- IterableOps
def scanLeft[B](z: B)(op: (B, T) => B): IndexedSeq[B]
Создаёт итерируемую коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- возвращает
коллекция с промежуточными результатами
- Классы определения
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: После вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def scanRight[B](z: B)(op: (T, B) => B): IndexedSeq[B]
Создаёт коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Головной элемент коллекции — последний кумулятивный результат.
Примечание: не завершается для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
Примечание: даже при применении к представлению или ленивой коллекции, она всегда принудительно обрабатывает элементы.
Пример:
List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Definition Classes
- IterableOps
def search[B >: T](elem: B, from: Int, to: Int)(implicit ord: math.Ordering[B]): SearchResult
Поиск в заданном интервале в этом отсортированном последовательности определённого элемента. Если эта последовательность — IndexedSeq, используется двоичный поиск. В противном случае используется линейный поиск.
Последовательность должна быть отсортирована с использованием того же Ordering перед вызовом; в противном случае результаты неопределённы.
- elem
элемент, который нужно найти.
- from
индекс, с которого начинается поиск.
- to
индекс, следующий за тем, где поиск заканчивается.
- ord
порядок, который используется для сравнения элементов.
- returns
значение
Found, содержащее индекс, соответствующий элементу в последовательности, илиInsertionPoint, где элемент был бы вставлен, если элемент не присутствует в последовательности.
- Definition Classes
- IndexedSeqOps → SeqOps
- Note
если
to <= from, пространство поиска пустое, и возвращаетсяInsertionPointвfrom- See also
-
scala.collection.SeqOps, метод
sorted
def search[B >: T](elem: B)(implicit ord: math.Ordering[B]): SearchResult
Поиск заданного элемента в отсортированной последовательности. Если последовательность является IndexedSeq, используется бинарный поиск. В противном случае используется линейный поиск.
Последовательность должна быть отсортирована с использованием того же Ordering перед вызовом; в противном случае результаты не определены.
- elem
элемент, который нужно найти.
- ord
порядок, используемый для сравнения элементов.
- returns
значение
Found, содержащее индекс, соответствующий элементу в последовательности, или значениеInsertionPoint, куда элемент должен быть вставлен, если элемент не содержится в последовательности.
- Definition Classes
- IndexedSeqOps → SeqOps
- See also
-
scala.collection.SeqOps, метод
sorted
def segmentLength(p: (T) => Boolean, from: Int): Int
Вычисляет длину самой длинной последовательности элементов, удовлетворяющих заданному предикату.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- from
индекс, с которого начинается поиск.
- returns
длина самой длинной последовательности из этой последовательности, начинающейся с индекса
from, такая, что каждый элемент этой последовательности удовлетворяет предикатуp.
- Definition Classes
- SeqOps
final def segmentLength(p: (T) => 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
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): IndexedSeq[T]
Выбирает интервал элементов. Возвращаемая последовательность состоит из всех элементов x, которые удовлетворяют инварианту:
from <= indexOf(x) < until
- from
наименьший индекс для включения из этой последовательности.
- until
наименьший индекс для исключения из этой последовательности.
- returns
последовательность, содержащую элементы, большие или равные индексу
from, простирающуюся до (но не включая) индексаuntilэтой последовательности.
- Definition Classes
- IndexedSeqOps → IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def sliding(size: Int, step: Int): Iterator[IndexedSeq[T]]
Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» по ним (в отличие от разделения их, как это делается в grouped.)
- size
количество элементов в группе
- step
расстояние между первыми элементами последовательных групп
- returns
Итератор, генерирующий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечен, если оставшихся элементов для группирования меньшеsize.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
def sliding(size: Int): Iterator[IndexedSeq[T]]
Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» по ним (в отличие от разделения их, как это делается в grouped). Шаг «скользящего окна» установлен в единицу.
- size
количество элементов в группе
- returns
Итератор, генерирующий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечен, если оставшихся элементов для группирования меньшеsize.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
def sortBy[B](f: (T) => B)(implicit ord: Ordering[B]): IndexedSeq[T]
Сортирует эту последовательность в соответствии с упорядочением, полученным из преобразования неявно заданного упорядочения с помощью функции преобразования.
Примечание: не завершит работу для коллекций бесконечного размера.
Примечание: даже при применении к представлению или ленивой коллекции она всегда заставляет элементы.
Сортировка устойчивая. То есть элементы, которые равны (как определено ord.compare), появляются в том же порядке в отсортированной последовательности, что и в исходной.
- B
целевой тип преобразования
f, и тип, где определено упорядочениеord.- f
функция преобразования, сопоставляющая элементы с какой-либо другой областью
B.- ord
упорядочение, предполагаемое в области
B.- возвращает
последовательность, состоящую из элементов этой последовательности, отсортированных в соответствии с упорядочением, где
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 sortInPlace[B >: T]()(implicit ord: Ordering[B]): IndexedSeq.this.type
Сортирует эту изменяемую последовательность на месте в соответствии с упорядочением.
- ord
упорядочение, используемое для сравнения элементов.
- возвращает
измененная входная изменяемая последовательность, отсортированная в соответствии с упорядочением
ord.
- Definition Classes
- IndexedSeqOps
- См. также
def sortInPlaceBy[B](f: (T) => B)(implicit ord: Ordering[B]): IndexedSeq.this.type
Сортирует эту изменяемую последовательность на месте в соответствии с упорядочением, полученным из преобразования неявно заданного упорядочения с помощью функции преобразования.
- Definition Classes
- IndexedSeqOps
- См. также
def sortInPlaceWith(lt: (T, T) => Boolean): IndexedSeq.this.type
Сортирует этот изменяемый массив на месте в соответствии с функцией сравнения.
- Definition Classes
- IndexedSeqOps
- См. также
def sortWith(lt: (T, T) => Boolean): IndexedSeq[T]
Сортирует эту последовательность в соответствии с функцией сравнения.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: даже при применении к представлению или ленивой коллекции, элементы всегда будут принудительно вычисляться.
Сортировка является устойчивой. То есть элементы, которые равны (как определяется lt), появляются в том же порядке в отсортированной последовательности, что и в исходной.
- lt
функция сравнения, которая проверяет, предшествует ли ее первый аргумент второму аргументу в требуемом порядке.
- возвращает
последовательность, состоящая из элементов этой последовательности, отсортированных в соответствии с функцией сравнения
lt.
- Definition Classes
- SeqOps
List("Steve", "Tom", "John", "Bob").sortWith(_.compareTo(_) < 0) =
List("Bob", "John", "Steve", "Tom")
def sorted[B >: T](implicit ord: Ordering[B]): IndexedSeq[T]
Сортирует эту последовательность в соответствии с Ordering.
Сортировка является устойчивой. То есть элементы, которые равны (как определяется ord.compare), появляются в том же порядке в отсортированной последовательности, что и в исходной.
- ord
упорядочение, используемое для сравнения элементов.
- возвращает
последовательность, состоящая из элементов этой последовательности, отсортированных в соответствии с упорядочением
ord.
- Definition Classes
- SeqOps
- См. также
scala.math.Ordering Примечание: даже при применении к представлению или ленивой коллекции, элементы всегда будут принудительно вычисляться.
def span(p: (T) => Boolean): (IndexedSeq[T], IndexedSeq[T])
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в соответствии с предикатом.
Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- p
предикат проверки
- returns
пара, состоящая из самого длинного префикса этой итерируемой коллекции, элементы которого удовлетворяют условию
p, и остальной части этой итерируемой коллекции.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах.
def splitAt(n: Int): (IndexedSeq[T], IndexedSeq[T])
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в заданной позиции.
Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- n
позиция разделения.
- returns
пара итерируемых коллекций, состоящая из первых
nэлементов этой итерируемой коллекции и других элементов.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах.
def startsWith[B >: T](that: IterableOnce[B], offset: Int = 0): Boolean
Проверяет, содержит ли эта последовательность заданную последовательность в заданном индексе.
Примечание: Если и получатель, и аргумент this являются бесконечными последовательностями, этот метод может не завершиться.
- that
проверяемая последовательность
- offset
индекс, где ищется последовательность.
- returns
true, если последовательностьthatсодержится в этой последовательности по индексуoffset, в противном случаеfalse.
- Definition Classes
- SeqOps
def stepper[S <: Stepper[_]](implicit shape: StepperShape[T, S]): S with EfficientSplit
Возвращает Stepper для элементов этого набора.
Stepper позволяет создать Java поток для обработки коллекции, см. scala.jdk.StreamConverters. Для коллекций, содержащих примитивные значения, Stepper можно использовать как итератор, который не упаковывает элементы.
Неявный параметр StepperShape определяет тип возвращаемого Stepper в соответствии с типом элементов этой коллекции.
-
Для коллекций
Int, Short, Byte или Char возвращается IntStepperДля коллекций Double или Float возвращается DoubleStepperДля коллекций Long возвращается LongStepperДля всех других типов элементов возвращается AnyStepperОбратите внимание, что этот метод переопределяется в подклассах, и тип возвращаемого значения уточняется до S with EfficientSplit, например, IndexedSeqOps.stepper. Для Stepper, помеченных scala.collection.Stepper.EfficientSplit, преобразователи в scala.jdk.StreamConverters позволяют создавать параллельные потоки, тогда как обычные Stepper могут быть преобразованы только в последовательные потоки.
- Definition Classes
- IndexedSeqOps → IterableOnce
def stringPrefix: String
- Attributes
- protected[this]
- Definition Classes
- IndexedSeq → Seq → Iterable
- Annotations
- @deprecatedOverriding("Compatibility override", "2.13.0")
def subSequence(start: Int, end: Int): CharSequence
- Неявный
- Этот член добавлен благодаря неявной конверсии из IndexedSeq[T] в SeqCharSequence, выполненной методом SeqCharSequence в scala.Predef. Эта конверсия будет выполнена только если T является подклассом Char (T <: Char).
- Определяющие классы
- SeqCharSequence → CharSequence
def sum[B >: T](implicit num: math.Numeric[B]): B
Суммирует элементы этого набора.
- B
тип результата оператора
+.- num
неявный параметр, определяющий набор числовых операций, включающий оператор
+, используемый для вычисления суммы.- возвращает
сумма всех элементов этого набора относительно оператора
+вnum.
- Определяющие классы
- IterableOnceOps
final def synchronized[T0](arg0: => T0): T0
- Определяющие классы
- AnyRef
def tail: IndexedSeq[T]
Остальная часть набора без первого элемента.
- Определяющие классы
- IterableOps
def tails: Iterator[IndexedSeq[T]]
Итерируется по хвостам этого набора. Первое значение будет этим набором, а последнее — пустым набором, промежуточные значения — результатом последовательных применений tail.
- возвращает
итератор по всем хвостам этого набора
- Определяющие классы
- IterableOps
List(1,2,3).tails = Iterator(List(1,2,3), List(2,3), List(3), Nil)
def take(n: Int): IndexedSeq[T]
Выбирает первые n элементов.
- n
количество элементов, которые нужно взять из этой последовательности.
- возвращает
последовательность, содержащую только первые
nэлементов этой последовательности, или всю последовательность, если она содержит меньше, чемnэлементов. Еслиnотрицательное, возвращает пустую последовательность.
- Классы-определения
- IndexedSeqOps → IterableOps → IterableOnceOps
- Примечание
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе также.
def takeRight(n: Int): IndexedSeq[T]
Выбирает последние n элементов.
- n
количество элементов, которые нужно взять из этой последовательности.
- возвращает
последовательность, содержащую только последние
nэлементов этой последовательности, или всю последовательность, если она содержит меньше, чемnэлементов. Еслиnотрицательное, возвращает пустую последовательность.
- Классы-определения
- IndexedSeqOps → IterableOps
def takeWhile(p: (T) => Boolean): IndexedSeq[T]
Берет самую длинную префиксную часть элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- p
Предикат для проверки элементов.
- возвращает
самую длинную префиксную часть этой итерируемой коллекции, элементы которой удовлетворяют предикату
p.
- Классы-определения
- IterableOps → IterableOnceOps
def tapEach[U](f: (T) => U): IndexedSeq[T]
Применяет функцию с побочным эффектом к каждому элементу в этом наборе. Строгие коллекции будут применять f к своим элементам немедленно, а ленивые коллекции, такие как Views и LazyLists, будут применять f к каждому элементу только тогда, когда этот элемент будет вычисляться, и каждый раз, когда этот элемент вычисляется.
- U
тип возвращаемого значения f
- f
функция, которую нужно применить к каждому элементу в этой итерируемой коллекции
- returns
Такая же логическая коллекция, как эта
- Definition Classes
- IterableOps → IterableOnceOps
def to[C1](factory: Factory[T, C1]): C1
При заданном фабрике коллекции factory, преобразовать эту коллекцию в соответствующее представление для текущего типа элемента A. Примеры использования:
xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]
- Definition Classes
- IterableOnceOps
def toArray[B >: T](implicit arg0: ClassTag[B]): Array[B]
Преобразовать коллекцию в массив.
- Definition Classes
- IterableOnceOps
final def toBuffer[B >: T]: Buffer[B]
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
def toIndexedSeq: immutable.IndexedSeq[T]
- Definition Classes
- IterableOnceOps
final def toIterable: IndexedSeq.this.type
- возвращает
Это коллекцию в виде
Iterable[A]. Новая коллекция не будет создана, еслиthisуже являетсяIterable[A].
- Классы-определения
- Iterable → IterableOps
def toList: immutable.List[T]
- Классы-определения
- IterableOnceOps
def toMap[K, V](implicit ev: <:<[T, (K, V)]): immutable.Map[K, V]
- Классы-определения
- IterableOnceOps
def toSeq: immutable.Seq[T]
- возвращает
Это коллекцию в виде
Seq[A]. Это эквивалентноto(Seq), но может быть быстрее.
- Классы-определения
- IterableOnceOps
def toSet[B >: T]: immutable.Set[B]
- Классы-определения
- IterableOnceOps
def toString(): String
Создаёт строковое представление этого объекта. В платформе Java это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.
- возвращает
Строковое представление объекта.
def toVector: immutable.Vector[T]
- Definition Classes
- IterableOnceOps
def transpose[B](implicit asIterable: (T) => collection.Iterable[B]): IndexedSeq[IndexedSeq[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 unapply(a: Int): Option[T]
Пытается извлечь B из A в выражении сопоставления с образцом.
- Definition Classes
- PartialFunction
def unlift: PartialFunction[Int, B]
Преобразует необязательную функцию в частичную функцию.
- Implicit
- Этот член добавляется с помощью неявного преобразования из IndexedSeq[T] вUnliftOps[Int, B] производимое методом UnliftOps в scala.Function1. Это преобразование будет происходить только если T является подклассом Option[B] (T <: Option[B]).
- Definition Classes
- UnliftOps
В отличие от Function.unlift, этот метод UnliftOps.unlift может использоваться в экстракторах.
val of: Int => Option[String] = { i =>
if (i == 2) {
Some("matched by an optional function")
} else {
None
}
}
util.Random.nextInt(4) match {
case of.unlift(m) => // Convert an optional function to a pattern
println(m)
case _ =>
println("Not matched")
}
def unzip[A1, A2](implicit asPair: (T) => (A1, A2)): (IndexedSeq[A1], IndexedSeq[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: (T) => (A1, A2, A3)): (IndexedSeq[A1], IndexedSeq[A2], IndexedSeq[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 >: T](index: Int, elem: B): IndexedSeq[B]
Копия этой последовательности с одним заменённым элементом.
- B
тип элемента возвращаемой последовательности.
- index
позиция замены
- elem
заменяемый элемент
- returns
новая последовательность, являющаяся копией этой последовательности с элементом в позиции
index, заменённым наelem.
- Definition Classes
- SeqOps
- Exceptions thrown
IndexOutOfBoundsException, еслиindexне удовлетворяет0 <= index < length. В случае ленивой коллекции это исключение может быть выброшено позже или вообще не выброшено (если конец коллекции никогда не оценивается).
def view: IndexedSeqView[T]
Представление элементов этой коллекции.
- Definition Classes
- IndexedSeqOps → SeqOps → IterableOps
final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long): Unit
def withFilter(p: (T) => Boolean): WithFilter[T, [_]IndexedSeq[_]]
Создаёт нестрогий фильтр этого итерируемого набора.
Примечание: разница между 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]): IndexedSeq[(T, B)]
Возвращает итерируемый набор, сформированный из этого итерируемого набора и другого итерируемого набора путём объединения соответствующих элементов в пары. Если один из двух наборов длиннее другого, оставшиеся элементы игнорируются.
- B
тип второй половины возвращаемых пар
- that
Итерируемый набор, предоставляющий вторую половину каждой пары результата
- returns
новый итерируемый набор, содержащий пары, состоящие из соответствующих элементов этого итерируемого набора и
that. Длина возвращаемого набора — это минимум из длин этого итерируемого набора иthat.
- Definition Classes
- IterableOps
def zipAll[A1 >: T, B](that: collection.Iterable[B], thisElem: A1, thatElem: B): IndexedSeq[(A1, B)]
Возвращает итерируемую коллекцию, образованную из этой итерируемой коллекции и другой итерируемой коллекции, объединяя соответствующие элементы парами. Если одна из двух коллекций короче другой, элементы-заполнители используются для расширения более короткой коллекции до длины более длинной.
- that
итерируемая коллекция, предоставляющая вторую половину каждой пары результата
- thisElem
элемент, используемый для заполнения результата, если эта итерируемая коллекция короче
that.- thatElem
элемент, используемый для заполнения результата, если
thatкороче этой итерируемой коллекции.- returns
новая коллекция типа
That, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции иthat. Длина возвращаемой коллекции равна максимальной из длин этой итерируемой коллекции иthat. Если эта итерируемая коллекция корочеthat, значенияthisElemиспользуются для заполнения результата. Еслиthatкороче этой итерируемой коллекции, значенияthatElemиспользуются для заполнения результата.
- Definition Classes
- IterableOps
def zipWithIndex: IndexedSeq[(T, Int)]
Объединяет эту итерируемую коллекцию с её индексами.
- returns
Новая итерируемая коллекция, содержащая пары, состоящие из всех элементов этой итерируемой коллекции, спаренных с их индексом. Индексы начинаются с
0.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода следует отбросить итератор, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора неопределённо, может быть изменено и может привести к изменениям в новом итераторе тоже.
List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))
Затенённые неявные члены значения
def length(): Int
- Неявный
- Этот член добавляется неявным преобразованием из IndexedSeq[T] вSeqCharSequence, выполняемым методом SeqCharSequence в scala.Predef.Это преобразование будет выполнено только в том случае, если T является подклассом Char (T <: Char).
- Затенение
- Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(indexedSeq: SeqCharSequence).length()
- Определяющие классы
- SeqCharSequence → CharSequence
def toString(): String
Создаёт строковое представление этого объекта. Представление по умолчанию зависит от платформы. На платформе Java это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.
- возвращает
строковое представление объекта.
- Неявный
- Этот член добавляется неявным преобразованием из IndexedSeq[T] вSeqCharSequence, выполняемым методом SeqCharSequence в scala.Predef.Это преобразование будет выполнено только в том случае, если T является подклассом Char (T <: Char).
- Затенение
- Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(indexedSeq: SeqCharSequence).toString()
- Определяющие классы
- SeqCharSequence → CharSequence → AnyRef → Any
© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.13.0/scala/collection/mutable/IndexedSeq.html