Класс scala.collection.LazyZip4

Тестирование двух объектов на неравенство.

Эквивалентно x.hashCode, за исключением упакованных числовых типов и null. Для чисел он возвращает хеш-значение, которое соответствует равенству значений: если два экземпляра типа значения сравниваются как true, тогда ## выведет одно и то же хеш-значение для каждого из них. Для null возвращает хеш-код, где null.hashCode выбрасывает NullPointerException.

Псевдоним для concat

Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).

Добавляет все элементы этого представления в строковый буфер. Записанный текст состоит из строковых представлений (с учётом метода 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

Добавляет все элементы этого представления в строковый буфер, используя разделительную строку. Записанный текст состоит из строковых представлений (с учётом метода 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

Добавляет все элементы этого представления в строковый буфер, используя начальную, конечную и разделительные строки. Записанный текст начинается со строки 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)

Преобразует текущий объект к типу T0.

Обратите внимание, что успех преобразования во время выполнения зависит от политики стирания типов в Scala. Поэтому выражение 1.asInstanceOf[String] может вызвать ClassCastException во время выполнения, в то время как выражение List(1).asInstanceOf[List[String]] не вызовет исключения. В последнем примере, потому что аргумент типа стирается во время компиляции, невозможно проверить, содержатся ли элементы списка в запрошенном типе.

Создаёт копию текущего объекта.

По умолчанию реализация метода clone зависит от платформы.

Создаёт новый вид, применяя частичную функцию ко всем элементам этого вида, для которых функция определена.

Находит первый элемент вида, для которого заданная частичная функция определена, и применяет частичную функцию к нему.

Примечание: может не завершиться для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.

Возвращает новый вид, содержащий элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элементов вида — наиболее специфический суперкласс, охватывающий типы элементов двух операндов.

Копирует элементы в массив, возвращая количество скопированных элементов.

Заполняет предоставленный массив xs, начиная с индекса start, не более чем len элементами этого представления.

Копирование прекратится, как только будут скопированы все элементы этого представления, или будет достигнут конец массива, или len элементов.

Копирует элементы в массив, возвращая количество скопированных элементов.

Заполняет предоставленный массив xs, начиная с индекса start, значениями этого представления.

Копирование прекратится, как только будут скопированы все элементы этого представления или будет достигнут конец массива.

Подсчитывает количество элементов в представлении, удовлетворяющих предикату.

Выбирает все элементы, кроме первых n.

Примечание: результаты могут отличаться при разных запусках, если тип базового набора не упорядочен.

Выбирает все элементы, кроме последних n.

Примечание: результаты могут отличаться при разных запусках, если тип базового набора не упорядочен.

Отбрасывает наибольший префикс элементов, удовлетворяющих предикату.

Примечание: результаты могут отличаться при разных запусках, если тип базового набора не упорядочен.

Пустой итератор того же типа, что и этот итератор

Проверяет, является ли аргумент (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).

Метод равенства для ссылочных типов. По умолчанию делегирует вызов к eq.

См. также equals в scala.Any.

Выбирает все элементы данного представления, которые не удовлетворяют предикату.

Вызывается сборщиком мусора для объекта-получателя, когда к объекту больше нет ссылок.

Подробности о том, когда и если вызывается метод finalize, а также взаимодействии finalize с нелокальными возвратами и исключениями, зависят от платформы.

Находит первый элемент представления, удовлетворяющий предикату, если таковой есть.

Примечание: может не завершаться для коллекций бесконечного размера.

Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.

Преобразует это представление итерируемых коллекций в представление, образованное элементами этих итерируемых коллекций.

Тип результирующей коллекции будет определяться типом представления. Например:

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)

Производит свертку элементов этого представления с использованием указанного ассоциативного бинарного оператора. Реализация по умолчанию в IterableOnce эквивалентна foldLeft, но может быть переопределена для более эффективных порядков обхода.

Порядок выполнения операций над элементами не определён и может быть не детерминированным.

Примечание: не завершится для коллекций бесконечного размера.

Применяет бинарный оператор к начальному значению и всем элементам этого представления слева направо.

Примечание: не завершится для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.

Применяет бинарный оператор ко всем элементам этого представления и начальному значению, двигаясь справа налево.

Примечание: не завершится для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.

Возвращает строку, отформатированную в соответствии с данной строкой формата. Строки формата аналогичны строкам формата String.format (@см. java.lang.String.format).

Возвращает представление класса объекта во время выполнения.

Разделяет этот вид на карту видов в соответствии с некоторой функцией-дискриминатором.

Примечание: даже при применении к виду или ленивой коллекции элементы всегда будут принудительно вычисляться.

Разделяет этот вид на карту видов в соответствии с функцией-дискриминатором 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)

Примечание: даже при применении к виду или ленивой коллекции элементы всегда будут принудительно вычисляться.

Разделяет этот вид на карту в соответствии с функцией-дискриминатором key. Все значения, имеющие одинаковый дискриминатор, затем преобразуются с помощью функции value и затем сводятся к одному значению с помощью функции reduce.

Это эквивалентно groupBy(key).mapValues(_.map(f).reduce(reduce)), но более эффективно.

def occurrences[A](as: Seq[A]): Map[A, Int] =
  as.groupMapReduce(identity)(_ => 1)(_ + _)

Примечание: даже при применении к виду или ленивой коллекции элементы всегда будут принудительно вычисляться.

Разделяет элементы на части фиксированного размера.

Метод hashCode для ссылочных типов. См. hashCode в scala.Any.

Выбирает первый элемент этого представления.

Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.

Возвращает первый элемент, если он существует.

Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.

Начальная часть коллекции без последнего элемента.

Примечание: даже когда применяется к представлению или ленивой коллекции, элементы всегда будут вычислены.

Итерирует по начальным значениям этого представления. Первое значение будет этим представлением, а последнее — пустым представлением, а промежуточные значения — результатом последовательного применения init.

Примечание: даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно получены.

Проверяет, является ли представление пустым.

Примечание: Реализации в подклассах, которые не являются многократно проходимыми, должны позаботиться о том, чтобы не потреблять никаких элементов при вызове isEmpty.

Проверка динамического типа объекта-получателя на T0.

Обратите внимание, что результат проверки выполняется с учетом семантики стирания Scala. Поэтому выражение 1.isInstanceOf[String] вернет false, а выражение List(1).isInstanceOf[List[String]] вернет true. В последнем примере, так как аргумент типа стирается на этапе компиляции, невозможно проверить, соответствуют ли содержимое списка указанному типу.

Проверка, можно ли многократно пройтись по этому представлению. Всегда истинно для Iterables и ложно для Iterators, если не переопределено.

Компаньон-объект этого представления, предоставляющий различные методы фабрики.

Итератор может быть использован только один раз

Выбирает последний элемент.

Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.

Возвращает последний элемент, если он есть.

Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.

Аналогично 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)

Находит наибольший элемент.

Находит первый элемент, который дает наибольшее значение, измеренное функцией f.

Находит первый элемент, который дает наибольшее значение, измеренное функцией f.

Находит наибольший элемент.

Находит наименьший элемент.

Находит первый элемент, который дает наименьшее значение, измеренное функцией f.

Находит первый элемент, который дает наименьшее значение, измеренное функцией f.

Находит наименьший элемент.

Отображает все элементы этого представления в строке.

Делегирует addString, который может быть переопределен.

Отображает все элементы этого представления в строке с использованием разделителя.

Делегирует addString, который может быть переопределен.

Отображает все элементы этого представления в строке с использованием начальной, конечной и разделительных строк.

Делегирует addString, который может быть переопределен.

Эквивалентно !(this eq that).

Проверяет, не пуст ли просмотр.

Разбуживает одиночную нить, ожидающую монитора объекта получателя.

Разбуживает все нити, ожидающие монитора объекта получателя.

Пара, во-первых, всех элементов, удовлетворяющих предикату p, и, во-вторых, всех элементов, которые не удовлетворяют. Интересно, потому что это разделяет коллекцию на две части.

Представленная здесь реализация по умолчанию должна дважды пройти по коллекции. Строгие коллекции имеют переопределённую версию partition в StrictOptimizedIterableOps, которая требует только одного прохода.

Применяет функцию f к каждому элементу просмотра и возвращает пару просмотров: первый содержит значения, возвращённые f, заключённые в scala.util.Left, а второй — значения, заключённые в scala.util.Right.

Пример:

val xs = `View`(1, "one", 2, "two", 3, "three") partitionMap {
 case i: Int => Left(i)
 case s: String => Right(s)
}
// xs == (`View`(1, 2, 3),
//        `View`(one, two, three))

Умножает элементы этого набора.

Сводит элементы этого представления с использованием указанного ассоциативного бинарного оператора.

Порядок выполнения операций над элементами не определен и может быть не детерминированным.

Применяет бинарный оператор ко всем элементам этого представления слева направо.

Примечание: не завершит работу для коллекций бесконечного размера.

Примечание: может вернуть разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.

При желании применяет бинарный оператор ко всем элементам этого представления слева направо.

Примечание: не завершит работу для коллекций бесконечного размера.

Примечание: может вернуть разные результаты для разных запусков, если тип базовой коллекции не упорядочен или оператор не ассоциативен и коммутативен.

Сводит элементы этого представления, если таковые имеются, используя заданный ассоциативный бинарный оператор.

Порядок выполнения операций над элементами не определён и может быть не детерминированным.

Применяет бинарный оператор ко всем элементам этого представления, идя справа налево.

Примечание: не будет завершаться для коллекций бесконечного размера.

Примечание: может возвращать различные результаты для различных запусков, если только тип базовой коллекции упорядочен или оператор ассоциативен и коммутативен.

Возвращает значение опционального типа, возможно применяя бинарный оператор ко всем элементам этого представления, идя справа налево.

Примечание: не будет завершаться для коллекций бесконечного размера.

Примечание: может возвращать различные результаты для различных запусков, если только тип базовой коллекции упорядочен или оператор ассоциативен и коммутативен.

Вычисляет префиксный скан элементов коллекции.

Примечание: нейтральный элемент z может быть применен более одного раза.

Создаёт представление, содержащее кумулятивные результаты применения оператора слева направо, включая начальное значение.

Примечание: не завершит работу для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.

Создаёт коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Голова коллекции — последний кумулятивный результат.

Примечание: не завершит работу для коллекций бесконечного размера.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.

Примечание: Даже при применении к представлению или ленивой коллекции, элементы всегда будут принудительно вычислены.

Пример:

List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)

Сравнивает размер этого представления с размером другого Iterable.

Сравнивает размер этого представления со значением проверки.

Возвращает значение класса, содержащего операции для сравнения размера этого представления со значением проверки.

Эти операции реализованы в терминах 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

Выбирает интервал элементов. Возвращаемое представление состоит из всех элементов x, которые удовлетворяют следующему инварианту:

from <= indexOf(x) < until

Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не является упорядоченным.

Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» по ним (в отличие от разбиения на части, как это делается в grouped).

Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» по ним (в отличие от разбиения на части, как это делается в grouped.) Шаг «скользящего окна» установлен в единицу.

Разделяет это представление на пару префикс/суффикс в соответствии с предикатом.

Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.

Примечание: может возвращать разные результаты для разных запусков, если тип базового коллектива не упорядочен.

Разделяет этот вид на пару префикс/суффикс в заданной позиции.

Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).

Примечание: может возвращать разные результаты для разных запусков, если только тип базового набора не является упорядоченным.

Возвращает 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 можно преобразовать только в последовательные потоки.

Суммирует элементы этого набора.

Остальная часть коллекции без ее первого элемента.

Перебирает хвосты этого представления. Первое значение будет этим представлением, а последнее — пустым представлением, а промежуточные значения будут результатом последовательных применений tail.

Выбирает первые n элементов.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.

Выбирает последние n элементов.

Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.

Берет самый длинный префикс элементов, удовлетворяющих предикату.

Примечание: может возвращать разные результаты для разных запусков, если только тип базовой коллекции не упорядочен.

Применяет функцию с побочным эффектом к каждому элементу в этой коллекции. Строгие коллекции будут применять f к своим элементам немедленно, в то время как ленивые коллекции, такие как представления и LazyLists, будут применять f к каждому элементу только при и когда этот элемент будет вычислен, и каждый раз, когда этот элемент вычисляется.

Учитывая фабрику коллекций factory, преобразуйте эту коллекцию в соответствующее представление для текущего типа элемента A. Примеры использования:

xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]

Создает строковое представление этого объекта. По умолчанию представление зависит от платформы. На платформе Java это конкатенация имени класса, "@" и хэш-кода объекта в шестнадцатеричном формате.

Транспонирует это представление итерируемых коллекций в представление представлений.

Тип результирующей коллекции будет определяться статическим типом представления. Например:

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))

Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.

Преобразует это представление пар в два набора первой и второй половины каждой пары.

val xs = `View`(
           (1, "one"),
           (2, "two"),
           (3, "three")).unzip
// xs == (`View`(1, 2, 3),
//        `View`(one, two, three))

Преобразует это представление троек в три набора первого, второго и третьего элемента каждой тройки.

val xs = `View`(
           (1, "one", '1'),
           (2, "two", '2'),
           (3, "three", '3')).unzip3
// xs == (`View`(1, 2, 3),
//        `View`(one, two, three),
//        `View`(1, 2, 3))

Представление элементов этого набора.

Создаёт нестрогий фильтр этого представления.

Примечание: различие между c filter p и c withFilter p заключается в том, что первый создаёт новую коллекцию, а второй только ограничивает область применения последующих map, flatMap, foreach и withFilter операций.

Примечание: результаты могут отличаться при разных запусках, если тип базовой коллекции не упорядочен.

Возвращает представление, сформированное из этого представления и другой итерируемой коллекции, объединяя соответствующие элементы парами. Если одна из двух коллекций длиннее другой, её оставшиеся элементы игнорируются.

Возвращает представление, сформированное из этого представления и другой итерируемой коллекции, объединяя соответствующие элементы парами. Если одна из двух коллекций короче другой, для дополнения более короткой коллекции используются заполнительные элементы до длины более длинной.

Упаковывает это представление с его индексами.

Проверяет, выполняется ли предикат хотя бы для одного элемента этого представления.

Примечание: может не завершиться для коллекций бесконечного размера.

Выбирает все элементы этого представления, которые удовлетворяют предикату.

Создает новое представление, применяя функцию ко всем элементам этого представления и используя элементы полученных коллекций.

Например:

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)

Проверяет, выполняется ли предикат для всех элементов этого представления.

Примечание: может не завершаться для коллекций бесконечного размера.

Применяет f к каждому элементу для его побочных эффектов. Примечание: параметр [U] необходим для улучшения работы механизма вывода типов scalac.

Создает новое представление, применяя функцию ко всем элементам этого представления.

Преобразует это представление в строку.