Трейт scala.collection.GenSet

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

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

Примечание: /: — это альтернативная синтаксическая конструкция для 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 })

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Реализация по умолчанию 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).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вычисляет объединение множества и другого множества.

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

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

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

Примечание: То же самое, что и intersect.

Разность этого множества и другого множества.

Примечание: То же самое, что и diff.

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

Объединяет две функции Function1 в новую Function1, применяя эту функцию первой.

Проверяет, содержится ли некоторый элемент в этом множестве.

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

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

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

Создаёт копию объекта получателя.

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

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

Объект-компаньон, являющийся фабрикой для создания экземпляров класса Traversable. (или его Iterable суперкласса, где класс Traversable не является Seq.)

Компонует две функции Function1 в новую функцию Function1, применяя эту функцию последней.

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

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

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

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

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

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

Проверяет, является ли аргумент (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 или o1 eq o2 важно обеспечить согласованность их поведения с равенством по ссылке. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и иметь одинаковый хэш-код (o1.hashCode == o2.hashCode).

Сравнивает это множество с другим объектом на равенство.

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

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

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

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

Например:

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)

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

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

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)

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

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

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

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

Вычисляет пересечение между этим множеством и другим множеством.

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

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

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

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

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

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

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

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

Построитель, создающий экземпляры типа Traversable[A]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Преобразует этот набор в массив.

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

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

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

Создает строковое представление этого объекта. По умолчанию представление зависит от платформы. На платформе 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 = Traversable(
           (1, "one"),
           (2, "two"),
           (3, "three")).unzip
// xs == (Traversable(1, 2, 3),
//        Traversable(one, two, three))

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

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

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

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

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

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

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

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

Вычисляет объединение этого множества и другого множества.

Примечание: То же, что и union.