Трейт scala.collection.GenSeqLike

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

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

Примечание: /: — это альтернативная запись для foldLeft; z /: xs эквивалентно xs foldLeft z.

Примеры:

Обратите внимание, что функция сворачивания, используемая для вычисления b, эквивалентна функции, используемой для вычисления c.

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = (5 /: a)(_+_)
b: Int = 15

scala> val c = (5 /: a)((x,y) => x + y)
c: Int = 15

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

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

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

Примечание: :\ — это альтернативная запись для foldRight; xs :\ z эквивалентно xs foldRight z.

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

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

Примеры:

Обратите внимание, что функция сворачивания, используемая для вычисления b, эквивалентна функции, используемой для вычисления c.

scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)

scala> val b = (a :\ 5)(_+_)
b: Int = 15

scala> val c = (a :\ 5)((x,y) => x + y)
c: Int = 15

Агрегирует результаты применения оператора к последующим элементам.

Это более общий вид fold и reduce. Это похоже на foldLeft, в том, что результат не требует быть супертипом типа элемента. Кроме того, он позволяет обрабатывать параллельные коллекции частями, а затем объединять промежуточные результаты.

aggregate разбивает коллекцию или итератор на разделы и обрабатывает каждый раздел последовательно, применяя seqop, начиная с z (как foldLeft). Эти промежуточные результаты затем объединяются с помощью combop (как fold). Реализация этой операции может работать с произвольным числом разделов коллекции (даже 1), поэтому combop может вызываться произвольное число раз (даже 0).

Например, рассмотрим суммирование целочисленных значений списка символов. Начальное значение суммы — 0. Сначала seqop преобразует каждый символ ввода в целое число и добавляет его к сумме (раздела). Затем combop просто суммирует промежуточные результаты разделов:

List('a', 'b', 'c').aggregate(0)({ (sum, ch) => sum + ch.toInt }, { (p1, p2) => p1 + p2 })

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

Пример:

scala> val x = List(1, 2, 3, 4, 5)
x: List[Int] = List(1, 2, 3, 4, 5)

scala> x(3)
res1: Int = 4

Метод, который следует вызывать из каждого хорошо спроектированного метода equals, который может быть переопределен в подклассе. См. Programming in Scala, Глава 28 для обсуждения и проектирования.

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

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

Создаёт новую общую последовательность из этой общей последовательности без дублирующих элементов.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Проверяет, известно ли, что эта коллекция или итератор имеют конечный размер. Все строгие коллекции, как известно, имеют конечный размер. Для нестрогой коллекции, такой как Stream, предикат возвращает true если все элементы были вычислены. Он возвращает false если поток еще не вычислен до конца. Непустые итераторы обычно возвращают false даже если они были созданы из коллекции с известным конечным размером.

Примечание: многие методы коллекций не будут работать с коллекциями бесконечных размеров. Типичный режим отказа — бесконечный цикл. Эти методы всегда пытаются пройтись, не проверяя сначала, что hasDefiniteSize возвращает true. Однако проверка hasDefiniteSize может гарантировать, что размер хорошо определен и бесконечное выполнение не является проблемой.

Выбирает первый элемент этой общей коллекции.

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

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

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

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

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

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

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

Проверяет, пуста ли коллекция или итератор.

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

Проверяет, можно ли эту общую коллекцию многократно проходить.

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

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

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

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

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

Длина общего последовательности.

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

Примечание: xs.length и xs.size дают одинаковый результат.

Отображает все элементы этой коллекции или итератора в строке.

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

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

Проверяет, не пустая ли коллекция или итератор.

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

Разделяет эту общую коллекцию на две общие коллекции в соответствии с предикатом.

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает новую общую последовательность с элементами в обратном порядке.

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

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

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

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

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

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

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

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

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

Пример:

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

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

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

Размер этой обобщенной коллекции.

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

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

from <= indexOf(x) < until

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

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

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

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

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

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

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

Примечание: Если и объект-приёмник this и аргумент that являются бесконечными последовательностями, этот метод может не завершиться.

Определяет префикс представления этого объекта.

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

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

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

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

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

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

Использует содержимое этого набора или итератора для создания нового изменяемого буфера.

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

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

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

Преобразует этот набор или итератор в итерируемый набор. Обратите внимание, что выбор целевого Iterable ленив в этой реализации по умолчанию, так как этот TraversableOnce может быть ленивым и невычисленным (т. е. может быть итератором, который можно пройти только один раз).

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

Возвращает итератор по элементам в этом наборе или итераторе. Вернёт тот же итератор, если этот экземпляр уже является итератором.

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

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

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

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

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

Преобразует эту коллекцию или итератор в множество.

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

Преобразует эту коллекцию или итератор в поток.

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

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

Преобразует эту коллекцию или итератор в вектор.

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

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

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

Копия последовательности с добавленным элементом в начало.

Обратите внимание, что операторы с суффиксом :- являются правоассоциативными (см. пример). Мемоника для +: против :+ такова: двоеточие ставится со стороны коллекции.

Также исходная последовательность не изменяется, поэтому вам нужно будет сохранить результат.

Пример:

scala> val x = List(1)
x: List[Int] = List(1)

scala> val y = 2 +: x
y: List[Int] = List(2, 1)

scala> println(x)
List(1)

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

Мемоника для +: против :+ такова: двоеточие ставится со стороны коллекции.

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

Пример:

scala> val a = List(1)
a: List[Int] = List(1)

scala> val b = a :+ 2
b: List[Int] = List(1, 2)

scala> println(a)
List(1)

Проверка двух объектов на равенство. Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).

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

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

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

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

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

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

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

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

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

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

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

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

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

Например:

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 => 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 ко всем элементам этой обобщенной последовательности.

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

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

Хешкоды для GenSeq производят значение из хешкодов всех элементов обобщенной последовательности.

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

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

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

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

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

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

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

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

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

Реализации методов apply и isDefinedAt преобразуют Seq[A] в PartialFunction[Int, A].

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

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает параллельную реализацию этого набора.

Для большинства типов наборов этот метод создаёт новый параллельный набор, копируя все элементы. Для этих наборов par занимает линейное время. Изменяемые наборы в этой категории не производят изменяемый параллельный набор, который имеет тот же базовый набор данных, поэтому изменения в одном наборе не будут отражаться в другом.

Специфические наборы (например, ParArray или mutable.ParHashMap) переопределяют это поведение по умолчанию, создавая параллельный набор, который использует тот же базовый набор данных. Для этих наборов par занимает постоянное или сублинейное время.

Все параллельные наборы возвращают ссылку на себя.

Создаёт новый общий набор, где фрагмент элементов в этом общем наборе заменяется другим набором.

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

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

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

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

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

Примечание: xs.reverseMap(f) то же самое, что и xs.reverse.map(f), но может быть более эффективным.

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

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

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

Размер этой коллекции или итератора, если его можно вычислить недорого

Проверяет, начинается ли эта общая последовательность с данной последовательности.

Суммирует элементы этой коллекции.

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

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

Преобразует эту общую последовательность в массив.

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

Преобразует эту общую последовательность в карту. Этот метод недоступен, если элементы не являются членами Tuple2, каждая ((T, U)) становится парой ключ-значение в карте. Повторные ключи будут перезаписаны последующими ключами: если это неупорядоченная коллекция, какой ключ находится в результирующей карте, не определено.

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

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

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

Создаёт новую последовательность, содержащую все элементы этой общей последовательности и все элементы заданной последовательности. xs union ys эквивалентно xs ++ ys.

Другой способ выразить это - xs union ys вычисляет сохраняющую порядок множественную сумму объединения xs и ys. union является, следовательно, аналогом diff и intersect, которые также работают с множествами.

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

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

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

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

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

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

Объединяет эту общую последовательность с её индексами.

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