Класс scala.collection.View.LeftPartitionMapped
класс LeftPartitionMapped[A, A1, A2] extends AbstractView[A1]
- Аннотации
- @SerialVersionUID()
- Источник
- View.scala
- Линейные супертипы
- AbstractView[A1], View[A1], java.io.Serializable, AbstractIterable[A1], Iterable[A1], IterableFactoryDefaults[A1, [x]View[x]], IterableOps[A1, [_]View[_], View[A1]], IterableOnceOps[A1, [_]View[_], View[A1]], IterableOnce[A1], AnyRef, Any
Конструкторы экземпляров
новый LeftPartitionMapped(underlying: SomeIterableOps[A], f: (A) => Either[A1, A2])
Члены-значения
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- возвращает
trueесли !(this == that), в противном случае false.
- Определяющие классы
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для чисел возвращает хэш-значение, согласованное с равенством значений: если две экземпляра типов значений сравниваются как true, то ## будет генерировать одинаковое хэш-значение для каждого из них. Для null возвращает хэш-код, где null.hashCode вызывает NullPointerException.
- возвращает
хэш-значение, согласованное с ==
- Определяющие классы
- AnyRef → Any
def +(other: String): String
- Неявный
- Этот член добавлен с помощью неявного преобразования из LeftPartitionMapped[A, A1, A2] вany2stringadd[LeftPartitionMapped[A, A1, A2]] с помощью метода any2stringadd в scala.Predef.
- Определяющие классы
- any2stringadd
final def ++[B >: A1](suffix: IterableOnce[B]): View[B]
Псевдоним для concat
- Определяющие классы
- IterableOps
- Аннотации
- @inline()
def ->[B](y: B): (LeftPartitionMapped[A, A1, A2], B)
- Неявный
- Этот член добавлен с помощью неявного преобразования из LeftPartitionMapped[A, A1, A2] вArrowAssoc[LeftPartitionMapped[A, A1, A2]] с помощью метода ArrowAssoc в scala.Predef.
- Определяющие классы
- ArrowAssoc
- Аннотации
- @inline()
final def ==(arg0: Any): Boolean
Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).
- возвращает
trueесли объект-получатель эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- AnyRef → Any
final def addString(b: mutable.StringBuilder): mutable.StringBuilder
Добавляет все элементы этой коллекции в буфер строк. Текст, который записывается, состоит из строковых представлений (с учетом метода toString) всех элементов этой коллекции без разделительной строки.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> val h = a.addString(b) h: StringBuilder = 1234
- b
буфер строк, в который добавляются элементы.
- возвращает
буфер строк
b, в который были добавлены элементы.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
final def addString(b: mutable.StringBuilder, sep: String): mutable.StringBuilder
Добавляет все элементы этого набора в строку с помощью разделительной строки. Текст, который будет записан, состоит из строковых представлений (относительно метода toString) всех элементов этого набора, разделенных строкой sep.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> a.addString(b, ", ") res0: StringBuilder = 1, 2, 3, 4
- b
строка, в которую добавляются элементы.
- sep
разделительная строка.
- returns
строка
b, в которую были добавлены элементы.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
def addString(b: mutable.StringBuilder, start: String, sep: String, end: String): mutable.StringBuilder
Добавляет все элементы этого набора в строку с помощью начальной, конечной и разделительных строк. Записанный текст начинается со строки start и заканчивается строкой end. Внутри строковые представления (относительно метода toString) всех элементов этого набора разделены строкой sep.
Пример:
scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)
scala> val b = new StringBuilder()
b: StringBuilder =
scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
- b
строка, в которую добавляются элементы.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
строка
b, в которую были добавлены элементы.
- Definition Classes
- IterableOnceOps
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 className: String
Определяет префикс представления этого объекта toString.
Рекомендуется возвращать имя конкретного типа коллекции, а не подклассы реализации. Например, для ListMap этот метод должен возвращать "ListMap", а не "Map" (супертип) или "Node" (подкласс реализации).
По умолчанию возвращает "Iterable". Он переопределен для основных типов коллекций "Seq", "IndexedSeq", "LinearSeq", "Buffer", "Set", "Map", "SortedSet", "SortedMap" и "View".
- returns
строковое представление, которое начинает результат применения
toStringк этой итерируемой коллекции. По умолчанию префикс строки — простое имя класса коллекции — итерируемой коллекции.
- Attributes
- protected[this]
- Definition Classes
- Iterable
def clone(): AnyRef
Создает копию получаемого объекта.
По умолчанию реализация метода clone зависит от платформы.
- returns
копия получаемого объекта.
final def coll: LeftPartitionMapped.this.type
- returns
Эта коллекция как
C.
- Attributes
- protected
- Definition Classes
- Iterable → IterableOps
def collect[B](pf: PartialFunction[A1, B]): View[B]
Создает новую итерируемую коллекцию, применяя частичную функцию ко всем элементам этой итерируемой коллекции, для которых функция определена.
- B
тип элемента возвращаемой итерируемой коллекции.
- pf
частичная функция, которая фильтрует и отображает итерируемую коллекцию.
- returns
новая итерируемая коллекция, полученная в результате применения заданной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Использование: После вызова этого метода необходимо выбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе также.
def collectFirst[B](pf: PartialFunction[A1, B]): Option[B]
Находит первый элемент в коллекции, для которого заданная частичная функция определена, и применяет частичную функцию к нему.
Примечание: может не завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не упорядочен.
- pf
частичная функция
- возвращает
значение Option, содержащее результат применения pf к первому значению, для которого оно определено, или
Noneесли такого значения нет.
- Определяющие классы
- IterableOnceOps
Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)
def concat[B >: A1](suffix: IterableOnce[B]): View[B]
Возвращает новую итерируемую коллекцию, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элементов итерируемой коллекции — это наиболее специфичный суперкласс, охватывающий типы элементов двух операндов.
- B
тип элементов возвращаемой коллекции.
- suffix
перебираемый объект для добавления.
- возвращает
новая итерируемая коллекция, которая содержит все элементы этой итерируемой коллекции, за которыми следуют все элементы
suffix.
- Определяющие классы
- IterableOps
def copyToArray[B >: A1](xs: Array[B], start: Int, len: Int): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет заданный массив xs начиная с индекса start не более чем len элементами этой коллекции.
Копирование остановится, как только будут скопированы все элементы этой коллекции, или будет достигнут конец массива, или len элементов.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- len
максимальное количество копируемых элементов.
- возвращает
количество элементов, записанных в массив
- Определяющие классы
- IterableOnceOps
- Примечание
Повторное использование: После вызова этого метода следует удалить вызываемый итератор. Его использование не определено и может быть изменено. Примечание: не завершится для коллекций бесконечного размера.
def copyToArray[B >: A1](xs: Array[B], start: Int): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет заданный массив xs начиная с индекса start значениями этой коллекции.
Копирование остановится, как только будут скопированы все элементы этой коллекции или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- возвращает
количество элементов, записанных в массив. Примечание: не завершится для коллекций бесконечного размера.
- Определяющие классы
- IterableOnceOps
def copyToArray[B >: A1](xs: Array[B]): Int
Копирует элементы в массив, возвращая количество скопированных элементов.
Заполняет заданный массив xs начиная с индекса start значениями этой коллекции.
Копирование остановится, как только будут скопированы все элементы этой коллекции или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- возвращает
количество элементов, записанных в массив. Примечание: не завершится для коллекций бесконечного размера.
- Определяющие классы
- IterableOnceOps
def corresponds[B](that: IterableOnce[B])(p: (A1, B) => Boolean): Boolean
Проверяет, соответствует ли каждый элемент итератора этой коллекции соответствующему элементу другой коллекции, удовлетворяя условию проверки.
- B
тип элементов
that- that
другая коллекция
- p
условие проверки, которое сопоставляет элементы обеих коллекций
- возвращает
trueесли обе коллекции имеют одинаковую длину иp(x, y)равноtrueдля всех соответствующих элементовxэтого итератора иythat, в противном случаеfalse
- Определяющие классы
- IterableOnceOps
def count(p: (A1) => Boolean): Int
Подсчитывает количество элементов в коллекции, удовлетворяющих заданному предикату.
- p
предикат, используемый для проверки элементов.
- возвращает
количество элементов, удовлетворяющих предикату
p.
- Определяющие классы
- IterableOnceOps
def drop(n: Int): View[A1]
Выбирает все элементы, кроме первых n.
Примечание: может возвращать разные результаты при разных запусках, если тип базового набора не упорядочен.
- n
количество элементов для удаления из этого итерируемого набора.
- returns
итерируемый набор, состоящий из всех элементов этого итерируемого набора, кроме первых
nэлементов, или пустой итерируемый набор, если этот итерируемый набор содержит меньшеnэлементов. Еслиnотрицательно, то элементы не удаляются.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределённо, может измениться, и может привести к изменениям в новом итераторе тоже.
def dropRight(n: Int): View[A1]
Выбирает все элементы, кроме последних n.
Примечание: может возвращать разные результаты при разных запусках, если тип базового набора не упорядочен.
- n
количество элементов для удаления из этого итерируемого набора.
- returns
итерируемый набор, состоящий из всех элементов этого итерируемого набора, кроме последних
nэлементов, или пустой итерируемый набор, если этот итерируемый набор содержит меньшеnэлементов. Еслиnотрицательно, то элементы не удаляются.
- Definition Classes
- IterableOps
def dropWhile(p: (A1) => Boolean): View[A1]
Удаляет самое длинное префиксное подмножество элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты при разных запусках, если тип базового набора не упорядочен.
- p
Предикат для проверки элементов.
- returns
самое длинное суффиксное подмножество этого итерируемого набора, первый элемент которого не удовлетворяет предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода необходимо удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора неопределённо, может измениться, и может привести к изменениям в новом итераторе тоже.
def empty: View[A1]
Пустой итерируемый набор того же типа, что и этот итерируемый набор
- returns
пустой итерируемый набор типа
C.
- Definition Classes
- View → IterableFactoryDefaults → IterableOps
def ensuring(cond: (LeftPartitionMapped[A, A1, A2]) => Boolean, msg: => Any): LeftPartitionMapped[A, A1, A2]
- Неявный
- Этот член добавлен неявным преобразованием из LeftPartitionMapped[A, A1, A2] к Ensuring[LeftPartitionMapped[A, A1, A2]] выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (LeftPartitionMapped[A, A1, A2]) => Boolean): LeftPartitionMapped[A, A1, A2]
- Неявный
- Этот член добавлен неявным преобразованием из LeftPartitionMapped[A, A1, A2] к Ensuring[LeftPartitionMapped[A, A1, A2]] выполненным методом Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: => Any): LeftPartitionMapped[A, A1, A2]
- Неявный
- Этот член добавлен неявным преобразованием из LeftPartitionMapped[A, A1, A2] к Ensuring[LeftPartitionMapped[A, A1, A2]] при помощи метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
def ensuring(cond: Boolean): LeftPartitionMapped[A, A1, A2]
- Неявный
- Этот член добавлен неявным преобразованием из LeftPartitionMapped[A, A1, A2] к Ensuring[LeftPartitionMapped[A, A1, A2]] при помощи метода Ensuring в scala.Predef.
- Определяющие классы
- Ensuring
final def eq(arg0: AnyRef): Boolean
Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).
Метод eq реализует отношение эквивалентности на не-null экземплярах AnyRef, и имеет три дополнительных свойства:
-
Он согласован: для любых не-null экземпляров
x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false.Для любого не-null экземпляра x типа AnyRef, вызовы x.eq(null) и null.eq(x) возвращают false.
null.eq(null) возвращает true.
При переопределении методов equals или hashCode важно обеспечить согласованность их поведения с равенством ссылок. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и должны иметь одинаковый хэш-код (o1.hashCode == o2.hashCode).
- возвращает
trueесли аргумент является ссылкой на объект-получатель;falseв противном случае.
- Определяющие классы
- AnyRef
def equals(arg0: AnyRef): Boolean
Метод равенства для ссылочных типов. Реализация по умолчанию делегирует вызов к eq.
См. также equals в scala.Any.
- возвращает
trueесли объект-получатель эквивалентен аргументу;falseв противном случае.
- Определяющие классы
- AnyRef → Any
def exists(p: (A1) => Boolean): Boolean
Проверяет, удовлетворяет ли хотя бы один элемент этого набора данных заданному предикату.
Примечание: может не завершиться для наборов данных бесконечного размера.
- p
предикат для проверки элементов.
- возвращает
trueесли заданный предикатpудовлетворяется по крайней мере одним элементом этого набора данных, в противном случаеfalse
- Определяющие классы
- IterableOnceOps
def filter(pred: (A1) => Boolean): View[A1]
Выбирает все элементы этого итерируемого набора данных, которые удовлетворяют предикату.
- возвращает
новый итератор, содержащий все элементы этого итерируемого набора данных, которые удовлетворяют заданному предикату
p. Порядок элементов сохраняется.
- Определяющие классы
- IterableOps → IterableOnceOps
def filterNot(pred: (A1) => Boolean): View[A1]
Выбирает все элементы этого итерируемого набора данных, которые не удовлетворяют предикату.
- pred
предикат для проверки элементов.
- возвращает
новый итерируемый набор данных, содержащий все элементы этого итерируемого набора данных, которые не удовлетворяют заданному предикату
pred. Порядок элементов может не сохраняться.
- Определяющие классы
- IterableOps → IterableOnceOps
def finalize(): Unit
Вызывается сборщиком мусора для объекта-получателя, когда больше нет ссылок на объект.
Подробности о том, когда и вызывается метод finalize, а также взаимодействие между finalize и нелокальными возвратами и исключениями, зависят от платформы.
def find(p: (A1) => Boolean): Option[A1]
Находит первый элемент коллекции, удовлетворяющий предикату, если таковой существует.
Примечание: может не завершиться для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции не упорядочен.
- p
предикат для проверки элементов.
- возвращает
значение Option, содержащее первый элемент в коллекции, удовлетворяющий
p, илиNoneесли такого элемента нет.
- Определяющие классы
- IterableOnceOps
def flatMap[B](f: (A1) => IterableOnce[B]): View[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
функция, применяемая к каждому элементу.
- возвращает
новая итерируемая коллекция, полученная в результате применения заданной функции, возвращающей коллекцию
fк каждому элементу этой итерируемой коллекции и конкатенации результатов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращён. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def flatten[B](implicit asIterable: (A1) => IterableOnce[B]): View[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.- возвращает
новая итерируемая коллекция, полученная путем конкатенации всех коллекций элементов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только итератор, который был возвращён. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def fold[A1 >: A1](z: A1)(op: (A1, A1) => A1): A1
Складывает элементы этой коллекции, используя указанный ассоциативный бинарный оператор. Реализация по умолчанию в IterableOnce эквивалентна foldLeft, но может быть переопределена для более эффективных порядков обхода.
Порядок выполнения операций над элементами не определён и может быть не детерминированным.
Примечание: не завершится для бесконечных коллекций.
- A1
параметр типа для бинарного оператора, надтип
A.- z
нейтральный элемент для операции сложения; может быть добавлен к результату произвольное количество раз и не должен изменять результат (например,
Nilдля конкатенации списков, 0 для сложения или 1 для умножения).- op
бинарный оператор, который должен быть ассоциативным.
- возвращает
результат применения оператора сложения
opмежду всеми элементами иz, илиzесли эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def foldLeft[B](z: B)(op: (B, A1) => B): B
Применяет бинарный оператор к начальному значению и всем элементам этой коллекции, слева направо.
Примечание: не завершится для бесконечных коллекций.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции упорядочен или оператор ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- возвращает
-
результат вставки
opмежду последовательными элементами этой коллекции, слева направо, с начальным значениемzслева:op(...op(z, x_1), x_2, ..., x_n)
где
x1, ..., xn- элементы этой коллекции. Возвращаетzесли эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def foldRight[B](z: B)(op: (A1, B) => B): B
Применяет бинарный оператор ко всем элементам этого набора и начальному значению, двигаясь справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- возвращает
-
результат вставки
opмежду последовательными элементами этой коллекции, двигаясь справа налево со значением началаzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xn— это элементы этой коллекции. Возвращаетz, если эта коллекция пуста.
- Definition Classes
- IterableOnceOps
def forall(p: (A1) => Boolean): Boolean
Проверяет, выполняется ли предикат для всех элементов этой коллекции.
Примечание: может не завершаться для коллекций бесконечного размера.
- p
предикат, используемый для проверки элементов.
- возвращает
true, если эта коллекция пуста или заданный предикатpвыполняется для всех элементов этой коллекции, в противном случаеfalse.
- Definition Classes
- IterableOnceOps
def foreach[U](f: (A1) => U): Unit
Применяет f к каждому элементу для побочных эффектов. Примечание: параметр [U] необходим для помощи в выводе типов scalac.
- Definition Classes
- IterableOnceOps
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с данной строкой format. Форматные строки аналогичны для String.format (@см. java.lang.String.format).
- Неявный
- Этот член добавлен с помощью неявного преобразования из LeftPartitionMapped[A, A1, A2] к StringFormat[LeftPartitionMapped[A, A1, A2]] выполненного методом StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Аннотации
- @inline()
def fromSpecific(coll: IterableOnce[A1]): View[A1]
Определяет, как преобразовать заданный Iterable[A] в коллекцию типа C.
Этот процесс можно выполнить строго или нестрого (т. е. без вычисления элементов результирующих коллекций). Другими словами, этот метод определяет модель вычисления коллекции.
- Атрибуты
- protected
- Definition Classes
- IterableFactoryDefaults → IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В обычном случае, гдеC =:= CC[A], это можно сделать, добавив в класс trait IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как свидетельствует аннотация
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, пока он вызывается со значениемIterable[A]полученным от коллекцииthis(как это происходит в реализациях операций, где мы используемView[A]), он безопасен.
final def getClass(): Class[_ <: AnyRef]
Возвращает представление runtime класса объекта.
- возвращает
объект класса, соответствующий типу runtime получателя.
def groupBy[K](f: (A1) => K): immutable.Map[K, View[A1]]
Разбивает эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с некоторой функцией-дискриминатором.
Примечание: даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно загружаться.
- 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: (A1) => K)(f: (A1) => B): immutable.Map[K, View[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: (A1) => K)(f: (A1) => B)(reduce: (B, B) => B): immutable.Map[K, B]
Разбивает эту итерируемую коллекцию на карту в соответствии с функцией-дискриминатором key. Все значения, имеющие одинаковый дискриминатор, затем преобразуются функцией value и затем сводятся к одному значению с помощью функции reduce.
Эквивалентно groupBy(key).mapValues(_.map(f).reduce(reduce)), но более эффективно.
def occurrences[A](as: Seq[A]): Map[A, Int] = as.groupMapReduce(identity)(_ => 1)(_ + _)
Примечание: даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно загружаться.
- Definition Classes
- IterableOps
def grouped(size: Int): Iterator[View[A1]]
Разбивает элементы на итерируемые коллекции фиксированного размера.
- size
количество элементов в каждой группе
- returns
Итератор, генерирующий итерируемые коллекции размером
size, за исключением последней, которая будет меньше sizesize, если элементы не делятся равномерно.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
grouped
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- returns
значение хэш-кода для этого объекта.
def head: A1
Выбирает первый элемент этой итерируемой коллекции.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции.
- Definition Classes
- IterableOps
- Исключения
NoSuchElementException, если итерируемая коллекция пуста.
def headOption: Option[A1]
Возвращает первый элемент, если он есть.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции, если она непустая,
Noneесли она пустая.
- Definition Classes
- IterableOps
def init: View[A1]
Часть коллекции без её последнего элемента.
Примечание: даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно загружаться.
- Definition Classes
- IterableOps
def inits: Iterator[View[A1]]
Перебирает инициализации этого итерируемого набора. Первое значение будет этим итерируемым набором, а последнее — пустым итерируемым набором, а промежуточные значения — результатами последовательных применений init.
Примечание: даже при применении к представлению или ленивому набору он всегда принуждает элементы.
- returns
итератор по всем инициализациям этого итерируемого набора
- Definition Classes
- IterableOps
List(1,2,3).inits = Iterator(List(1,2,3), List(1,2), List(1), Nil)
def isEmpty: Boolean
Проверяет, пуст ли набор.
Примечание: реализации в подклассах, которые не являются многократно проходимыми, должны позаботиться о том, чтобы не потреблять какие-либо элементы, когда isEmpty вызывается.
- returns
trueесли набор не содержит элементов,falseв противном случае.
- Definition Classes
- 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
Проверяет, можно ли многократно пройтись по этому итерируемому набору. Всегда истинно для Iterable и ложно для Iterator, если не переопределено.
- returns
trueесли набор можно многократно пройти,falseв противном случае.
- Definition Classes
- IterableOps → IterableOnceOps
def iterableFactory: IterableFactory[View]
Компаньон-объект этого представления, предоставляющий различные методы фабрики.
- Definition Classes
- View → Iterable → IterableOps
- Note
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа этот метод необходимо переопределить, чтобы вернуть фабрику для нового типа (в противном случае компилятор выдаст ошибку).
def iterator: AbstractIterator[A1]
Итератор можно использовать только один раз
- Definition Classes
- LeftPartitionMapped → IterableOnce
def knownSize: Int
- returns
Количество элементов в этом наборе, если его можно вычислить с малой стоимостью, в противном случае -1. Малая стоимость обычно означает: Не требуется обход коллекции.
- Definition Classes
- IterableOnce
def last: A1
Выбирает последний элемент.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- returns
Последний элемент этого итерируемого набора.
- Definition Classes
- IterableOps
- Exceptions thrown
NoSuchElementExceptionЕсли итерируемый набор пуст.
def lastOption: Option[A1]
Возвращает необязательный последний элемент.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- returns
последний элемент этого итерируемого набора, если он не пуст,
Noneесли он пуст.
- Definition Classes
- IterableOps
def lazyZip[B](that: Iterable[B]): LazyZip2[A1, B, LeftPartitionMapped.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
def map[B](f: (A1) => B): View[B]
Построение новой итерируемой коллекции путем применения функции ко всем элементам этой итерируемой коллекции.
- B
тип элемента возвращаемой итерируемой коллекции.
- f
функция, применяемая к каждому элементу.
- returns
новая итерируемая коллекция, полученная в результате применения данной функции
fк каждому элементу этой итерируемой коллекции и сбора результатов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, к которому он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def max[B >: A1](implicit ord: math.Ordering[B]): A1
Находит наибольший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
наибольший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def maxBy[B](f: (A1) => B)(implicit cmp: math.Ordering[B]): A1
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Измерительная функция.
- cmp
Порядок, используемый для сравнения элементов.
- returns
первый элемент этой коллекции с наибольшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def maxByOption[B](f: (A1) => B)(implicit cmp: math.Ordering[B]): Option[A1]
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Измерительная функция.
- cmp
Порядок, используемый для сравнения элементов.
- returns
необязательное значение, содержащее первый элемент этой коллекции с наибольшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
def maxOption[B >: A1](implicit ord: math.Ordering[B]): Option[A1]
Находит наибольший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
необязательное значение, содержащее наибольший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
def min[B >: A1](implicit ord: math.Ordering[B]): A1
Находит наименьший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
наименьший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def minBy[B](f: (A1) => B)(implicit cmp: math.Ordering[B]): A1
Находит первый элемент, который дает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Измерительная функция.
- cmp
Порядок, используемый для сравнения элементов.
- returns
первый элемент этой коллекции с наименьшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def minByOption[B](f: (A1) => B)(implicit cmp: scala.math.Ordering[B]): scala.Option[A1]
Находит первый элемент, который дает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
значение Option, содержащее первый элемент этого набора с наименьшим значением, измеренным функцией f в соответствии с порядком
cmp.
- Definition Classes
- IterableOnceOps
def minOption[B >: A1](implicit ord: scala.math.Ordering[B]): scala.Option[A1]
Находит наименьший элемент.
- B
Тип, по которому определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
значение Option, содержащее наименьший элемент этого набора с точки зрения порядка
ord.
- Definition Classes
- IterableOnceOps
final def mkString: String
Отображает все элементы этого набора в строке.
Делегирует addString, который может быть переопределен.
- returns
строковое представление этого набора. В результирующей строке строковые представления (в соответствии с методом
toString) всех элементов этого набора следуют друг за другом без разделительной строки.
- Definition Classes
- IterableOnceOps
- Annotations
- @scala.inline()
final def mkString(sep: String): String
Отображает все элементы этого набора в строке с использованием разделительной строки.
Делегирует addString, который может быть переопределен.
- sep
разделительная строка.
- returns
строковое представление этого набора. В результирующей строке строковые представления (в соответствии с методом
toString) всех элементов этого набора разделены строкойsep.
- Definition Classes
- IterableOnceOps
- Annotations
- @scala.inline()
List(1, 2, 3).mkString("|") = "1|2|3"
final def mkString(start: String, sep: String, end: String): String
Отображает все элементы этого набора в строке с использованием начальной, конечной и разделительной строк.
Делегирует addString, который может быть переопределен.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
строковое представление этого набора. Результирующая строка начинается со строки
startи заканчивается строкойend. Внутри строковые представления (в соответствии с методомtoString) всех элементов этого набора разделены строкойsep.
- Definition Classes
- IterableOnceOps
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
final def ne(arg0: scala.AnyRef): scala.Boolean
Эквивалентно !(this eq that).
- returns
true, если аргумент не является ссылкой на объект-получатель;falseв противном случае.
- Definition Classes
- AnyRef
def newSpecificBuilder: scala.collection.mutable.Builder[A1, scala.collection.View[A1]]
- returns
строгий билдер для того же типа коллекции. Обратите внимание, что в случае ленивых коллекций (например, scala.collection.View или scala.collection.immutable.LazyList), реализовать этот метод возможно, но полученный
Builderнарушит ленивость. В результате, операции предпочтительнее реализовывать с помощьюfromSpecificвместо этого метода.
- Attributes
- protected
- Definition Classes
- IterableFactoryDefaults → IterableOps
- Note
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод необходимо переопределить (иначе компилятор выдаст ошибку). В обычном случае, когдаC =:= CC[A], это можно сделать, смешав трайт IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как видно из аннотации
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, до тех пор, пока возвращаемый билдер получает только значенияAизthisэкземпляра, он безопасен.
def nonEmpty: Boolean
Проверяет, не является ли коллекция пустой.
- returns
trueесли коллекция содержит по меньшей мере один элемент,falseв противном случае.
- Definition Classes
- IterableOnceOps
- Annotations
- @deprecatedOverriding("nonEmpty is defined as !isEmpty; override isEmpty instead", "2.13.0")
final def notify(): Unit
Разбуживает один поток, ожидающий монитора объекта-получателя.
- Definition Classes
- AnyRef
- Annotations
- @native()
- Note
не указано SLS в качестве члена AnyRef
final def notifyAll(): Unit
Разбуживает все потоки, ожидающие монитора объекта-получателя.
- Definition Classes
- AnyRef
- Annotations
- @native()
- Note
не указано SLS в качестве члена AnyRef
def partition(p: (A1) => Boolean): (View[A1], View[A1])
Пара, в которой первый элемент содержит все элементы, удовлетворяющие предикату p, а второй - все остальные. Это интересно, поскольку это разделяет коллекцию на две части.
Предоставленная здесь реализация по умолчанию требует двух проходов по коллекции. Строгие коллекции имеют переопределённую версию partition в StrictOptimizedIterableOps, которая требует только одного прохода.
- Definition Classes
- IterableOps
def partitionMap[A1, A2](f: (A1) => Either[A1, A2]): (View[A1], View[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 product[B >: A1](implicit num: math.Numeric[B]): B
Перемножает элементы этой коллекции.
- B
тип результата операции
*.- num
явный параметр, определяющий набор операций с числами, включая операцию
*, используемую для вычисления произведения.- returns
произведение всех элементов этой коллекции относительно операции
*вnum.
- Definition Classes
- IterableOnceOps
def reduce[B >: A1](op: (B, B) => B): B
Применяет операцию к элементам коллекции.
Порядок выполнения операций над элементами не определён и может быть не детерминированным.
- B
Тип параметра для бинарной операции, надтип
A.- op
Бинарная операция, которая должна быть ассоциативной.
- returns
Результат применения оператора
opмежду всеми элементами, если коллекция не пуста.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationException, если коллекция пуста.
def reduceLeft[B >: A1](op: (B, A1) => 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 >: A1](op: (B, A1) => B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого набора, слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение опционального типа, содержащее результат
reduceLeft(op), если этот набор не пуст,Noneв противном случае.
- Definition Classes
- IterableOnceOps
def reduceOption[B >: A1](op: (B, B) => B): Option[B]
Сводит элементы этой коллекции, если они есть, используя указанный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
- B
Параметр типа для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Значение типа Option, содержащее результат применения оператора reduce
opмежду всеми элементами, если коллекция не пуста, иNoneв противном случае.
- Definition Classes
- IterableOnceOps
def reduceRight[B >: A1](op: (A1, B) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, справа налево:op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))где
x1, ..., xn- элементы этой коллекции.
- Definition Classes
- IterableOnceOps
- Исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceRightOption[B >: A1](op: (A1, B) => B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого набора, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение типа Option, содержащее результат
reduceRight(op)если этот набор не пуст,Noneв противном случае.
- Definition Classes
- IterableOnceOps
def reversed: Iterable[A1]
- Атрибуты
- protected
- Definition Classes
- IterableOnceOps
def scan[B >: A1](z: B)(op: (B, B) => B): View[B]
Вычисляет префиксный скан элементов коллекции.
Примечание: Нейтральный элемент z может применяться более одного раза.
- B
тип элементов результирующей коллекции
- z
нейтральный элемент для оператора
op- op
ассоциативный оператор для сканирования
- returns
новая итерируемая коллекция, содержащая префиксный скан элементов в этой итерируемой коллекции
- Definition Classes
- IterableOps
def scanLeft[B](z: B)(op: (B, A1) => B): View[B]
Создаёт итерируемую коллекцию, содержащую накопительные результаты применения оператора слева направо, включая начальное значение.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был применен, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def scanRight[B](z: B)(op: (A1, B) => B): View[B]
Создаёт коллекцию, содержащую накопительные результаты применения оператора справа налево. Заголовок коллекции — последний накопительный результат.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
Примечание: Даже при применении к представлению или ленивой коллекции он всегда будет принудительно обрабатывать элементы.
Пример:
List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Определяющие классы
- IterableOps
def size: Int
Размер этой коллекции.
Примечание: не завершится для коллекций бесконечного размера.
- returns
число элементов в этой коллекции.
- Определяющие классы
- IterableOnceOps
def sizeCompare(that: Iterable[_]): Int
Сравнивает размер этой итерируемой коллекции с размером другой Iterable.
- that
Iterable, размер которой сравнивается с размером этой итерируемой коллекции.- returns
-
Значение
x, гдеx < 0 if this.size < that.size x == 0 if this.size == that.size x > 0 if this.size > that.size
Реализация этого метода не вызывает
sizeнапрямую; его время выполнения составляетO(this.size min that.size)вместоO(this.size + that.size). Метод должен быть переопределен, если вычислениеsizeявляется недорогим, иknownSizeвозвращает-1.
- Определяющие классы
- IterableOps
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.
- Определяющие классы
- IterableOps
- См. также
final def sizeIs: SizeCompareOps
Возвращает value class, содержащий операции для сравнения размера этой итерируемой коллекции с тестовым значением.
Эти операции реализованы на основе 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
- Определяющие классы
- IterableOps
- Аннотации
- @inline()
def slice(from: Int, until: Int): View[A1]
Выбирает интервал элементов. Возвращаемая итерируемая коллекция состоит из всех элементов x, которые удовлетворяют инварианту:
from <= indexOf(x) < until
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- from
наименьший индекс, который нужно включить из этой итерируемой коллекции.
- until
наименьший индекс, который нужно ИСКЛЮЧИТЬ из этой итерируемой коллекции.
- returns
итерируемая коллекция, содержащая элементы, большие или равные индексу
from, простирающиеся до (но не включая) индексuntilэтой итерируемой коллекции.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был применен, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def sliding(size: Int, step: Int): Iterator[View[A1]]
Группирует элементы в блоки фиксированного размера, пропуская "скользящее окно" по ним (в отличие от разбиения на части, как это делается в grouped.)
- size
количество элементов в группе
- step
расстояние между первыми элементами последовательных групп
- returns
Итератор, генерирующий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным), который будет усечен, если оставшихся элементов для группировки меньше, чемsize.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
def sliding(size: Int): Iterator[View[A1]]
Группирует элементы в блоки фиксированного размера, пропуская "скользящее окно" по ним (в отличие от разбиения на части, как это делается в grouped.) Шаг "скользящего окна" установлен в единицу.
- size
количество элементов в группе
- returns
Итератор, генерирующий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным), который будет усечен, если оставшихся элементов для группировки меньше, чемsize.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
def span(p: (A1) => Boolean): (View[A1], View[A1])
Разбивает эту итерируемую коллекцию на пару префикс/суффикс в соответствии с предикатом.
Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции, лежащей в основе, не упорядочен.
- p
предикат проверки
- returns
пара, состоящая из самого длинного префикса этой итерируемой коллекции, элементы которой удовлетворяют
p, и остальной части этой итерируемой коллекции.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: После вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах.
def splitAt(n: Int): (View[A1], View[A1])
Разбивает эту итерируемую коллекцию на пару префикс/суффикс в заданной позиции.
Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).
Примечание: может возвращать разные результаты для разных запусков, если тип коллекции, лежащей в основе, не упорядочен.
- n
позиция, на которой нужно разбить.
- returns
пара итерируемых коллекций, состоящих из первых
nэлементов этой итерируемой коллекции и других элементов.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: После вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращённые итераторы. Использование старого итератора не определено, может измениться и может привести к изменениям в новых итераторах.
def stepper[S <: Stepper[_]](implicit shape: StepperShape[A1, S]): S
Возвращает Stepper для элементов этой коллекции.
Stepper позволяет создавать Java поток для работы с коллекцией, см. scala.jdk.StreamConverters. Для коллекций, содержащих примитивные значения, Stepper может использоваться как итератор, который не упаковывает элементы.
Неявный параметр StepperShape определяет тип возвращаемого Stepper в соответствии с типом элемента этой коллекции.
-
Для коллекций
Int, Short, Byte или Char, возвращается IntStepperДля коллекций Double или Float, возвращается DoubleStepperДля коллекций Long возвращается LongStepperДля любого другого типа элемента возвращается AnyStepperОбратите внимание, что этот метод переопределен в подклассах, и тип возвращаемого значения уточняется до S with EfficientSplit, например, IndexedSeqOps.stepper. Для Steppers, помеченных scala.collection.Stepper.EfficientSplit, конвертеры в scala.jdk.StreamConverters позволяют создавать параллельные потоки, тогда как обычные Steppers могут быть преобразованы только в последовательные потоки.
- Definition Classes
- IterableOnce
def stringPrefix: String
- Атрибуты
- protected[this]
- Определяющие классы
- View → Iterable
- Аннотации
- @deprecatedOverriding("Compatibility override", "2.13.0")
def sum[B >: A1](implicit num: math.Numeric[B]): B
Суммирует элементы этого набора.
- B
тип результата оператора
+.- num
неявный параметр, определяющий набор числовых операций, включающий оператор
+, который используется для вычисления суммы.- возвращает
сумма всех элементов этого набора относительно оператора
+вnum.
- Определяющие классы
- IterableOnceOps
final def synchronized[T0](arg0: => T0): T0
- Определяющие классы
- AnyRef
def tail: View[A1]
Остальная часть набора без первого элемента.
- Определяющие классы
- IterableOps
def tails: Iterator[View[A1]]
Итерируется по хвостам этого набора. Первое значение будет этим набором, а последнее — пустым набором, а промежуточные значения — результатом последовательных применений tail.
- возвращает
итератор по всем хвостам этого итерируемого набора
- Определяющие классы
- IterableOps
List(1,2,3).tails = Iterator(List(1,2,3), List(2,3), List(3), Nil)
def take(n: Int): View[A1]
Выбирает первые n элементов.
Примечание: результаты могут отличаться при разных запусках, если тип основного набора не упорядочен.
- n
количество элементов для взятия из этого итерируемого набора.
- возвращает
итерируемый набор, содержащий только первые
nэлементов этого итерируемого набора, или весь набор, если в нем меньшеnэлементов. Еслиnотрицательное, возвращает пустой итерируемый набор.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе тоже.
def takeRight(n: Int): View[A1]
Выбирает последние n элементов.
Примечание: результаты могут отличаться при разных запусках, если тип основного набора не упорядочен.
- n
количество элементов для взятия из этого итерируемого набора.
- возвращает
итерируемый набор, содержащий только последние
nэлементов этого итерируемого набора, или весь набор, если в нем меньшеnэлементов. Еслиnотрицательное, возвращает пустой итерируемый набор.
- Определяющие классы
- IterableOps
def takeWhile(p: (A1) => Boolean): View[A1]
Возвращает самый длинный префикс элементов, удовлетворяющих предикату.
Примечание: результаты могут отличаться при разных запусках, если тип основного набора не упорядочен.
- p
Предикат, используемый для проверки элементов.
- возвращает
самый длинный префикс этого итерируемого набора, элементы которого удовлетворяют предикату
p.
- Определяющие классы
- IterableOps → IterableOnceOps
def tapEach[U](f: (A1) => U): View[A1]
Применяет функцию с побочным эффектом к каждому элементу в этом наборе. Строгие наборы немедленно применяют f к своим элементам, в то время как ленивые наборы, такие как View и LazyList, будут применять f к каждому элементу только при его вычислении, и каждый раз, когда этот элемент вычисляется.
- U
тип возвращаемого значения f
- f
функция, которую нужно применить к каждому элементу в этом итерируемом наборе
- возвращает
логически тот же набор, что и этот
- Определяющие классы
- IterableOps → IterableOnceOps
def to[C1](factory: Factory[A1, C1]): C1
Используя фабрику коллекций factory, преобразуйте эту коллекцию в соответствующее представление для текущего типа элемента A. Примеры использования:
xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]
- Definition Classes
- IterableOnceOps
def toArray[B >: A1](implicit arg0: ClassTag[B]): Array[B]
Преобразовать коллекцию в массив.
- Definition Classes
- IterableOnceOps
final def toBuffer[B >: A1]: Buffer[B]
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
def toIndexedSeq: immutable.IndexedSeq[A1]
- Definition Classes
- IterableOnceOps
final def toIterable: LeftPartitionMapped.this.type
- returns
Эта коллекция как
Iterable[A]. Новый объект коллекции не будет создан, еслиthisуже являетсяIterable[A].
- Definition Classes
- Iterable → IterableOps
def toList: immutable.List[A1]
- Definition Classes
- IterableOnceOps
def toMap[K, V](implicit ev: <:<[A1, (K, V)]): immutable.Map[K, V]
- Definition Classes
- IterableOnceOps
def toSeq: immutable.Seq[A1]
- returns
Эта коллекция как
Seq[A]. Это эквивалентноto(Seq), но может быть быстрее.
- Definition Classes
- IterableOnceOps
def toSet[B >: A1]: immutable.Set[B]
- Definition Classes
- IterableOnceOps
def toString(): String
Преобразует это представление в строку.
- returns
строковое представление этой коллекции. По умолчанию эта строка состоит из
classNameэтого представления, за которым следуют все элементы, разделенные запятыми и заключенные в скобки.
def toVector: immutable.Vector[A1]
- Definition Classes
- IterableOnceOps
def transpose[B](implicit asIterable: (A1) => Iterable[B]): View[View[B]]
Транспонирует эту итерируемую коллекцию итерируемых коллекций в итерируемую коллекцию итерируемых коллекций.
Тип результирующей коллекции будет определяться статическим типом итерируемой коллекции. Например:
val xs = List(
Set(1, 2, 3),
Set(4, 5, 6)).transpose
// xs == List(
// List(1, 4),
// List(2, 5),
// List(3, 6))
val ys = Vector(
List(1, 2, 3),
List(4, 5, 6)).transpose
// ys == Vector(
// Vector(1, 4),
// Vector(2, 5),
// Vector(3, 6))
Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.
- B
тип элементов каждой итерируемой коллекции.
- asIterable
неявное преобразование, которое утверждает, что тип элемента этой итерируемой коллекции является
Iterable.- returns
двухмерная итерируемая коллекция итерируемых коллекций, в которой n-я строка — это n-й столбец этой итерируемой коллекции.
- Definition Classes
- IterableOps
- Exceptions thrown
IllegalArgumentException, если все коллекции в этой итерируемой коллекции не имеют одинакового размера.
def unzip[A1, A2](implicit asPair: (A1) => (A1, A2)): (View[A1], View[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: (A1) => (A1, A2, A3)): (View[A1], View[A2], View[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 view: View[A1]
Представление элементов этой коллекции.
- Definition Classes
- View → 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: (A1) => Boolean): WithFilter[A1, [_]View[_]]
Создает нестрогий фильтр этой итерируемой коллекции.
Примечание: отличие между 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]): View[(A1, B)]
Возвращает итерируемую коллекцию, образованную из этой итерируемой коллекции и другой итерируемой коллекции путем комбинирования соответствующих элементов в парах. Если одна из двух коллекций длиннее другой, оставшиеся элементы игнорируются.
- B
тип второй половины возвращенных пар
- that
Итерируемая коллекция, предоставляющая вторую половину каждой пары результата
- returns
новая итерируемая коллекция, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции и
that. Длина возвращаемой коллекции — минимальное из длин этой итерируемой коллекции иthat.
- Definition Classes
- IterableOps
def zipAll[A1 >: A1, B](that: Iterable[B], thisElem: A1, thatElem: B): View[(A1, B)]
Возвращает итерируемую коллекцию, образованную из этой и другой итерируемых коллекций, объединяя соответствующие элементы в пары. Если одна из двух коллекций короче другой, используется элемент-заполнитель для расширения более короткой коллекции до длины более длинной.
- that
итерируемая коллекция, предоставляющая вторую половину каждой пары результата
- thisElem
элемент, используемый для заполнения результата, если эта итерируемая коллекция короче, чем
that.- thatElem
элемент, используемый для заполнения результата, если
thatкороче, чем эта итерируемая коллекция.- returns
новая коллекция типа
That, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции иthat. Длина возвращаемой коллекции — максимальная из длин этой итерируемой коллекции иthat. Если эта итерируемая коллекция короче, чемthat, используются значенияthisElemдля заполнения результата. Еслиthatкороче, чем эта итерируемая коллекция, используются значенияthatElemдля заполнения результата.
- Definition Classes
- IterableOps
def zipWithIndex: View[(A1, Int)]
Объединяет эту итерируемую коллекцию с её индексами.
- returns
Новая итерируемая коллекция, содержащая пары, состоящие из всех элементов этой итерируемой коллекции, соединённых с их индексом. Индексы начинаются с
0.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только тот итератор, который был возвращён. Использование старого итератора является неопределённым, может измениться и может привести к изменениям в новом итераторе также.
List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))
© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.13.0/scala/collection/View$$LeftPartitionMapped.html