Класс scala.collection.LazyZip3

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

Эквивалентно 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, значениями этого представления.

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

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

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

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

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

Возвращает строку, отформатированную в соответствии с заданной строкой format. Формат строк соответствует 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. В последнем примере, поскольку тип аргумента стирается во время компиляции, проверить, являются ли содержимое списка указанного типа, невозможно.

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

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

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

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

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

Необязательно выбирает последний элемент.

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

Zips коллекцию iterable с существующей LazyZip3. Элементы в каждой коллекции не потребляются до тех пор, пока не будет вызвано строгое действие над возвращаемым LazyZip4 декоратором.

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

Находит первый элемент, который дает наибольшее значение, измеренное функцией 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)

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

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

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

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

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

Эти операции реализованы с помощью 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. Для Stepper, помеченных scala.collection.Stepper.EfficientSplit, преобразователи в scala.jdk.StreamConverters позволяют создавать параллельные потоки, в то время как обычные Stepper могут быть преобразованы только в последовательные потоки.

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

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

Итерируется по хвостам этого представления. Первое значение будет этим представлением, а последнее — пустым представлением, а промежуточные значения — результатами последовательных применений 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.

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

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

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